Nível 2 — Ferramenta de trabalho · Módulo 2.7 — Subagentes

2.7.2 · Criando e usando subagentes

5 min de vídeo TEC BASIS

Objetivo: ao final, o consultor define um subagente próprio, com prompt e ferramentas restritas, sabe acioná-lo, e paraleliza múltiplos subagentes numa única mensagem.

O que você precisa levar desta aula

Um subagente é definido por quatro elementos: nome, gatilho (quando aciona), prompt próprio, e a lista de ferramentas que ele pode usar.
Restringir as ferramentas de um subagente é uma decisão de segurança e previsibilidade — não uma limitação que você aceita a contragosto.
Peça múltiplos subagentes independentes na mesma mensagem para eles rodarem em paralelo, em vez de um depois do outro.

Anatomia de um subagente

Elemento	O que define	Exemplo (`revisor-abap`)
Nome	Como você (e o Claude) se referem a ele	`revisor-abap`
Gatilho / descrição	Quando o Claude decide acioná-lo sozinho	"Revisão de qualidade de programa ABAP antes de subir para QAS"
Prompt próprio	O que ele sabe e como se comporta — separado do prompt da sua sessão	Checklist de qualidade ABAP da Wayon
Ferramentas permitidas	O que ele pode fazer no sistema	Read, Grep — sem Edit, sem Bash

Restringir ferramentas é feature, não limitação

Ferramenta restrita	O que isso evita
Sem `Edit` num subagente revisor	Ele não pode "corrigir" o que deveria só apontar como problema
Sem `Bash` num subagente de leitura	Ele não roda comando nenhum no sistema, mesmo que a tarefa parecesse pedir
Só `Read`/`Grep` num subagente de busca	O escopo dele fica óbvio só de olhar a definição — sem precisar ler o prompt inteiro para saber o que ele pode fazer

Quanto menor a lista de ferramentas, mais previsível o subagente — e mais fácil confiar nele para uma tarefa repetitiva.

Paralelizando múltiplos subagentes

Peça, numa única mensagem, mais de uma tarefa independente para subagentes diferentes: "Peça ao revisor-abap para revisar X, e ao revisor-cds para revisar Y." Os dois rodam ao mesmo tempo. Se você pedir um depois do outro, em mensagens separadas, eles rodam em fila — o mesmo resultado, mais devagar.

Regra Wayon Todo subagente com acesso a ambiente de cliente, mesmo só leitura, segue a mesma regra de ferramentas restritas desta aula: liste explicitamente o que ele pode usar, nunca deixe a lista aberta por padrão.

📖 Subagents — criação e configuração

Quiz — 4 questões

1.Você quer criar um subagente revisor-abap que só deve revisar código, nunca editar. Qual é a configuração correta?

a)Restringir a lista de ferramentas do subagente para incluir só leitura e busca, sem Edit
Correto.
b)Dar acesso a todas as ferramentas e confiar que o prompt instrui ele a não editar
O prompt pode ser ignorado ou mal interpretado; a restrição real está na lista de ferramentas, não só na instrução em texto.
c)Não é possível impedir um subagente de editar arquivo, só sugerir isso no prompt
É possível, e é justamente o que a lista de ferramentas permitidas faz.

Ver resposta e por quê

✅a) Correto.

❌b) O prompt pode ser ignorado ou mal interpretado; a restrição real está na lista de ferramentas, não só na instrução em texto.

❌c) É possível, e é justamente o que a lista de ferramentas permitidas faz.

2.Qual é a razão correta, segundo a aula, para restringir as ferramentas de um subagente?

a)É uma decisão de segurança e previsibilidade — reduz o que o subagente pode fazer por engano
Correto.
b)Ferramentas restritas deixam o subagente mais rápido
Não é uma questão de velocidade de execução.
c)É uma limitação técnica atual que deve ser contornada assim que possível
Ao contrário — a aula trata isso como uma escolha deliberada, não uma limitação a ser superada.

Ver resposta e por quê

✅a) Correto.

❌b) Não é uma questão de velocidade de execução.

❌c) Ao contrário — a aula trata isso como uma escolha deliberada, não uma limitação a ser superada.

3.Você tem duas tarefas independentes para dois subagentes diferentes. Qual é a forma mais eficiente de pedir?

a)Pedir as duas na mesma mensagem, para rodarem em paralelo
Correto.
b)Pedir a primeira, esperar terminar, depois pedir a segunda
Funciona, mas roda em fila em vez de em paralelo, gastando mais tempo do que o necessário.
c)Não é possível ter dois subagentes rodando ao mesmo tempo
É possível — é exatamente o recurso descrito no fechamento da aula.

Ver resposta e por quê

✅a) Correto.

❌b) Funciona, mas roda em fila em vez de em paralelo, gastando mais tempo do que o necessário.

❌c) É possível — é exatamente o recurso descrito no fechamento da aula.

4.O que compõe a definição de um subagente, segundo a aula? ---

a)Apenas um prompt — nome e ferramentas são configurados automaticamente pelo Claude
Os quatro elementos são definidos por quem cria o subagente, não gerados sozinhos.
b)Apenas a lista de ferramentas — o nome e o gatilho são opcionais
O gatilho é o que faz o Claude decidir quando acionar o subagente sozinho; sem ele, o acionamento fica impreciso.
c)Nome, gatilho, prompt próprio e lista de ferramentas permitidas
Correto.

Ver resposta e por quê

❌a) Os quatro elementos são definidos por quem cria o subagente, não gerados sozinhos.

❌b) O gatilho é o que faz o Claude decidir quando acionar o subagente sozinho; sem ele, o acionamento fica impreciso.

✅c) Correto.