--- title: Subagentes description: "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: ```markdown --- 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 `.md` entra 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.