Subagentes
Agentes especialistas que o agente principal pode acionar sob demanda
Um subagente é um "especialista" dedicado que o agente principal (Worker) pode acionar a qualquer momento durante a execução de uma tarefa. Cada subagente tem sua própria área de especialização, um prompt dedicado e pode até rodar em um modelo diferente. No chat, basta digitar @SubagentName e ele entra para ajudar—como marcar um colega em um chat de grupo.
Subagentes integrados
O Verdent vem com 6 subagentes prontos para uso, cobrindo as necessidades mais comuns no desenvolvimento de software:
| Nome | Modelo padrão | No que é bom |
|---|---|---|
| General | Segue o agente principal | Um agente de pesquisa de uso geral para problemas complexos, busca de código e tarefas em várias etapas—pode ajudar com quase tudo |
| Fast Context | Gemini 3 Flash | Localizar código rapidamente e reunir evidências de contexto; especializado em indexação de bases de código e extremamente rápido |
| Verifier | Sonnet 4.6 | Revisão de código rápida—depois de fazer alterações, marque-o para detectar problemas óbvios |
| Verdent Helper | Haiku 4.5 | Um assistente de uso do Verdent; pergunte qualquer coisa sobre como o Verdent funciona |
| Multi-Model Planner | Gemini 3.1 Pro; Opus 4.6; GPT-5.4 | Gera planos usando vários modelos (Claude, GPT, Gemini) e combina seus resultados |
| Reviewer | Gemini 3.1 Pro; Opus 4.6; GPT-5.4 | Revisão de código completa: erros de lógica, casos extremos, riscos ocultos |
Dois subagentes são especiais: Multi-Model Planner e Reviewer rodam de 2 a 3 modelos em paralelo. Cada modelo pensa de forma independente, produz seu próprio resultado e, em seguida, os resultados são combinados. Todos os outros subagentes são de modelo único.
Como usar subagentes
Em qualquer conversa, digite @ para abrir o menu de seleção de subagentes (com suporte a busca aproximada). Selecione o subagente desejado e ele assumirá o contexto atual.
Exemplos:
- Depois de escrever uma lógica de autenticação complexa:
@Reviewer please review this→ o Reviewer a analisa sob as perspectivas de segurança, lógica e casos extremos. - Para uma decisão arquitetural complicada:
@Multi-Model Planner→ vários modelos propõem soluções e você escolhe a melhor. - Depois de programar, execute rapidamente
@Verifier→ mais rápido que rodar suítes de testes completas para uma validação básica.
Subagentes personalizados
Os subagentes integrados cobrem a maioria das necessidades, mas às vezes você quer um especialista feito sob medida para o seu projeto. Você pode criar o seu próprio.
Onde armazená-los
Subagentes personalizados são armazenados como arquivos Markdown em:
~/.verdent/subagents/São suportados até 5 níveis de subdiretórios para organização.
Formato do arquivo
Cada subagente é um arquivo Markdown com frontmatter YAML:
---
name: SQL-Expert
description: Specializes in SQL optimization and database design, good at analyzing slow queries and indexing strategies
color: blue
model: claude-sonnet-4-6
---
You are a senior database expert focused on PostgreSQL performance optimization.
When users provide SQL queries, you should:
1. Analyze the query execution plan
2. Identify performance bottlenecks (full table scans, missing indexes, etc.)
3. Provide concrete optimization suggestions and rewritten SQL
...Detalhes importantes
- Name: deve conter apenas letras, números e hifens (ex.:
SQL-Expert,MyAgent123). Sem espaços ou caracteres não-ASCII. - Color: uma das opções
dark-green,light-green,red-orange,amber,cyan,blue,pink,purple,verdent—para facilitar o reconhecimento visual. - Hot reload: salvar o arquivo
.mdentra em vigor imediatamente—sem precisar reiniciar o Verdent.
Gerenciando subagentes nas configurações
Todo o gerenciamento de subagentes acontece em Settings → Subagents.
| Ação | Descrição |
|---|---|
| Ver lista | Todos os subagentes são exibidos como cards. Os integrados têm o rótulo "Built-in"; os baseados em plugins mostram os nomes dos plugins. |
| Ativar / Desativar | Ative ou desative cada subagente sem afetar os outros. |
| Criar novo | Clique em Add Subagent e preencha Identifier (nome único), Model, Description e Prompt. |
| Editar | Passe o mouse sobre um card para editar. Subagentes integrados permitem alterar apenas Model e Description. |
| Duplicar | Copie qualquer subagente personalizado (as duplicatas ficam desativadas por padrão até serem ativadas). |
| Excluir | Subagentes personalizados podem ser removidos (com confirmação). Os integrados não podem ser excluídos. |
Diferenças na seleção de modelo
- Multi-Model Planner e Reviewer suportam seleção de múltiplos modelos (2 a 3 modelos de uma vez).
- Outros subagentes usam seleção de modelo único.
- General tem uma opção especial: pode seguir automaticamente o modelo do agente principal, evitando a manutenção de uma configuração separada.
Casos de uso
Revisão de código
Depois de implementar uma lógica complexa, marque @Reviewer. Ele verifica correção, casos extremos e possíveis bugs—poupando você da inspeção manual linha por linha.
Design de arquitetura com múltiplas perspectivas
Para decisões importantes (ex.: adoção de microsserviços, escolha de banco de dados), use @Multi-Model Planner para obter propostas independentes de vários modelos de ponta e reduzir o risco da decisão.
Validação rápida
Após alterações no código, @Verifier verifica rapidamente sintaxe, tipos e problemas básicos—mais rápido que suítes de testes completas e mais confiável que não fazer verificação alguma.
Especialistas de domínio personalizados
Crie subagentes sob medida para o seu projeto:
- Especialista em otimização de SQL ciente do seu schema e padrões de consulta
- Guardião de padrões de código front-end que aplica suas regras de ESLint e do design system
- Assistente de documentação que adapta conteúdo técnico em textos claros e fáceis de ler
Observações
- Subagentes personalizados precisam ser configurados com um modelo válido para serem ativados. Se você usar BYOK e a chave expirar ou o modelo for descontinuado, o subagente será desativado automaticamente.
- Os modelos dos subagentes integrados podem ser alterados, mas os padrões são ajustados—modificá-los pode reduzir o desempenho.
- A descrição importa: ela é injetada no contexto do agente principal e influencia quando os subagentes são chamados. Descrições melhores levam a um roteamento mais inteligente.
- Subagentes não podem chamar uns aos outros. Eles só podem ser invocados pelo agente principal (Worker)—nenhum aninhamento mais profundo é permitido.