AI Collector
The AI Collector is a multi-turn agent that gathers a set of data points — called slots — through one natural conversation. Instead of chaining many question nodes, you describe who the agent is, what it must accomplish and which fields it needs; the AI asks, re-steers off-topic answers and keeps going until every required slot is filled. Voice notes are transcribed, images and documents are ingested, and shared locations are enriched automatically before each turn.
Everything collected is stored in a single object variable, so downstream nodes can read each field with {{variable.field_name}}.
Configuration
| Option | Description |
|---|---|
identity | The agent's persona. Supports {{variables}} |
rules | Behavior rules the agent must follow. Supports {{variables}} |
goal | The internal objective of the conversation. Supports {{variables}} |
preferredFlow | Preferred conversation style, for example "ask one field at a time". Supports {{variables}} |
slots | The data points to collect. Each slot has a field name, a type (string, number, date, boolean, object, array or attachment), a description and a required flag |
dependsOnField / dependsOnValue | Per-slot condition: the slot only activates when another slot holds the given value |
maxTurns | Anti-loop limit before giving up (default 6) |
includeHistory | Include recent conversation history in the agent's context |
historyMaxMessages | How many recent messages to include when history is on (default 10) |
giveupMessage | Optional message sent to the customer when turns run out |
responseVariable | Object variable where all collected slots are stored |
Output Handles
| Handle | When |
|---|---|
| Success | Every required slot (including slots activated by dependsOn) has been collected |
| Give up | maxTurns was reached without completing the required slots |
Things to Know
The backend decides when the node is done. Even if the AI believes it finished, the node stays open while required slots are pending — including slots that a dependsOn condition just activated mid-turn.
dependsOnValue is typed by the field it references. The text true matches a boolean slot holding true, and 30 matches a number slot holding 30, so conditional slots work regardless of how the value was captured.
Multimodal input is handled before the AI runs. Audio is transcribed, images and documents fill attachment slots, and shared locations are geocoded deterministically — the model only reasons over the result.
Connect both outputs. If the give-up handle has no target when turns run out, the flow terminates. Use the give-up branch to hand off to a human or a simpler question path.