The logic steps live under Control flow in the step picker. They decide which way a conversation goes, repeat work, and keep values for later steps.
| Step | Picker hint | Outputs |
|---|---|---|
| Router | Send the chat down the first branch that matches | One per branch, plus Otherwise |
| Loop over items | Repeat the next steps for each item in a list | Each item and Done |
| Variables | Set or update flow variables | One |
Router
A Router checks its branches from the top down and takes the first one whose conditions match. Anything that matches no branch leaves through Otherwise.
Add a Router and select Add branch.
Give the branch a Branch name. It names the branch on the card and in publish messages.
Add a condition: a variable, an operator and a value. Select Add condition to add more to the same set. Every condition in a set must match. Select Add alternative set to add another set. The branch matches if any one set matches.
Repeat for each branch, and reorder them if needed.
Connect every branch, and connect Otherwise. A chat that matches nothing and has nowhere to go stops there.
Operators:
| Text | Numbers | Presence |
|---|---|---|
| is, is not, contains, does not contain, starts with, ends with | is greater than, is greater than or equal to, is less than, is less than or equal to | is empty, is not empty |
Text is matched exactly, including capitals. Number tests expect both sides to be numbers; otherwise the branch never matches, and the inspector warns you.
If the Router follows an AI Agent that has Exits, you can pick an exit by name instead of typing a variable.
Loop over items
A Loop repeats the steps under Each item once per entry in a list. When the list runs out, the flow carries on from Done.
- List is an expression that resolves to a list, such as a list a previous step saved. Without a list the step blocks publishing.
- Item variable names the current entry. Steps inside the loop read the entry and its position (starting at 0) through it. Without a name the step blocks publishing.
- Maximum iterations is a safety ceiling so a long list cannot run forever. Blank or below 1 restores the default of 100.
Variables
What it sets is a list of assignments, run from top to bottom, so a later one can read an earlier one. For each, enter:
- Variable name — letters, digits and underscores, starting with a letter or underscore. Names starting with two underscores are reserved for the engine, and so is the name
trigger. - Type — Text, Number, List or JSON. Switching converts what is already there rather than clearing it.
- Value — variables are filled in first. For a number, the result is then read as a number. In JSON, variables are not filled in.
Later steps read the value back as {{name}}.
Why use them
- Route VIP customers differently with a Router on a saved plan name.
- Fill in a default with Variables so later steps always have a value.
- Send a message to every item in a list with a Loop.
Keep branches wired
The canvas shows a reserved lane for every branch you declare. An unwired branch is a conversation that ends quietly, so connect or remove each one before you publish.