Subagents
Um subagent é um especialista focado que executa uma tarefa delimitada — explorar o código, analisar arquitetura, revisar, implementar, testar — muitas vezes em paralelo e no modelo mais rápido. Eles deixam o agente principal delegar trabalho de escopo claro sem perder o fio da conversa.
Duas formas de rodar
- Automática (o agente decide). Para trabalho só-leitura — explorar, analisar, revisar — o agente aciona um subagent por conta própria, de forma síncrona. Apenas os tipos
explorer,analyzerereviewerpodem ser acionados assim. - Manual (você dispara). No Terminal (TUI),
/agent spawn <tipo> <tarefa>permite acionar qualquer tipo — inclusive os que escrevem arquivos (implementer, tester, refactorer, documenter).
Tipos de subagent
| Tipo | Papel | Escreve? | Ferramentas típicas |
|---|---|---|---|
explorer | busca rápida de arquivos/código | não | ler, buscar, listar |
analyzer | análise de estrutura/arquitetura | não | ler, buscar, listar |
reviewer | revisão (segurança, performance, manutenção) | não | ler, buscar |
implementer | implementar funcionalidades | sim | ler, criar, editar, executar |
tester | criar/rodar testes | sim | ler, criar, editar, executar |
refactorer | refatorar código | sim | ler, editar, executar |
documenter | documentação/READMEs | sim | ler, criar, editar |
Roteamento por modelo
Subagents de papel leve/só-leitura (explorar, analisar, revisar) rodam em uma configuração mais leve e rápida — ideal para varrer e resumir. Trabalho de planejamento/implementação herda o modelo da sessão. Veja Modelos.
Comandos (/agent, na TUI)
| Comando | O que faz |
|---|---|
/agent ou /agent list | Lista os subagents da sessão. |
/agent spawn <tipo> <tarefa> | Dispara um subagent para uma tarefa. |
/agent status [id] | Estado de um (ou de todos) os subagents. |
/agent cancel <id> | Cancela um subagent. |
/agent kill <id> | Encerra à força. |
/agent metrics | Contagens, taxa de sucesso e tokens por tipo. |
/agent cost | Orçamento de tokens: total, consumido e restante. |
Referência completa em Comandos da TUI.
Limites e orçamento
- Até 8 subagents simultâneos por sessão.
- Um orçamento de tokens compartilhado entre os subagents; ao excedê-lo, novos disparos são recusados.
- Profundidade limitada: um subagent não fica criando outros indefinidamente.
- O subagent automático (só-leitura) roda de forma síncrona e tem um teto de saída para não inundar o contexto.
Use /agent metrics e /agent cost para acompanhar consumo e desempenho.
Em cada superfície
- Terminal (TUI) — controle total via
/agent(e o acionamento automático do agente). - Desktop — o agente ainda usa subagents só-leitura automaticamente, mas não há um comando
/agentpara disparo manual. (O painel de tarefas do Desktop, Ctrl+T, é uma checklist de tarefas, não o sistema de subagents.) - VS Code — o Task Mode é um recurso separado: um laço de planejamento → passo → relatório sobre a sua sessão de chat normal, não o sistema de subagents local do Imaginne. Veja Usar no VS Code.
Veja também
Esta página ajudou?
Reportar um problema nesta páginaNão envie senhas, chaves, tokens ou dados de clientes.