Handoffs
How work moves between agents, and from an agent to a person, carrying its evidence.
A handoff moves an item from one owner to another and carries the item, the evidence gathered so far, and the run history with it. This is the difference between several agents and several separate tools: the second agent does not start from the beginning, and the person who eventually reads it can see every step without asking.
What travels with a handoff
- The item itself, with its source and current status.
- Everything the previous agent read, including which tool calls returned what.
- The reason for the handoff, written by the agent that made it.
- The full run history, so a trace is continuous across owners rather than restarting.
Handing off to a person
An agent that reaches the edge of its brief hands off rather than guessing. Where that lands depends on how you configured the agent: a plain handoff puts the item in somebody’s ownership on the board, and an action you routed to the approval queue arrives there instead, with the current record shown beside the proposed change.