FlowsCards

AI Agent Card

Multi-turn AI conversation that can hand off to a branch of your flow

The AI Agent Card holds a back-and-forth conversation with the contact. The agent answers each message until the conversation ends or it routes the contact to one of the card's buttons. It needs a Standard plan or higher.

Configuration

Write the agent's instructions in the card itself. The text is required, and it can use variables.

SettingDescription
AI AssistantThe assistant that answers. Required: there is no default to fall back on. See Choosing an Assistant.
Max TurnsThe most exchanges before the agent stops. A whole number from 1 to 200, 50 if you leave it empty.
Context settingsWhat the agent can see. Collapsed by default. See below.
ButtonsThe routes the agent can hand off to. At least one is required, and only callback buttons are available.

Context Settings

SettingDescription
Inherit assistant contextUse the assistant's system prompt, knowledge base and brand voice. Turn it off for narrow tasks where the assistant's personality would get in the way.
Include flow contextSend the variables earlier cards collected, such as the contact's answers so far.
Use past conversationInclude the messages exchanged in earlier cards of this flow.
Lookback hoursOnly include messages from the last N hours, from 1 to 720. Leave it empty for no limit.

All four sources are on by default.

Choosing an Assistant

Pick the assistant in the card. Saving a card with none is refused: Choose an AI assistant for this card. The picker warns you in three cases:

MessageWhat to do
Pick an assistant: an AI card needs one.Choose one from the list.
This assistant is no longer available. Pick another one.The assistant was deleted. Choose another.
This assistant is switched off, so the card will follow its error path.Switch the assistant on, or choose another.

Answers From Your Knowledge

With Inherit assistant context on, the agent answers product questions from the assistant's knowledge instead of guessing: its attached knowledge documents, and your Help articles and News when the assistant has Answer from Help articles and Answer from News posts on. It cites what it used. When the knowledge does not cover a question, the agent says it does not have that information and offers a human. It does not make up menu names, settings paths or buttons. When a question needs a total, a difference or an average from figures in your documents, it calculates it, shows the calculation and says so.

If the contact picks one of the options the agent offered, the agent carries it out and does not ask again.

The First Reply

When a customer message started the flow and no Question card comes before the agent, the agent answers that message right away. If the message is only a greeting, the agent greets back. A flow started by a schedule always opens with a greeting.

How the Conversation Ends

The agent tags its last reply, and the flow follows the tag.

  • Natural end. The contact is done, for example after "thanks". The flow continues from the card's main output.
  • Route. The contact needs something the agent cannot do, such as a human. The flow follows the button whose label matches the route.
  • Max turns reached. The agent stops without a farewell and the flow follows the Error output. If it is not connected, the flow ends.

Name each button for the situation it handles, because the agent picks a route by its label.

Output Variables

VariableValue
flow.{cardId}.exitReasonnatural_end or max_turns_reached
flow.{cardId}.exitRouteLabel of the route the agent chose
flow.{cardId}.summaryThe agent's summary of the conversation, set on a route exit
flow.{cardId}.turnCountHow many turns ran

{cardId} is the ID of this card. See Variables for all namespaces.

Connections

  • 1 input port. Receives execution.
  • Main output. Natural end.
  • One output per button. Route exits.
  • Error output. Max turns reached, or the AI call fails.

Operations Cost

2 operations per execution, plus AI operations for the tokens used. They are metered separately. See Ops & Usage.

Detailed instructions give better results. Say what the agent should and should not do, which tone to use, and when to route.

Was this page helpful?

On this page