Pular para conteúdo

Subagents e Trabalho Delegado

Subagent é quando o bot chama outro agente para fazer uma parte do trabalho em paralelo ou em isolamento.

Para usuário final, isso aparece como: “vou deixar um agente auditando isso enquanto continuo por aqui”.

Quando faz sentido usar subagent

Use para trabalho maior, como:

  • auditoria de muitos arquivos
  • pesquisa profunda
  • análise independente
  • revisão de código ou documentação
  • comparação entre fontes

Não precisa usar subagent para pergunta simples ou ajuste pequeno.

Como o fluxo deve funcionar

O ideal é:

  1. o bot principal coordena
  2. subagents investigam partes específicas
  3. cada subagent entrega achados objetivos
  4. o bot principal cruza tudo, decide e implementa
  5. revisão acontece depois, com resultado concreto

Subagent bom não fica batendo papo. Ele entrega evidência, lacuna, risco ou sugestão clara.

Push-based: sem ficar perguntando toda hora

Spawns/subagents funcionam melhor em fluxo de conclusão automática: o agente delegado avisa quando termina.

Evite loop de “já terminou?” a cada minuto. Status só deve ser consultado quando houver motivo: travamento, intervenção, depuração ou pedido explícito.

Subagent nativo e ACP

Existem rotas diferentes:

  • subagent nativo — controlado pela configuração de subagents do OpenClaw
  • ACP/harness externo — Codex, Claude, Gemini, Opencode ou outro ambiente externo, com configuração própria

Por isso, custo, modelo e permissões precisam ser auditados por rota. Não assuma que todos usam o mesmo modelo.

Contexto recebido pelo subagent

Subagent nativo começa com contexto mais enxuto. Em geral, ele recebe regras operacionais e instruções de ferramentas, mas não necessariamente toda a personalidade, histórico ou contexto privado do bot principal.

Isso é bom para isolamento, mas significa que o coordenador precisa passar a tarefa com contexto suficiente.

Boa prática

Pedido ruim:

"Olha isso aí."

Pedido bom:

"Audite estes arquivos, não edite nada, procure trechos obsoletos sobre memória em banco e entregue achados por página."

Quanto mais claro o recorte, melhor o resultado.