Multi-Intent Routing Example

The following shows how intent-kit can handle multiple intents in a single user utterance using a splitter node.

from intent_kit import IntentGraphBuilder, handler, rule_splitter_node

# Handlers for individual intents

def greet(name: str) -> str:
    return f"Hello {name}!"

def weather(city: str) -> str:
    return f"The weather in {city} is sunny."

hello = handler(
    name="greet",
    description="Greet the user",
    handler_func=greet,
    param_schema={"name": str},
)

weather_h = handler(
    name="weather",
    description="Get weather information",
    handler_func=weather,
    param_schema={"city": str},
)

# Splitter routes parts of the sentence to different handlers
splitter = rule_splitter_node(
    name="multi_split",
    children=[hello, weather_h],
)

graph = IntentGraphBuilder().root(splitter).build()

result = graph.route("Hello Alice and what's the weather in Paris?")
print(result.output)

The rule_splitter_node looks for keywords ("hello", "weather", etc.) and breaks the user input into sub-phrases routed to the appropriate handlers. The final result.output aggregates the outputs from each intent, e.g.:

{
  "greet": "Hello Alice!",
  "weather": "The weather in Paris is sunny."
}

For a more robust version that uses LLM-based splitting, see examples/multi_intent_demo.py.