Agent Handoff

An auto-injected handoff tool call transfers the whole conversation to a better-suited peer on the same thread

Agent Handoff An auto-injected handoff tool call transfers the whole conversation to a better-suited peer on the same thread user request append turn handoff_to(specialist) auto-injected handoff tool call; whole conversation transfers attach same thread full history append answer continue reply Triage Handoff + continue User · session · Sequence participant User session Triage Agent · first responder · Sequence participant Triage Agent first responder Specialist · better-suited peer · Sequence participant Specialist better-suited peer Thread · shared conversation · Sequence participant Thread shared conversation Legend request return security async trace

Triage

  • • The first agent handles the opening turn
  • • Each turn is appended to the shared thread
  • • It recognizes a better-suited peer exists

Handoff

  • • Handoff is exposed as a normal tool call
  • • The runtime injects it automatically
  • • The full conversation transfers, not a summary

Takeover

  • • The peer attaches to the same thread
  • • It sees the complete history
  • • It continues the reply seamlessly

Sequence diagram • Built with Archify • Create yours ↗ • Hover to trace • R route • Click to focus • +/− zoom • M radar • T theme • E export