Ir para o conteúdo principal
Zubnet AI › Aprender › Wiki › Subagentes
Usar AI

Subagentes

Também conhecido como: Subagents, Sub-agents, Orchestrator-Workers
Agentes lançados por outro agente para cuidar de parte de uma tarefa em seu próprio contexto separado, devolvendo apenas um resultado condensado.

Por que isso importa

Os subagentes resolvem o principal gargalo das tarefas longas de agentes: a janela de contexto. Vasculhar uma base de código ou ler vinte páginas da web pode produzir centenas de milhares de tokens, a maioria irrelevante depois. Se tudo isso cair no contexto do agente principal, a qualidade cai (degradação do contexto) e os custos sobem. Um subagente absorve a bagunça e devolve algumas centenas de tokens de conclusões.

Eles também permitem trabalho em paralelo. Produtos de pesquisa profunda, incluindo os da Anthropic, da OpenAI e do Google, usam um agente líder que dispara vários subagentes de busca de uma vez. Agentes de codificação como o Claude Code usam subagentes para exploração, revisão de código e execução de testes.

Em profundidade

Um subagente é um agente que outro agente inicia para repassar um pedaço do trabalho. O agente principal, muitas vezes chamado de orquestrador ou líder, escreve um brief descrevendo a subtarefa. O subagente então trabalha nela com sua própria janela de contexto nova, suas próprias ferramentas e às vezes um modelo diferente, e devolve um relatório curto. O líder nunca vê os passos intermediários do subagente, só o resultado.

Pense em um pesquisador-chefe que pede a três assistentes que leiam, cada um, uma pilha diferente de documentos e voltem com um resumo de uma página. O chefe continua focado no quadro geral enquanto a leitura acontece em outro lugar.

Três benefícios

  • Isolamento de contexto: cada subagente começa limpo e mantém a saída das suas ferramentas fora do contexto do líder.
  • Paralelismo: subtarefas independentes rodam ao mesmo tempo, reduzindo o tempo total de espera.
  • Especialização: um subagente pode ter seu próprio prompt de sistema, um conjunto restrito de ferramentas ou um modelo mais barato e rápido para trabalhos simples.

Os custos

Subagentes não são de graça. A Anthropic relatou que seu sistema de pesquisa multiagente usava cerca de 15 vezes mais tokens do que um chat normal, ao mesmo tempo que superava um agente único em cerca de 90% na sua avaliação interna de pesquisa. Isso vale a pena para perguntas valiosas e amplas e é desperdício para as simples.

O segundo custo é o contexto perdido. Um subagente sabe apenas o que está no seu brief. Ele não sabe o que o usuário disse antes, o que já foi descartado ou o que os outros subagentes estão fazendo. E o líder vê apenas o resumo, não as evidências, então o erro de um subagente volta soando tão confiante quanto uma descoberta correta.

O terceiro são as decisões conflitantes. A Cognition, empresa por trás do Devin, argumentou em um post de 2025 muito lido, intitulado "Don't Build Multi-Agents", que agentes paralelos escrevendo partes de uma mesma coisa fazem escolhas incompatíveis, porque cada um age com base em suposições que os outros não conseguem ver.

Quando eles se encaixam

Subagentes funcionam melhor em tarefas amplas, com muita leitura e separáveis: pesquisa, busca em grandes bases de código, revisão de muitos arquivos, checagem de um resultado com olhos novos. Eles se encaixam mal quando as subtarefas são fortemente acopladas, como quando vários agentes editam o mesmo código, ou quando a tarefa é pequena o bastante para um único contexto. Uma regra comum: paralelize a leitura, mantenha a escrita em um só lugar.

Como escrever um bom brief

O brief é o mundo inteiro do subagente, então escreva-o como uma passagem de trabalho para um prestador de serviço competente:

  • Diga o objetivo e por que ele importa, não só a ação.
  • Diga o que já se sabe ou já foi descartado.
  • Defina o escopo e quando parar.
  • Especifique o formato da resposta e peça fontes ou caminhos de arquivos para que o resultado possa ser conferido.

Briefs vagos são a falha mais comum. "Pesquise a escassez de semicondutores" manda três subagentes fazerem as mesmas buscas.

Subagentes versus sistemas multiagentes

Subagentes são um padrão dentro dos sistemas multiagentes: uma hierarquia em que um agente delega e os trabalhadores não conversam entre si. Outros padrões envolvem agentes que negociam, debatem ou colaboram como pares, às vezes entre empresas, usando protocolos como o A2A. O padrão orquestrador-trabalhadores é o mais implantado porque é o mais fácil de entender e prever.

← Todos os termos
ESC