Recursos avançados
Recursos complexos e coordenação entre múltiplos agentes
O que você vai aprender
Esta seção aborda os recursos para usuários avançados do Verdent, incluindo gerenciamento de subagentes, sistemas de regras, integração de ferramentas personalizadas e opções avançadas de extensibilidade.
Explicações de recursos complexos
O Verdent for VS Code oferece recursos sofisticados que viabilizam fluxos de trabalho de desenvolvimento avançados além da geração básica de código.
Sistema de subagentes
Agentes de IA especializados:
O Verdent inclui subagentes integrados (@Verifier, @Explorer, @Code-reviewer) que operam com janelas de contexto isoladas e prompts de sistema personalizados. Cada subagente é especializado em tarefas específicas, como exploração de código, validação ou revisão de qualidade.
Delegação automática e manual: O agente principal roteia tarefas automaticamente para os subagentes apropriados com base em padrões da solicitação, ou os usuários podem especificar subagentes manualmente usando menções com @. Essa delegação preserva o contexto principal enquanto lida com operações especializadas de forma eficiente.
Subagentes personalizados:
Crie subagentes específicos do projeto definindo arquivos markdown com frontmatter YAML em ~/.verdent/subagents/. Subagentes personalizados podem se especializar em conhecimento de domínio, fluxos de trabalho da equipe ou otimizações específicas de tecnologia.
Saiba mais sobre o gerenciamento de subagentes
Sistemas de regras
Personalização de comportamento: Arquivos de regras orientam o comportamento, a formatação de saída e a tomada de decisão do Verdent por meio de documentos em Markdown puro. Três tipos de regras controlam escopos diferentes:
- VERDENT.md - Preferências pessoais globais em todos os projetos
- AGENTS.md - Padrões da equipe específicos do projeto (versionados)
- plan_rules.md - Personalização do formato de saída do Plan Mode
Precedência de regras:
Quando há conflitos, as regras do projeto (AGENTS.md) substituem as regras do usuário, garantindo consistência na equipe e preservando as preferências pessoais em projetos individuais.
Saiba mais sobre sistemas de regras
Sistema de ferramentas e MCP
Ferramentas integradas:
O Verdent oferece ferramentas abrangentes para operações com arquivos, busca (glob/grep), execução de comandos (bash), acesso à web e delegação a agentes. As ferramentas viabilizam toda a manipulação de código, navegação e interação externa.
Model Context Protocol (MCP): O MCP amplia as capacidades do Verdent conectando-se a ferramentas, fontes de dados e serviços externos. Configure servidores MCP em Settings → MCP Servers para integrar APIs específicos do projeto e funcionalidades personalizadas.
Ver referência de ferramentas Saiba mais sobre integração com MCP
Coordenação entre múltiplos agentes
A arquitetura de múltiplos subagentes do Verdent viabiliza a execução paralela de tarefas com roteamento e coordenação automáticos.
Agente principal (orquestrador): O agente principal analisa solicitações, divide tarefas complexas e delega trabalhos especializados aos subagentes, mantendo o contexto da conversa e consolidando os resultados.
Execução paralela: Vários subagentes são executados simultaneamente em operações complexas. Exemplo: o subagente Explorer busca na base de código enquanto o Code-reviewer analisa a segurança ao mesmo tempo, entregando resultados mais rápidos.
Isolamento de contexto: Cada subagente opera com sua própria janela de contexto. Apenas os resultados finais consomem espaço no contexto do agente principal, evitando o esgotamento durante operações de múltiplas etapas.
Roteamento de tarefas: A detecção automática roteia tarefas com base em padrões:
- Perguntas sobre a base de código → subagente
@Explorer - Revisões de segurança → subagente
@Code-reviewer - Verificações de validação → subagente
@Verifier
Criação de fluxos de trabalho personalizados
Usuários avançados podem personalizar o comportamento do Verdent para se adequar aos processos da equipe e aos requisitos do projeto.
Fluxos de trabalho com subagentes personalizados: Crie subagentes especializados para necessidades específicas de domínio:
- Geradores de documentação de API - Extraem endpoints e parâmetros do código
- Revisores de migração de banco de dados - Validam mudanças de esquema quanto à segurança
- Auditores de acessibilidade - Verificam o código de frontend quanto à conformidade com WCAG
Personalização baseada em regras: Defina padrões de codificação, requisitos de testes e preferências de saída por meio de arquivos de regras:
- Imponha convenções da equipe (indentação, nomenclatura, padrões)
- Especifique estilos de documentação e níveis de detalhe dos comentários
- Controle a estrutura e a granularidade da saída do Plan Mode
Extensibilidade por meio do MCP: Integre ferramentas e serviços externos:
- Ferramentas de consulta a banco de dados
- APIs de serviços de nuvem (AWS, Azure, GCP)
- Integrações de gerenciamento de projetos (Jira, Linear)
- Conexões com pipelines de CI/CD
Saiba mais sobre subagentes personalizados Explore opções de extensibilidade
Técnicas avançadas de gerenciamento de contexto
O gerenciamento eficiente de contexto é fundamental para projetos complexos e sessões longas de codificação.
Leitura estratégica de arquivos:
Use file_read com intervalos de linhas em arquivos grandes para evitar sobrecarga de contexto. Leia apenas as seções necessárias para a tarefa, em vez de arquivos inteiros.
Delegação a subagentes para pesquisa:
Delegue tarefas exploratórias ao subagente @Explorer para manter o contexto da conversa principal limpo. Os resultados de pesquisa do subagente consomem espaço mínimo no contexto principal.
Busque antes de ler:
Use grep_file para identificar arquivos relevantes antes de ler o conteúdo completo. Combine padrões glob com grep_content para buscas precisas que minimizam operações desnecessárias com arquivos.
Seleção de ferramentas ciente do contexto:
- Bases de código grandes: subagente
@Explorerpara compreensão da arquitetura - Validação isolada: subagente
@Verifierpara verificações rápidas - Revisões de segurança: subagente
@Code-reviewerpara avaliação de qualidade
Monitoramento do uso de contexto: Acompanhe quais subagentes estão em execução por meio dos indicadores da Chat View. As operações de subagentes aparecem no histórico da conversa com indicadores de progresso e atribuição de resultados.