Subagente
Um subagente (subagent) é um agente auxiliar a quem um agente principal entrega uma tarefa. Ele trabalha em uma janela de contexto própria e nova, muitas vezes com suas próprias instruções e ferramentas, e devolve só um resumo do resultado.
Também chamado: sub-agent
Por Divya Sharma · Verificado em 15 de nov. de 2026 · Como analisamos
Sessões longas de agentes se enchem de resultados de busca, logs e conteúdo de arquivos que importam para uma etapa e nunca mais. Um subagente mantém essa bagunça fora da conversa principal. O agente principal descreve a tarefa paralela, o subagente faz o trabalho isolado, e só o seu relatório curto volta.
Como funciona
No Claude Code, um subagente é definido em um arquivo Markdown: um nome, uma descrição de quando usá-lo, uma lista opcional de ferramentas e modelo permitidos, e um corpo que vira o seu system prompt. Quando uma tarefa corresponde à descrição, o agente principal a delega. O subagente começa com uma janela de contexto vazia; ele não vê o histórico do agente pai, então a mensagem de repasse precisa levar o que ele precisa. Outros coding agents e frameworks de agentes oferecem delegação parecida.
Por que importa
Subagentes são uma ferramenta de context engineering. Eles mantêm a conversa principal curta, permitem que várias tarefas de pesquisa ou revisão rodem em paralelo e permitem restringir ferramentas arriscadas a um auxiliar específico, como um revisor que pode ler arquivos, mas não editá-los.
Subagente versus sistema multiagente
Um subagente é um filho que responde a um único pai. Um sistema multiagente é o design mais amplo, que pode incluir pares que conversam entre si. Os subagentes são a forma mais simples e mais comum.
Limites
Cada subagente gasta seus próprios tokens, e qualquer coisa deixada de fora do repasse ou do resumo se perde para o agente pai.
Termos relacionados
- Sistema multiagente
- Um sistema multiagente (multi-agent system) é uma configuração em que vários agentes de IA, cada um com suas próprias instruções, ferramentas e contexto, trabalham em partes de uma tarefa e passam resultados uns aos outros ou a um agente coordenador.
- Agente de programação
- Um agente de programação (coding agent) é um agente de IA que trabalha diretamente no software: lê uma base de código, edita arquivos, roda comandos e testes, e repete até que uma mudança funcione, em vez de apenas sugerir código para uma pessoa colar.
- Context engineering
- Context engineering (engenharia de contexto) é a prática de escolher e manter tudo o que entra na janela de contexto de um modelo de linguagem durante uma tarefa: instruções, documentos recuperados, definições de ferramentas, resultados de ferramentas e histórico da conversa.
- Orquestração de agentes
- Orquestração de agentes é o controle de quais agentes ou chamadas de modelo rodam em uma aplicação, em que ordem e como cada próximo passo é escolhido, seja por um modelo que toma a decisão, seja por código fixo.
- Janela de contexto
- Uma janela de contexto (context window) é a quantidade máxima de texto, contada em tokens, que um modelo de linguagem consegue considerar de uma vez, incluindo o prompt de sistema, a conversa, os documentos, os resultados de ferramentas e a resposta que ele escreve.