AI agent handoff

Allow one AI agent to transfer a conversation to another AI agent.

Action — Requires the receiving AI agent's ID, secret, and platform domain from its Network settings.

What it does

Moves a conversation from one AI agent (AI agent A) to another (AI agent B), continuing in the same chat window without the person needing to restart.

When to use it

When different AI agents specialise in different workflows, data sources, or institutions — so the person reaches the right agent without restarting.

Connecting an AI agent

Copy these details from the receiving AI agent (AI agent B), found in its Network settings:

Field	Description
AI agent ID	Unique identifier for the receiving agent.
AI agent secret	Secure key used to verify inbound connections.
Platform domain	The domain where the receiving agent is hosted.

Then in AI agent A:

1

Open the action

Open the AI agent handoff action in the workflow tree.

2

Connect the agent

Select Connect external AI agent.

3

Enter credentials

Paste the AI agent ID, secret, and platform domain.

4

Verify

Select Verify & save.

What carries over

Session context transfers automatically so the person does not repeat themselves. Chat variables from the originating chat are passed to the receiving agent in a single _transferred_context variable as a JSON structure. Internal or sensitive data is filtered out automatically.

Security

Each AI agent has a unique secret key. All handoffs are authenticated, preventing unauthorised systems from intercepting conversations.

Example

Message received: "I want to complain about my bank"
├─ Send message: "Transferring you to our complaints agent..."
└─ AI agent handoff
   • AI agent ID, secret, platform domain of the complaints agent

The receiving agent's workflow reads carried-over values from _transferred_context.

Related

Live agent handoffExternal handoff