EN·ES·DE·PT·FR
⌘K

Criação de Sub-Agentes

O agente pode criar agentes filhos para tarefas complexas, possibilitando delegação recursiva.

Nome da Ferramenta

spawn_agent

Parâmetros

KeyTypeDefaultDescription
missionstringPapel/contexto de alto nível para o sub-agente
taskstringPergunta concreta ou trabalho a ser realizado

Comportamento

  • O agente filho roda em parent_depth + 1
  • Herda o provedor, armazenamento de estado, modelo e ferramentas não-spawn do pai
  • Recebe um prompt de sistema focado: instruções base + contexto da missão
  • Executa um loop agêntico completo em uma sessão isolada (sub-{depth}-{uuid})
  • Retorna a resposta final em texto para o pai (truncada em max_response_chars)
  • Se child_depth < max_depth, o filho também recebe a ferramenta spawn_agent

Configuração

config.toml
[subagents]
enabled = true
max_depth = 3
max_iterations = 10
max_response_chars = 8000
timeout_secs = 300
Limite de Recursão
Sub-agentes podem criar seus próprios sub-agentes até max_depth níveis de profundidade. Na profundidade máxima, a ferramenta spawn_agent não é disponibilizada.
Timeout
Cada invocação de sub-agente tem um timeout fixo (timeout_secs). Se um sub-agente demorar demais, o pai recebe um erro de timeout.