Um subagente é um contexto separado com instruções próprias, ferramentas próprias e frequentemente um modelo próprio — útil justamente porque o que ele lê não vai parar na conversa principal. Dois campos decidem se essa separação compensa. A descrição é o que provoca a delegação de trabalho, e ela compete com todos os outros agentes que você definiu, então uma vaga ou nunca dispara ou dispara o tempo todo. A lista de ferramentas é o jeito mais barato de manter estreito um agente estreito: um que só pode ler e buscar não sai por aí editando. Este criador escreve o arquivo e confere os dois, incluindo a combinação que pega as pessoas de surpresa: escrita sem leitura.
Recursos
Descrição conferida quanto à cláusula que provoca a delegação
Ferramentas escolhidas da lista real em vez de digitadas de memória
Aceita ferramentas MCP com namespace junto das nativas
Avisa quando um agente pode escrever arquivos mas não lê-los
A escolha de modelo explicada em termos de quando cada um compensa
Escopo de projeto ou pessoal, com o caminho correspondente
Um modelo herdado é omitido em vez de escrito
Baixa como um arquivo .md pronto para usar
Como usar Construtor de subagentes
Nomeie o agente e diga quando o trabalho deve ser entregue a ele
Escolha as ferramentas de que ele precisa, e só elas
Escolha um modelo, ou deixe herdar o da sessão
Escreva o prompt de sistema e baixe o arquivo
Exemplo
Entrada
tools: [Read, Grep, Glob]
Saída
description: Checks a database migration for problems that only show up in production. Use proactively whenever a migration file is added.
“Use proativamente quando…” é o que faz um agente disparar sem ser pedido.
Erros comuns e solução de problemas
Nunca é delegado nada ao agente. — A descrição precisa dizer quando, não só o quê. Acrescentar “Use quando…” ou “Use proativamente depois de…” costuma resolver.
Dois agentes vivem sendo confundidos. — As descrições se sobrepõem. Faça cada uma nomear uma situação distinta, não um assunto distinto.
Um nome de ferramenta aparece como desconhecido. — Os nomes diferenciam maiúsculas e são capitalizados: Read, não read. Ferramentas MCP usam o formato mcp__servidor__ferramenta e são aceitas como estão.
O agente edita coisas que eu não esperava. — Dê a ele uma lista de ferramentas mais estreita. Um agente sem Write nem Edit não muda nada, diga o que disser o prompt.
Perguntas frequentes
Quando um subagente é melhor do que fazer o trabalho ali mesmo?
Quando o trabalho envolve ler muito para produzir pouco: vasculhar uma base de código, conferir muitos arquivos, pesquisar. Tudo o que ele lê fica no contexto dele. Também é o jeito de rodar com um conjunto de ferramentas mais estreito que o da sessão principal.
Que modelo um subagente deve usar?
Herdar é um bom padrão. Um modelo mais barato e rápido compensa em passadas mecânicas, em que o trabalho é conferir mais do que decidir; um mais capaz, quando é preciso julgamento. O compromisso aparece ao lado de cada escolha.
Devo sempre restringir as ferramentas?
Restringir é barato e reversível, e é a forma mais confiável de manter focado um agente focado — muito mais do que pedir no prompt. Deixar a lista vazia herda tudo, o que serve para agentes de uso geral.
Escopo de projeto ou pessoal?
O de projeto versiona o agente junto com o repositório, então todo mundo trabalha com o mesmo. O pessoal acompanha você entre projetos. O caminho se atualiza conforme a escolha.
Qual a diferença para uma skill?
Uma skill acrescenta instruções ao contexto atual. Um subagente roda em outro lugar, com contexto e ferramentas próprios, e reporta de volta. Use uma skill para mudar como algo é feito; use um subagente para tirar o fazer da sua conversa.
Ferramentas relacionadas
Construtor de skills — Escreva um SKILL.md com o frontmatter verificado enquanto você digita.
Construtor de comandos — Crie um comando próprio, com argumentos e uma lista de ferramentas.