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

`delegate_to`

Delegate a task to an agent or team.

If an action requires you to delegate a task, this tool can be used to assign and execute a task. Instructions can be passed via the prompt parameter.

Parameters:

Name	Type	Required	Description
`agent_or_team_name`	string	✓	The agent or team to delegate the task to
`prompt`	string	✓	Instructions for the agent or team to delegate to.

Category: other

`ask_agent`

Send a message to a specific agent and get their response.

Parameters:

Name	Type	Required	Description
`agent_name`	string	✓	Name of the agent to interact with
`message`	string	✓	Message to send to the agent

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.