Skip to content

Configuration

SubAgentSpec

SubAgentSpec dataclass

SubAgentSpec(
    name: str,
    graph_definition_ref: str | None = None,
    task_queue: str | None = None,
    execution_timeout: timedelta = (
        lambda: timedelta(minutes=30)
    )(),
    description: str = "",
)

Specification for a sub-agent type.

Attributes:

Name Type Description
name str

Identifier for this sub-agent type (e.g., "researcher", "coder").

graph_definition_ref str | None

Reference to the pre-registered sub-agent graph in GraphRegistry.

task_queue str | None

Optional task queue override for this sub-agent type.

execution_timeout timedelta

Maximum execution time for this sub-agent.

description str

Human-readable description of the sub-agent's purpose.