How a run executes

Understanding how a multi-agent run executes turn by turn helps you write better instructions and build more reliable agents.

The execution model

  • The root agent never calls the model itself — it only holds shared instructions and routes between sub-agents. Every real answer comes from a sub-agent.
  • The root's shared instructions are merged into whichever sub-agent is active, so they always influence behavior even though the root never "speaks" on its own.
  • A sub-agent's own instructions take priority over the root's shared instructions when the two would conflict — write sub-agent instructions assuming they win.
  • A run proceeds in steps; each step is one sub-agent's turn (one or more tool calls, a handoff, or a final answer).
  • Every run ends in exactly one final answer.

What you see in traces

Routing timeline rows always show a real sub-agent as the responder — never the root agent itself as the "from" or "to" party for a model-generated answer.

Authoring implications

  • Put agent-wide policy in root instructions; put anything behavior-critical in sub-agent instructions when the two could conflict.
  • Always define at least one sub-agent as the default — a root-only agent with no sub-agents cannot answer anything.

Common Pitfall: Assuming the root's instructions alone control behavior. They're merged context for whichever sub-agent is active, not an overriding system prompt.