The Router tool in Captivation Hub Agent Studio gives you control over how a conversation moves between nodes in your AI agent. As the name suggests, a router decides which node comes next based on logic, intent, or simply an always-on transition. This guide walks through the AI Router, the Conditional Router, and the No Condition option so you can build smarter, more flexible conversation paths.
What the Router Tool Does in Agent Studio
The Router controls how an agent moves from one node to the next based on what's happening in the conversation. It lets you create flexible paths inside your agent graph, so the next step is chosen based on what the user says, what data has been collected, or whether the flow should always continue forward.
The Router supports three approaches:
- AI Router — uses natural-language intent to decide which path to take.
- Conditional Router — uses saved variables and logic rules to determine the next node.
- No Condition — always moves to the next connected node without evaluating intent or logic.
You can use the Router inside agent flows or inside Sequential Nodes, which lets a linear process branch when it needs to before continuing.
Key Benefits
- Smarter branching — route users based on what they actually mean, not just exact keywords.
- More control — use variables and logic rules to send contacts to the right next step.
- Cleaner graph design — connect nodes with intention instead of forcing everything down one path.
- Flexible flow building — combine AI routing, conditional logic, and always-on routing inside the same agent.
- Better experience for the contact — fewer unnecessary steps and faster paths to the right outcome.
- Room for advanced automations — add dynamic decision-making inside Agent Studio and Sequential Nodes.
Using the AI Router
The AI Router shines when the next step depends on what the user means in natural language. Instead of checking for an exact value, the AI reviews the user's message and matches it to the closest intent you've defined.
Use the AI Router when:
- users may phrase the same idea in different ways
- you want to branch based on interest, sentiment, or conversational intent
- the path should be chosen from natural language rather than a stored variable
Example intents:
- User wants to invest in silver
- User does not want to invest in silver
The Router evaluates the user's most recent message and sends the conversation to the matching connected node.
Using the Conditional Router
The Conditional Router is the right pick when routing depends on a known value that's already been captured in the conversation. It evaluates variables and logic rules to decide where the flow should go.
Use the Conditional Router when:
- you've already collected a value such as a status, a yes/no, or a numeric input
- the decision can be expressed as variable + operator + value
- you want predictable, rule-based paths instead of natural-language interpretation
Using No Condition
The No Condition option is useful when you simply want the flow to always continue to the next connected node — no logic, no intent check.
It's a good fit when:
- the next step doesn't require a decision
- you want a guaranteed transition between nodes
- a step has already collected what it needs and should move on automatically
When enabled, this route acts as an always path to the next connected node.
Using the Router Inside Sequential Nodes
The Router can also live inside Sequential Nodes, which lets a mostly linear flow branch when needed. This is helpful when a sequence should run in order but still needs an AI-based or logic-based decision before moving forward.
This pattern works well when:
- a sequence needs a decision point before the next step
- a user's answer should redirect them to a different outcome
- you want to combine structured flows with dynamic routing
Step 1 — Open Agent Studio and Pick Your Agent
From the left navigation menu, click AI Agents and then open Agent Studio. Choose the agent where you want to add routing.
Step 2 — Drop In a Router Where the Conversation Should Branch
Add a Router node at the point in your graph where the conversation needs to make a decision.
Step 3 — Pick a Router Type
In the Router configuration panel, choose between AI Router and Conditional Router under the "Router Type" section. This selection determines whether the routing decision will be based on AI intent detection or rule-based logic.
Step 4 — Configure the Router
For the AI Router, add the intents that should determine each path. Each intent represents a branch the conversation can follow when the AI detects matching intent from the user's message.
For the Conditional Router, add one or more conditions using the right variable, operator, and value. Switch to Conditional Router if you want routing decisions to be based on structured data rather than natural-language interpretation. This mode evaluates variables and predefined logic to decide the next step.
Enter a clear Label for each branch so it's easy to identify in the conversation graph. The label appears on the node connection and helps keep complex flows organized. Then select the Condition Type to define how the rule should evaluate.
Step 5 — Connect Each Branch to the Right Next Node
Once your routes are configured, link each branch to the node it should send the conversation to. Make sure every path leads somewhere — including a fallback for messages that don't match.
Example Flow
An agent asks the contact whether they'd like to schedule a demo. A Conditional Router checks the saved value:
- If the value equals Yes, the flow moves to the proceed path.
- If the value equals No, the flow moves to a different outcome.
Best Practices
Strong routing design makes your agent easier to maintain and helps reduce errors during testing. Clear route labels, intentional logic, and realistic test cases make it much easier to understand why a user reached a specific path.
- Use the AI Router when user responses may vary in wording but share the same intent.
- Use the Conditional Router when the decision depends on a saved value.
- Use No Condition when the flow should always continue.
- Keep route labels clear so each branch is easy to understand at a glance.
- Test every route path before publishing your agent.
- Link to related setup articles when a route depends on variables or other tools.
Frequently Asked Questions
What's the difference between AI Router and Conditional Router?
The AI Router evaluates natural-language intent. The Conditional Router checks a saved value using logic such as variable, operator, and value.
When should I use No Condition?
Whenever the flow should always move to the next connected node without evaluating intent or logic.
Can I use Router inside Sequential Nodes?
Yes. The Router works inside Sequential Nodes, so a linear flow can branch before continuing.
Do I need a variable for AI Router?
No. AI Router works off the user's natural-language response and the intents you define.
Do I need a variable for Conditional Router?
Yes. The Conditional Router works best when the value has already been captured and stored.
What happens if no intent or condition matches?
Make sure each route is connected to the right next node, and include a fallback path so the conversation can continue smoothly even when nothing matches.
What should I do if a route isn't going to the expected node?
Review the route configuration, double-check the node connections, and run the conversation again to verify the intent or condition is being evaluated correctly.
Comments
0 comments
Please sign in to leave a comment.