Skip to main content
Agent Handover lets one agent pass its work to another agent when a Run completes. Use it to build multi-step workflows where a general agent routes work to a specialist, or where one stage of a process hands off to the next.

​
Key Capabilities

  • Route work automatically: An agent can hand off to a pre-configured target agent at runtime—no manual intervention needed.
  • Configure targets in the AOP: Mention other agents with @Assignment Name directly in the AOP to set them as allowed handover targets.
  • Works with Queue: For case-based workflows, the case is released and routed to the target agent through the regular case dispatcher.
  • Works with standalone Runs: For non-case Runs, a new Run is started for the target agent, not carrying over any context from the source run.

​
How to Use It

​
Step 1: Open the Agent Builder

Open the agent you want to configure as a handover source and navigate to the AOP editor.

​
Step 2: Mention a target agent

In the AOP textarea, type @ followed by the name of the agent you want to hand off to. A dropdown appears listing available agents in your team. Select the agent. A badge is inserted inline in the AOP text—this registers it as an allowed handover target. Place the mention within naturally written rules for handover. You can add multiple targets if your agent may route to different specialists depending on the situation. Example AOP instruction:
After reviewing the customer request, determine whether it needs billing support or technical support. If billing, hand over to @Billing Specialist. If technical, hand over to @Technical Support.

​
Step 3: Save and test

Save the SOP. On the next Run, the agent will have access to a request_handover tool. At runtime, the agent decides when to use it based on your AOP instructions.

​
Viewing handover results

After a handover occurs, the source Run shows the handover target in its results. For case-based workflows, the case timeline reflects which agent handled each stage.

​
When to Use It

  • Triage workflows: A general agent reviews incoming cases and routes each one to the right specialist.
  • Escalation paths: An agent handles routine cases and escalates complex ones to a more specialized agent.
  • Sequential pipelines: One agent completes an initial stage (data gathering, analysis) and hands off to another for the next stage (reporting, action).
  • Domain specialization: Route work to an agent that has the right connections and context for a specific task type.

​
Things to Know

  • An agent can only hand off to agents configured as targets in its AOP—it cannot hand off to arbitrary agents at runtime.
  • If a mentioned agent is deleted, the mention badge turns red in the AOP editor. Remove the deleted target before the next run.
  • For case-based handovers, the target agent must have the Queue (Consumer) connection enabled. Agents without it are not available as handover targets in queue workflows.