Módulo 10 - Subagentes
Por que e quando delegar a um subagente
8 min de leitura · por Cesar Gargiulo, revisado pela equipe ValorFinal e GuardiaSec · Atualizado em 13/07/2026
O que você vai aprender
- Listar os quatro benefícios de delegar a um subagente.
- Entender como limitar ferramentas aumenta a segurança.
- Ver como especializar o comportamento melhora resultados.
- Saber usar modelos mais baratos em subagentes.
Ouvir o resumo desta aula
Um recap de cerca de 2 minutos na voz do Valim, para ouvir no trânsito ou na academia.
Ler a transcrição do resumo
Resumo da aula: Por que e quando delegar a um subagente.
Os objetivos desta aula. Listar os quatro benefícios de delegar a um subagente. Entender como limitar ferramentas aumenta a segurança. Ver como especializar o comportamento melhora resultados. Saber usar modelos mais baratos em subagentes.
Veja o essencial, parte por parte.
Os quatro benefícios de delegar. Preservar contexto: o trabalho ruidoso fica no subagente, e a conversa principal recebe só o resumo.
Limitar ferramentas e especializar o comportamento. Dois desses benefícios merecem um olhar mais atento por ligarem com temas do curso.
Quando não vale delegar. A tarefa é ruidosa, especializada e repetida? Delegue a um subagente.
Esse foi o resumo do essencial. Para se aprofundar, leia a aula completa e responda os exercícios.
Os quatro benefícios de delegar
Delegar a um subagente traz quatro benefícios que vale conhecer para decidir quando usar. O primeiro você já viu: preservar contexto, mantendo a conversa principal limpa ao empurrar o trabalho ruidoso para o contexto isolado do subagente. O segundo é limitar ferramentas: você pode dar a um subagente acesso só às ferramentas de que ele precisa, o que reduz o que ele pode fazer e aumenta a segurança. O terceiro é especializar: um subagente com instruções focadas num domínio se comporta como um especialista. O quarto é economizar custo: você pode fazer um subagente usar um modelo mais barato para tarefas simples, sem afetar o modelo da conversa principal.
Repare que esses benefícios se somam. Um subagente de revisão de segurança, por exemplo, pode ao mesmo tempo isolar o ruído da análise, ter acesso só às ferramentas de leitura, seguir instruções especializadas em segurança e rodar num modelo econômico se a tarefa permitir. Cada benefício resolve uma dor diferente, e juntos transformam o subagente numa peça poderosa. Não é preciso buscar os quatro de uma vez; muitas vezes você cria um subagente por um motivo, como preservar contexto, e ganha os outros de brinde. Conhecer os quatro ajuda a enxergar mais oportunidades de delegar do que você imaginava.
Limitar ferramentas e especializar o comportamento
Dois desses benefícios merecem um olhar mais atento por ligarem com temas do curso. Limitar ferramentas conecta com o módulo de segurança: assim como você aprendeu a bloquear e liberar ferramentas com regras de permissão, um subagente pode nascer com um conjunto restrito de ferramentas. Um subagente que só precisa ler e analisar pode receber apenas as ferramentas de leitura, sem poder editar nem rodar comandos. Isso é uma defesa em profundidade: mesmo que algo dê errado, o subagente não consegue fazer o que não foi autorizado. Delegar uma tarefa a um subagente de poderes reduzidos é mais seguro do que fazê-la na conversa principal, que tem todas as ferramentas à mão.
Especializar conecta com o módulo de bons pedidos. Um subagente carrega um prompt próprio, um conjunto de instruções que define como ele age. Em vez de reexplicar a cada vez o que você espera de uma revisão de código, você escreve essas instruções uma vez no subagente, e ele passa a agir como um revisor especializado sempre que acionado. É a diferença entre contratar um generalista e ter um especialista de plantão: o especialista já sabe o que fazer, com que critério, em que formato. Subagentes especializados codificam o seu jeito de trabalhar numa peça reutilizável, garantindo consistência e poupando você de repetir instruções.
🎮 Jogo da aula
Qual benefício de delegar?
Classifique cada situação conforme o principal benefício de usar um subagente nela.
O benefício de custo, por fim, é uma otimização prática. Como você viu no módulo dos modelos, tarefas simples rendem mais num modelo rápido e barato. Um subagente pode ser configurado para usar um modelo assim, enquanto a conversa principal segue num modelo mais capaz. Por exemplo, um subagente que só resume ou classifica pode rodar no modelo mais econômico, poupando o modelo caro para o raciocínio principal. Isso é especialmente valioso em quem usa muito e com frequência, onde a soma dessas economias faz diferença. Delegar, aqui, não é só organizar; é usar o modelo certo para cada parte do trabalho.
Quando não vale delegar
Como todo recurso, o subagente pode ser usado demais. Para tarefas pequenas e diretas, criar ou acionar um subagente adiciona uma camada que não compensa. Se a tarefa é rápida, cabe na conversa principal sem poluí-la e não é repetida, fazê-la ali mesmo é mais simples. Delegar tem um custo de coordenação: você passa a tarefa, o subagente trabalha, devolve o resultado, e isso só vale quando o ganho de contexto, segurança, especialização ou custo supera esse custo. Como sempre no curso, a regra é o equilíbrio: delegue o que ganha com o isolamento e a especialização, e faça direto o que é pequeno e único.
Com o porquê e o quando claros, você já sabe reconhecer as oportunidades de delegar. A próxima aula mostra o como: criar o seu próprio subagente é surpreendentemente simples, um arquivo de texto com algumas informações, e o Claude Code pode até escrevê-lo para você. Assim como os comandos personalizados nasciam de um arquivo, os subagentes seguem uma lógica parecida, o que torna criar um deles um passo natural depois do que você já aprendeu. Você vai ver que montar a sua equipe de ajudantes especializados está ao seu alcance, sem precisar de nada complicado.
Teste rápido
Como limitar as ferramentas de um subagente contribui para a segurança?
Perguntas frequentes
- Quais são os benefícios de delegar a um subagente?
- Quatro: preservar contexto, mantendo a conversa principal limpa; limitar ferramentas, aumentando a segurança; especializar, com instruções focadas que rendem melhor; e economizar custo, roteando tarefas simples a modelos mais baratos. Eles costumam se somar num mesmo subagente.
- Como limitar ferramentas ajuda?
- Um subagente pode nascer com acesso só às ferramentas de que precisa, como só leitura para um revisor. Isso reduz o que ele pode fazer e funciona como defesa em profundidade: mesmo que algo saia do previsto, ele não executa o que não foi autorizado. É mais seguro que fazer tudo na conversa principal.
- O que significa especializar um subagente?
- Dar a ele um prompt focado num domínio, como revisão de segurança ou escrita de testes, para que aja como um especialista. Você escreve as instruções uma vez, e o subagente passa a segui-las sempre que acionado, garantindo consistência e poupando você de reexplicar o que espera.
- Dá para economizar dinheiro com subagentes?
- Dá. Você pode fazer um subagente usar um modelo mais rápido e barato para tarefas simples, como resumir ou classificar, enquanto a conversa principal segue num modelo mais capaz. Em quem usa muito, a soma dessas economias faz diferença, sem prejudicar o raciocínio principal.
- Quando não vale a pena delegar?
- Em tarefas pequenas, diretas e únicas, que cabem na conversa principal sem poluí-la. Delegar tem um custo de coordenação que só compensa quando o ganho de contexto, segurança, especialização ou custo o supera. Na dúvida, comece na conversa principal e crie um subagente quando a repetição aparecer.
Fontes
Seu progresso fica salvo neste aparelho. Assinantes sincronizam entre os aparelhos.