Conceitos fundamentais
Entenda a arquitetura e a terminologia principal do Verdent
Verdent for VS Code traz precisão e controle ao desenvolvimento com IA. As ferramentas tradicionais de codificação com IA adivinham sua intenção. O Verdent permite que você veja exatamente o que a IA fará antes de executar, verifique se funciona corretamente e entregue código confiável sempre.
Planeje primeiro, verifique cedo, entregue código confiável
O fluxo de trabalho do Verdent é construído em torno de três fases principais:
- Plan - Antes de qualquer execução, converse com a IA em um ciclo de esclarecimento. Você pode personalizar seu comportamento com regras de planejamento e usar planejamento interativo de arquitetura, diagramas visuais e divisão de tarefas para deixar seus requisitos cristalinos
- Code - Revise as mudanças com a análise de nível empresarial do Code Diff e entregue resultados prontos para produção com confiança
- Verify - Garantia de qualidade com o subagente Verify e ações de navegador. Itere em ciclos de reparo multipass até que o código passe por uma validação abrangente
Entender esses conceitos fundamentais e a arquitetura do Verdent ajudará você a trabalhar de forma mais eficaz com a extensão.
Saiba mais: fluxo de trabalho Plan-Code-Verify
Visão geral da arquitetura
Tarefas complexas são divididas e delegadas a agentes de IA especializados, otimizados para propósitos específicos. Cada subagente opera com seu próprio system prompt personalizado e uma janela de contexto separada, isolada do agente principal que o invocou.
Essa separação mantém o desempenho máximo e evita a poluição de contexto, permitindo que cada subagente se concentre em sua tarefa especializada sem sobrecarregar o agente principal com cada detalhe de implementação.
Subagentes padrão integrados:
O Verdent inclui três subagentes padrão disponíveis imediatamente:
| Subagente | Propósito | Quando é usado |
|---|---|---|
| @Verifier | Verificações e validação rápidas de código | Durante tarefas de codificação para garantir qualidade e correção do código |
| @Explorer | Exploração rápida da base de código | Encontrar arquivos e responder perguntas sobre a estrutura da sua base de código |
| @Code-reviewer | Avaliação instantânea da qualidade do código | Varredura proativa de problemas de segurança, manutenibilidade e desempenho |
Subagentes personalizados:
Você pode criar subagentes personalizados adaptados às suas necessidades específicas. Cada subagente personalizado opera com seu próprio system prompt, permitindo que você defina comportamentos especializados para tarefas ou fluxos de trabalho específicos.
Subagentes personalizados podem ser invocados automaticamente com base em padrões de tarefa ou manualmente usando @-menções. Casos de uso comuns incluem:
- Especialistas em pilha tecnológica - Otimizador de desempenho do React, otimizador de consultas SQL, revisor de configuração do Docker
- Garantia de qualidade - Analisador de cobertura de testes, revisor de tratamento de erros, fiscalizador de padrões de logging
- Fluxos de trabalho específicos da equipe - Fiscalizador de estilo de código, verificador de consistência de documentação, auditor de dependências
- Necessidades específicas do projeto - Modernizador de código legado, assistente de migração, fiscalizador de orçamento de desempenho
Saiba mais: Gerenciamento de subagentes
Modos de execução
O Verdent oferece suporte a vários modos de execução que controlam como a IA lida com permissões e interações:
Modos de permissão:
- Manual Accept Mode - Solicita permissão no primeiro uso de cada ferramenta. Ideal para aprendizado e desenvolvimento geral com controle máximo.
- Auto-Run Mode (padrão) - Aceita automaticamente permissões para operações seguras (leituras de arquivos, buscas na web). Edições de arquivos e execução de comandos ainda exigem aprovação. Ideal para projetos confiáveis e prototipagem rápida.
- Skip Permissions Mode - Operação totalmente autônoma que ignora todas as solicitações. Apenas para ambientes isolados e seguros, como testes automatizados ou sandboxes.
Para alternar entre os modos de permissão, clique no botão Switch Permission na caixa de entrada (que mostra o modo atual, como "Manual" ou "Auto") e selecione o modo desejado no menu suspenso.
Switch Mode (controla o estilo de interação):
- Agent Mode - Comportamento totalmente agêntico, com execução autônoma de tarefas e operações de arquivos
- Plan Mode - Interação focada no planejamento, para revisar abordagens antes da execução
- Chat Mode - Interação conversacional sem operações autônomas de arquivos
Para alternar entre os estilos de interação, clique no botão Switch Mode na caixa de entrada (que mostra o modo atual, como "Agent" ou "Plan") e selecione o modo desejado no menu suspenso.
Modos adicionais:
- Think Hard Mode - Aloca o máximo de recursos computacionais para analisar problemas em profundidade, explorar múltiplas abordagens e fornecer soluções mais completas. Ideal para decisões arquiteturais, depuração complexa e tarefas que exigem raciocínio sofisticado.
Para ativar o Think Hard Mode, clique no botão Think Hard na caixa de entrada antes de enviar sua solicitação.
Saiba mais: Visão geral dos modos de execução
Gerenciamento de contexto
O gerenciamento de contexto controla a quais informações o Verdent tem acesso durante sua sessão. A janela de contexto é o limite de memória do agente, medido em tokens e compartilhado entre vários componentes: instruções do sistema, conteúdos de arquivos, mensagens da conversa e respostas do agente.
Como o contexto funciona:
- @-menções - Adicione arquivos explicitamente ao contexto usando
@filename.jspara controle preciso - Carregamento automático - O Verdent inclui automaticamente arquivos relevantes com base na tarefa
- Contexto separado de subagentes - Cada subagente opera com janelas de contexto isoladas, evitando a poluição da memória do agente principal
- Limites da janela de contexto - Contexto finito medido em tokens. À medida que as conversas crescem, o espaço disponível diminui e o desempenho do modelo se degrada
Melhores práticas:
- Divida tarefas grandes em partes menores com pontos de quebra naturais
- Use o Plan Mode para tarefas complexas para revisar abordagens antes da execução
- Conclua componentes individuais antes da integração para evitar esgotamento do contexto
- Inicie uma nova conversa ao começar uma nova tarefa para limpar o contexto e manter o desempenho ideal
Saiba mais: Melhores práticas de gerenciamento de contexto
Seleção de modelo
O Verdent orquestra modelos de vários provedores de IA (Claude, GPT-5, Gemini, MiniMax) dentro de um único fluxo de trabalho. Cada agente especializado pode aproveitar o modelo ideal para sua tarefa específica.
Modelos predefinidos:
- Performance - Contexto máximo, modelos de fronteira (1-2x de uso de créditos)
- Balance - Combinação ideal de desempenho e custo (1x de uso de créditos)
- Efficiency - Tarefas rápidas, responsivas e econômicas (~0,3x de uso de créditos)
Modelos individuais disponíveis:
| Provedor | Modelo | Melhor para | Eficiência de custo |
|---|---|---|---|
| Anthropic | Claude 4.5 Opus | Ótimo para tarefas de codificação profunda e resolução de problemas. | Custo 1,5x |
| Anthropic | Claude 4.5 Sonnet | Tarefas complexas equilibradas | 1x referência |
| Anthropic | Claude 4.5 Sonnet 1M | Tarefas longas ou complexas (>200k de entrada) | Eficiência 0,5x (custo 2x) |
| Anthropic | Claude 4.5 Haiku | Tarefas rápidas e simples | 3,2x mais eficiente que o Sonnet |
| OpenAI | GPT-5 (Beta) | Raciocínio e criatividade | 1,3x mais eficiente que o Sonnet |
| OpenAI | GPT-5 Codex (Beta) | Codificação e depuração | 1,3x mais eficiente que o Sonnet |
| Gemini 3 Pro | Raciocínio avançado e multimodal | Variável | |
| Kimi | Kimi 2 Turbo (Beta) | Modelo ultrarrápido para codificação | 3,1x mais eficiente que o Sonnet |
Saiba mais: Definições de configuração
Perguntas frequentes
O que é poluição de contexto?
É quando ações e informações anteriores no contexto criam padrões de comportamento não intencionais que afetam tarefas futuras. Por exemplo, se você repetidamente atualiza o código e depois o implanta, o agente pode começar a associar todas as atualizações de código a uma implantação imediata, mesmo quando você está apenas experimentando. Os subagentes evitam a poluição de contexto operando com janelas de contexto isoladas, permitindo que cada tarefa especializada comece com um contexto limpo e evitando a contaminação cruzada entre diferentes tipos de trabalho.
O que são operações seguras?
Operações que apenas leem dados sem fazer alterações: leituras de arquivos e buscas na web. Elas são aprovadas automaticamente no Auto-Run Mode, enquanto edições de arquivos e execução de comandos ainda exigem aprovação por segurança.
O que é execução de comandos?
Execução de comandos de terminal ou scripts de shell por meio do Verdent, incluindo operações como executar testes, instalar pacotes ou rodar comandos de build. A execução de comandos exige aprovação na maioria dos modos de permissão para evitar alterações não intencionais no sistema.
O que é um token?
A unidade de medida das janelas de contexto. Os tokens representam pedaços de texto (palavras, partes de palavras ou caracteres) que o modelo de IA processa. Os limites de contexto são medidos em tokens, e não em caracteres ou palavras, com conversas típicas consumindo milhares de tokens.
O que são créditos?
A moeda de uso do Verdent. Diferentes modelos têm diferentes eficiências de custo (por exemplo, o Haiku é 3,2x mais eficiente que a referência do Sonnet, o Sonnet é 1x de referência). Sua assinatura inclui uma cota mensal de créditos (por exemplo, 640 créditos para o Starter, 2.000 para o Pro, 6.000 para o Max).
O que é o ciclo Multipass de geração-teste-reparo?
Um processo de verificação iterativo em que o código é gerado, testado e reparado até passar por testes abrangentes. O Verdent executa testes automaticamente, analisa falhas, corrige problemas e retesta em múltiplas passagens até que o código funcione corretamente. Isso entrega código pronto para produção, não apenas sugestões. Cada resultado inclui resumos detalhados e diffs de código que mostram exatamente o que mudou.