AI - Router
Type identifier:
ai:routerCategory: AI Operations
Description
The AI - Router node evaluates input variables and configured route options, then chooses a single option to continue the run. Each option can optionally define a structured output schema for AI-generated data when that option is selected.
Input Handles
Handle | Type | Description |
|---|---|---|
|
| Starts routing evaluation. |
|
| Appears when the model is configured as dynamic. |
| schema-defined | One input handle is created for each configured variable. |
Output Handles
Handle | Type | Description |
|---|---|---|
|
| Triggered when routing fails. |
|
| The model's reasoning for the route. Appears when Show Model Reasoning is enabled. |
|
| Zero-based selected option index. Appears when Show Selected Option Details is enabled. |
|
| Selected option label. Appears when Show Selected Option Details is enabled. |
|
| Trigger for each configured option. |
| schema-defined | Output for selected option when that option has an output schema. |
Configuration Options
Option | Type | Default | Description |
|---|---|---|---|
Model |
|
| LLM model used for routing. When dynamic, the |
Instructions |
| - | Router guidance passed to the model. |
Variables | array of schema |
| Input variable definitions exposed as target handles. |
Options | array of objects |
| Candidate routes. Each has a |
Show Model Reasoning |
|
| Adds the |
Show Selected Option Details |
|
| Adds the |
Default Template
New AI - Router nodes start with a query string variable and two options:
General queryContact formwith an object output namedcontact
The default contact output object includes these required string fields:
nameemailphonemessage
Behaviour
- Resolves all configured variable inputs.
- Sends instructions, options, and variable values to an LLM.
- Chooses one option.
- If Show Selected Option Details is enabled, emits
selectedOptionIndexandselectedOptionLabel. If Show Model Reasoning is enabled, emitsreasoning. - Triggers the selected option's control handle.
- If the selected option has an output schema and output is returned, writes it to
option-<id>:output. - On failure, triggers the
errorhandle.