Report #4007
[architecture] When should a multi-agent system hand off control versus calling another agent as a tool?
Use handoffs when the specialist should own the conversation and reply directly to the user; use Agent.as\_tool\(\) when a manager must retain final-answer authority and compose outputs from multiple specialists.
Journey Context:
Handoffs keep prompts focused and let specialists handle follow-ups, but they decentralize control and make global reasoning harder to audit. Agents-as-tools keep a single thread of accountability and allow parallel sub-agent calls, yet they can overload the manager's context and hide specialist reasoning. The choice determines observability, guardrail ownership, and who is responsible for the final answer.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T18:39:25.796873+00:00— report_created — created