Skip to content

Subagent Toolset

The Subagent toolset enables agents to delegate tasks to other agents in the pool.

Basic Usage

agents:
  coordinator:
    toolsets:
      - type: subagent

Available Tools

Tool Description
list_available_nodes List agents available for delegation
delegate_to Delegate a task to another agent
ask_agent Ask another agent a question

Configuration Reference

Subagent Toolset

Configuration for subagent interaction tools.

Subagent Toolset (YAML)
1
2
3
4
5
toolsets:
- type: subagent
  tools: null  # Optional tool filter to enable/disable specific tools.
  batch_stream_deltas: false  # Batch consecutive text/thinking deltas for fewer UI updates.
  namespace: null  # Optional namespace prefix for tool names

Example Workflow

agents:
  coordinator:
    toolsets:
      - type: subagent
    system_prompts:
      - You coordinate work between specialized agents.

  researcher:
    model: openai:gpt-4o
    system_prompts:
      - You research topics thoroughly.

  writer:
    model: openai:gpt-4o
    system_prompts:
      - You write clear documentation.

The coordinator can then delegate research to the researcher and writing to the writer.