Trabalhar com subagentes no Chat
Um agente principal pode delegar uma parte delimitada do trabalho a um subagente e usar o resultado devolvido na sessão principal. Subagentes servem para investigações focadas ou trabalhos especializados que continuam ligados a uma única solicitação.
Acompanhar o trabalho delegado
Enquanto os subagentes trabalham, a transcrição mostra uma linha para cada um com o seu status:
| Status | Significado |
|---|---|
| Running (Em execução) | O subagente está trabalhando. A linha mostra há quanto tempo chegou a última atividade. |
| Waiting for your authorization (Aguardando sua autorização) | Uma ferramenta precisa da sua aprovação. |
| Waiting for an answer (Aguardando resposta) | O subagente fez uma pergunta. |
| Retrying (Tentando novamente) | A requisição ao modelo falhou e está sendo repetida. |
| Done (Concluído) | O resultado foi entregue à sessão principal. |
| Error (Erro) | O subagente não conseguiu terminar. |
Um resumo como Waiting for subagents · 2 active · 1 done (Aguardando subagentes · 2 ativos · 1 concluído) acompanha o grupo. Uma linha que mostra No new activity (Sem novas atividades) por muito tempo pode estar travada; abra-a para conferir.
Abrir a sessão de um subagente
Selecione a linha de um subagente para abrir a sessão dele. Na barra lateral, ela abre em uma aba do editor; no Agent Manager, abre no painel à direita. A sessão filha mantém a própria transcrição e continua ligada à sessão principal.
Um resultado só é útil para a sessão principal depois de ser entregue a ela.
Executar subagentes em segundo plano
Um subagente em segundo plano continua trabalhando enquanto a sessão principal segue. O cabeçalho da sessão mostra quantos estão em execução; a partir dali, abra um, abra todos ou use Stop (Parar). Quando um agente em segundo plano precisa de você, ele é marcado como Needs input (Entrada necessária).
Para executar todas as delegações em segundo plano, ative Background Subagents (Subagentes em segundo plano) em Settings → Experimental (Configurações → Experimental).
Escolher o modelo do subagente
Os subagentes usam o Subagent Model (Modelo de Subagente) definido em Settings → Models (Configurações → Modelos) ou, se ele não estiver definido, o modelo do agente que fez a chamada. Para pedir um modelo específico em uma solicitação, mencione-o com @ e selecione Model; o agente principal pode então atribuir esse modelo, provedor e esforço de raciocínio ao subagente.
Compartilhar um quadro entre subagentes
O AI Cockpit Swarm, em Settings → Agents (Configurações → Agentes), dá à sessão principal e aos subagentes um quadro compartilhado para tentativas em paralelo ou trabalhos complementares. Ative-o em tarefas que se beneficiam de coordenação, não em todas. O quadro aparece no cabeçalho da sessão como Board (Quadro), com opções para atualizá-lo ou redefini-lo.
Responder à permissão de um subagente
Um subagente pode gerar um pedido de permissão no Chat principal. O pedido indica que veio de uma sessão filha. Revise a operação e o alvo como faria com qualquer outro pedido de permissão.
Subagentes são diferentes das sessões do Agent Manager. Use o Agent Manager para frentes de trabalho que você mesmo gerencia, com worktrees Git e terminais separados.