Action Nodes

Action nodes make something happen: they end the workflow with a handoff, or trigger an outcome in an external channel.

The Send to AI Agent node has an On Error handle that fires if the handoff to the AI Agent fails. Always connect this handle to a Statement node that informs the customer and offers an alternative, such as asking them to refresh and try again. For more information, see Handling Error Scenarios.

Send to AI Agent

The Send to AI Agent node ends the workflow and passes control to the AI Agent. It always forwards the customer's original question. You can also configure it to forward selected workflow variables and accumulated knowledge base search filters, so the AI Agent's first response is already informed by everything the workflow collected.

This node is required in every Pre-Chat Workflow. A Pre-Chat Workflow cannot be published without at least one Send to AI Agent node. When this node executes successfully, the workflow ends — do not place nodes after it expecting them to run.

Field

Description

Data to Send

Select Send userQuery to forward the current userQuery as the AI Agent's current user message. This is optional and is not selected by default — only enable it if the AI Agent should treat the workflow's captured question as the customer's next message.

Variables 

Use the Select variable dropdown to choose which values to pass to the AI Agent to be used as session context. The dropdown lists all variables available to the AI Agent — System, Custom, and KB variables — since variables are scoped to the session and agent rather than declared per workflow. Selected variables appear as removable rows above the dropdown.

Only variables that have a value at runtime are sent to the AI Agent. A selected variable with no value at the time the node executes is omitted from the handoff rather than sent as empty.

Query Filters

Select Include queryOps to forward the accumulated knowledge base search filters (queryOps) built up over the course of the workflow to the AI Agent.