Sub-agents

Main agent delegates to a math-specialist sub-agent. Tool and delegation approval events from the specialist fan in to the main agent’s stream. Source: examples/agent_with_subagents/

What it demonstrates

WithSubAgents registering a specialist with its own tools and a distinct WithName
Delegation approval (CUSTOM delegation events) and tool approval from sub-agent streams

Run

From examples/:

go run ./agent_with_subagents "Use the math specialist to compute 847 * 293"

Approve delegation and tool calls when prompted on stdin.

Key code

mathAgent, err := agent.NewAgent(
    agent.WithName("math-specialist"),
    agent.WithToolRegistry(mathReg),
    agent.WithLLMClient(llmClient),
    // plus runtime options
)

mainAgent, err := agent.NewAgent(
    agent.WithName("main-agent"),
    agent.WithSubAgents(mathAgent),
    agent.WithLLMClient(llmClient),
    // plus runtime options
)

See Sub-agents.

Expected output

Delegating to math-specialist...
Approve delegation to math-specialist? [y/n]: y
Tool call: calculator({"expression":"847*293"})
Approve? [y/n]: y
847 × 293 = 248,171

The main agent emits a delegation approval event before calling the sub-agent. The sub-agent then calls its tools and approval events fan in to the main agent’s stream.

Before You Begin

Basic Agents

Configuration

Tools & MCP

Streaming & AG-UI

Memory & RAG

Observability & Hooks

A2A

Multi-agent

Durable & Distributed

What it demonstrates

Run

Key code

Expected output

Learn more

Sub-agents

Approvals

​What it demonstrates

​Run

​Key code

​Expected output

​Learn more

Sub-agents

Approvals

What it demonstrates

Run

Key code

Expected output

Learn more