Tokencito Jogo do dia Jogar

O que é um subagente em IA?

Um subagente é um agente que o agente principal lança para uma tarefa delimitada, como procurar onde uma função é usada. Ele começa com a própria janela de contexto, trabalha com suas ferramentas e devolve só o resultado, não tudo o que leu. Assim o contexto do agente principal não se enche de detalhes.

🤖Agente principal📤Lança um subagente🔎Trabalha no contexto dele📋Devolve o resultado

Teste o que aprendeu

Uma pergunta do app. Escolha uma resposta.

Você disse ao agente "não mexa em pagamentos". Ele lança um subagente. O que repassa?

Jogue a lição completa: De responder a fazer

Para que serve

Você pede a um agente de código que renomeie uma função. Antes ele precisa saber onde ela é usada: abre 40 arquivos e acha 6 chamadas. Se faz isso sozinho, esses 40 arquivos ficam na janela de contexto dele pelo resto da sessão. Se um subagente faz, o principal recebe uma lista de 6 linhas.

Também serve para trabalhar em paralelo, com três subagentes revisando três pastas ao mesmo tempo, e para dar a uma parte do trabalho outras regras: um revisor que só pode ler, sem permissão para editar, ou com instruções próprias de revisor.

O que custa

Delegar soma pedidos e relatos, e poupa trabalho e espaço ao principal. Se sai mais barato, depende: um modelo mais barato numa tarefa delimitada pode compensar; três subagentes em paralelo costumam gastar bem mais tokens que um agente só. Para conferir, some tudo, revisão incluída.

E, a menos que a ferramenta o lance com uma cópia da conversa, ele começa sem saber o que o principal sabia. O que você falou na conversa não chega a ele se ninguém passar. Por isso o pedido ao subagente precisa ser completo: a tarefa, o que já se sabe e as regras que valem para ela. Escolher o que passar é engenharia de contexto.

Subagente, skill e arquivo de regras

Uma skill soma instruções ao mesmo agente, no mesmo contexto. Um arquivo como CLAUDE.md dá regras fixas para a sessão inteira. Um subagente é outro agente, com contexto separado, e de todo o trabalho que fez só volta o que ele relata.

Em outubro de 2026, o Claude Code usa esse nome e deixa você definir os seus, cada um com suas instruções e ferramentas. Outras ferramentas têm ideias parecidas com outros nomes, e mudam com frequência: confira a documentação da que você usa.

Erros comuns

"Mais subagentes sai mais barato." É mais rápido em paralelo, mas costuma gastar mais tokens. "Ele sabe o que conversamos." Só sabe o que recebe. "Se o subagente disse, está comprovado." O relato dele é um resumo: pode deixar algo de fora ou errar, como qualquer agente. Para uma tarefa pequena, lançar um custa mais do que economiza.