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

2.7.1 · O que é um subagente e por que ele economiza contexto

4 min de vídeo TODOS

Objetivo: ao final, o consultor explica o que muda quando uma tarefa roda num subagente em vez da sessão principal, e reconhece as situações em que vale a pena delegar.

O que você precisa levar desta aula

Um subagente tem contexto próprio, isolado do contexto da sessão principal — o que ele lê e descarta durante a investigação fica só com ele.
Ele devolve à sessão principal o resultado final, não o caminho inteiro que percorreu para chegar lá.
Vale delegar quando a tarefa é uma busca ampla, envolve ler muitos arquivos, ou pode rodar em paralelo com outra coisa que você está fazendo.

O que muda com o contexto isolado

	Sessão principal, sem subagente	Delegado a um subagente
Arquivos abertos durante a busca	Ficam no contexto da sessão principal, mesmo os descartados	Ficam no contexto do subagente, isolado
O que chega até você	A resposta, misturada ao rastro da busca	Só a conclusão
Efeito no contexto principal	Sobe a cada arquivo aberto	Não se altera

Quando vale a pena delegar

Situação	Por quê
Busca ampla por um repositório	Você não sabe onde está a resposta — vai custar abrir vários candidatos até achar
Leitura de muitos arquivos	Só a leitura, sozinha, já ocuparia uma fração grande do seu contexto disponível
Tarefa em paralelo com outra	Não precisa esperar uma terminar para começar a próxima — os dois rodam ao mesmo tempo

Quando não vale a pena

Uma pergunta pontual, sobre um arquivo que você já tem aberto, não precisa de subagente — delegar tem um custo de coordenação (o subagente também gasta tempo e tokens para investigar) que só compensa quando a tarefa é grande o bastante para justificar isolar o contexto dela.

📖 Introduction to Subagents — documentação oficial

Quiz — 4 questões

1.Você precisa achar uma informação espalhada por vários arquivos candidatos, sem saber qual tem a resposta. Qual é o efeito principal de delegar essa busca a um subagente, em vez de fazer na sessão principal?

a)A busca fica mais rápida, porque o subagente usa um modelo diferente
Não é uma questão de velocidade nem de modelo — o ganho é sobre onde o contexto da busca fica armazenado.
b)Os arquivos abertos e descartados durante a busca ficam no contexto do subagente, não no da sessão principal
Correto. É exatamente o mecanismo de isolamento de contexto.
c)O subagente tem acesso a arquivos que a sessão principal não tem
O acesso é o mesmo; a diferença é o isolamento do contexto, não o alcance dos arquivos.

Ver resposta e por quê

❌a) Não é uma questão de velocidade nem de modelo — o ganho é sobre onde o contexto da busca fica armazenado.

✅b) Correto. É exatamente o mecanismo de isolamento de contexto.

❌c) O acesso é o mesmo; a diferença é o isolamento do contexto, não o alcance dos arquivos.

2.O que volta da sessão do subagente para a sessão principal, ao final de uma tarefa delegada?

a)Apenas o resultado final da investigação
Correto.
b)O histórico completo de tudo que o subagente leu e descartou
Isso é justamente o que fica isolado no contexto do subagente, não o que retorna.
c)Nada — o subagente atua de forma totalmente independente, sem se comunicar de volta
Ele se comunica de volta, sim — só que com o resultado, não com o processo inteiro.

Ver resposta e por quê

✅a) Correto.

❌b) Isso é justamente o que fica isolado no contexto do subagente, não o que retorna.

❌c) Ele se comunica de volta, sim — só que com o resultado, não com o processo inteiro.

3.Qual das situações abaixo é a melhor candidata para delegar a um subagente?

a)Uma pergunta pontual sobre um arquivo que você já tem aberto na tela
O custo de coordenação de um subagente não compensa para algo tão pequeno e já visível.
b)Uma busca ampla por um repositório inteiro, atrás de uma regra que pode estar em qualquer um de dezenas de arquivos
Correto. É o caso clássico de busca ampla descrito na aula.
c)Pedir para o Claude explicar uma linha de código que está bem na sua frente
Não exige abrir outros arquivos nem encher contexto — não há o que isolar aqui.

Ver resposta e por quê

❌a) O custo de coordenação de um subagente não compensa para algo tão pequeno e já visível.

✅b) Correto. É o caso clássico de busca ampla descrito na aula.

❌c) Não exige abrir outros arquivos nem encher contexto — não há o que isolar aqui.

4.Duas tarefas independentes precisam ser feitas: mapear um programa ABAP e, ao mesmo tempo, revisar uma planilha de RICEFW. Qual arranjo aproveita melhor a possibilidade de subagentes? ---

a)Rodar as duas tarefas uma depois da outra, na mesma sessão principal
Funciona, mas gasta duas vezes o contexto principal e não aproveita o paralelismo possível.
b)Delegar as duas a subagentes separados, para rodarem em paralelo
Correto. É exatamente a terceira situação em que vale delegar.
c)Delegar só uma delas a um subagente, e fazer a outra manualmente sem o Claude
Abre mão da ajuda do Claude numa das tarefas sem necessidade — as duas podem ser delegadas ao mesmo tempo.

Ver resposta e por quê

❌a) Funciona, mas gasta duas vezes o contexto principal e não aproveita o paralelismo possível.

✅b) Correto. É exatamente a terceira situação em que vale delegar.

❌c) Abre mão da ajuda do Claude numa das tarefas sem necessidade — as duas podem ser delegadas ao mesmo tempo.