1. O Papel do Agente Principal (Orquestrador)

O Agente Principal é o seu ponto de contato direto e o cérebro estratégico da sessão. Ele detém a visão macro do projeto, entende o objetivo final e gerencia a “conversa” central com você. Pense nele como o gerente que sabe o que precisa ser feito, mas coordena a execução em vez de fazer tudo sozinho.

Ele é responsável por analisar o seu pedido e decidir se a tarefa é simples o suficiente para ele mesmo resolver ou se precisa de ajuda especializada. Manter o Agente Principal focado na estratégia evita que ele gaste o contexto com logs técnicos pesados ou detalhes de implementação que não agregam valor à visão geral.

2. Subagentes: Os Especialistas Técnicos

Um Subagente é uma instância temporária e focada, criada para resolver um problema específico e isolado. Ele pode ser configurado como um “especialista em Python”, um “auditor de segurança” ou um “pesquisador web”. Por ter um foco estreito, ele é muito mais preciso e menos propenso a distrações do que um agente generalista.

Quando o Subagente termina sua missão, ele reporta o resultado ao Agente Principal e sua sessão é encerrada logo em seguida. Isso mantém o seu ambiente de trabalho limpo e garante que a inteligência central não seja contaminada por ruídos técnicos excessivos que poderiam prejudicar raciocínios futuros.

3. Como e Quando Criar um Subagente

A regra de ouro da eficiência é: se a tarefa exige mais de três passos técnicos ou envolve a leitura de muitos arquivos, delegue. O OpenClaw permite que o Agente Principal invoque subagentes de forma transparente, passando apenas as informações estritamente necessárias para aquela sub-tarefa.

Use subagentes sempre que precisar de uma pesquisa profunda na documentação ou quando estiver lidando com refatoração de código legado complexo. Isolar essas tarefas em subagentes evita que um erro técnico em um script trave todo o seu fluxo de pensamento principal, garantindo fluidez total.

4. Workflow de Trabalho em Equipe

• Identificar a Demanda: O Agente Principal percebe que a tarefa requer uma habilidade específica ou um processamento longo que ele prefere isolar. Isso mantém a sessão principal ágil e focada apenas na tomada de decisão de alto nível.
• Definir o Contexto: O Principal envia apenas os arquivos e instruções relevantes para o novo Subagente, economizando tokens preciosos. Essa filtragem de informação é o que garante que o subagente entregue o resultado correto sem se perder em contextos irrelevantes.
• Consolidar o Resultado: O Subagente entrega a solução técnica, o Principal revisa a qualidade e apresenta o resultado final para você. Esse processo de “revisão por pares” entre agentes eleva drasticamente o padrão das entregas finais do seu projeto.