Agent Handoff • AI Agent SDK

agent_handoff: Emit agent handoff event for tracking agent-to-agent flow.

​

agent_handoff

Method

This is a method of the ContextTraceEmitter class in the context_events module.

Emit agent handoff event for tracking agent-to-agent flow.

​

Signature

def agent_handoff(from_agent: str, to_agent: str, reason: Optional[str], context_passed: Optional[Dict[str, Any]], kind: str, node_id: Optional[str]) -> None

​

Parameters

from_agent · str · required

No description available.

to_agent · str · required

No description available.

reason · Optional[str]

No description available.

context_passed · Optional

No description available.

kind · str · default: "'handoff'"

handoff (agent hands over), delegate (the hierarchical manager assigns a task), route or spawn.

node_id · Optional[str]

Graph node concerned; defaults to the receiving agent.

​

Uses

• ContextEvent
• time.time

​

Source

View on GitHub

praisonaiagents/trace/context_events.py at line 1154

---

​

Related Documentation

Agents Concept

Single Agent Guide

Multi-Agent Guide

Agent Configuration

Auto Agents