Home / Glossary / Sub-Agentes

Definition

Sub-Agentes

Sub-agentes são processos filhos paralelos gerados por um agente de codificação de IA principal para lidar com partes independentes de uma tarefa complexa simultaneamente. Em vez de processar tudo sequencialmente, o agente principal delega subtarefas a agentes filhos especializados que rodam em paralelo e reportam resultados ao agente pai.

Como sub-agentes funcionam

Quando um agente principal encontra uma tarefa com múltiplas partes independentes, ele pode gerar sub-agentes para lidar com elas em paralelo. Por exemplo, se você pedir "refatore os módulos de autenticação, pagamento e notificação para usar o novo padrão de tratamento de erros," o agente principal pode gerar três sub-agentes—um para cada módulo. Cada sub-agente lê os arquivos relevantes, faz mudanças e executa testes independentemente. O agente principal coleta os resultados e garante consistência entre as mudanças.

Quando sub-agentes são úteis

  • +Grandes tarefas de refatoração que abrangem múltiplos módulos independentes
  • +Pesquisar diferentes partes de uma base de código simultaneamente
  • +Executar múltiplas tarefas de análise (auditoria de segurança, verificação de performance, revisão de estilo) em paralelo
  • +Gerar código para múltiplos componentes independentes de uma vez
  • +Investigar bugs complexos que podem ter múltiplas causas raiz

Sub-agentes são mais eficazes quando as subtarefas são verdadeiramente independentes—elas não modificam os mesmos arquivos ou dependem da saída uma da outra. Quando tarefas têm dependências, execução sequencial por um único agente é mais apropriada para evitar conflitos.

O Claude Code suporta sub-agentes através da ferramenta Task. O agente principal pode gerar agentes filhos com instruções específicas e permissões delimitadas, e então sintetizar seus resultados em uma resposta coerente.

Sub-agentes compartilham contexto com o agente principal?+
Sub-agentes recebem contexto do agente principal quando são criados, mas não compartilham uma janela de contexto em tempo real. Cada sub-agente opera independentemente com seu próprio contexto. O agente principal recebe a saída final deles e a sintetiza.
Quantos sub-agentes podem rodar ao mesmo tempo?+
Isso depende da ferramenta e dos recursos disponíveis. O Claude Code pode rodar múltiplos sub-agentes em paralelo, tipicamente 2-5 dependendo da complexidade de cada tarefa. O limite prático é determinado pelo uso de tokens e limites de taxa da API.
Sub-agentes podem gerar seus próprios sub-agentes?+
Em princípio, sim—isso cria uma árvore de agentes. Na prática, a maioria das tarefas é bem atendida com um único nível de delegação. Aninhamento profundo adiciona complexidade sem benefício proporcional para a maioria das tarefas de codificação.
Quando devo evitar usar sub-agentes?+
Evite sub-agentes quando tarefas têm dependências entre si, quando modificariam os mesmos arquivos (arriscando conflitos de merge), ou quando a tarefa é pequena o suficiente para que o processamento sequencial seja mais rápido que a sobrecarga de gerar e coordenar múltiplos agentes.

Related terms

Codificação AgênticaClaude CodeAgente de CodificaçãoAgente de IA Headless

Master Claude Code in days, not months

37 hands-on lessons from beginner to CI/CD automation. Module 1 is free.

START FREE →
← ALL TERMS