Subagent Toolset¶

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

Basic Usage¶

agents:
  coordinator:
    tools:
      - type: subagent

Available Tools¶

Subagent Tools Tools

`list_available_nodes`

List available agents and/or teams in the current pool.

Parameters:

Name	Type	Required	Description
`node_type`	string		Filter by node type - "all", "agent", or "team"
`only_idle`	boolean		If True, only returns nodes that aren't currently busy

Hints: read-only, idempotent

Category: search

`task`

Execute a task on an agent or team.

Launch a task to be executed by a specialized agent or team.

In synchronous mode (default), the task runs with streaming progress events and returns the result when complete.

In async mode, the task starts in the background and returns immediately with a task ID. The output is streamed to /tasks/{task_id}/output.md in the internal filesystem, which can be read later.

Parameters:

Name	Type	Required	Description
`agent_or_team`	string	✓	The agent or team to execute the task
`prompt`	string	✓	The task instructions for the agent or team
`description`	string	✓	A short (3-5 words) description of the task
`async_mode`	boolean		If True, run in background and return task ID immediately

Category: other

Configuration Reference¶

Subagent Toolset¶

Configuration for subagent interaction tools.

Subagent Toolset (YAML)
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:
    tools:
      - type: subagent
    system_prompt: You coordinate work between specialized agents.

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

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

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