Verdent Docs
Configurazione

Ottimizzazione della configurazione

Ottimizzare Verdent per il tuo flusso di lavoro

Ottimizza Verdent for VS Code per bilanciare velocità, costo e accuratezza in base alle esigenze del tuo flusso di lavoro. Configura i preset dei modelli, le modalità di esecuzione e le strategie di gestione del contesto per prestazioni ottimali.

Aree di ottimizzazione

  • Selezione del preset del modello per bilanciare costo e prestazioni
  • Configurazione della modalità di esecuzione per l'efficienza del flusso di lavoro
  • Gestione del contesto per basi di codice di grandi dimensioni
  • Personalizzazione a livello di progetto e di workspace

Regolare le impostazioni per il tuo flusso di lavoro

Selezione del preset del modello

Scegli il preset del modello più adatto in base alla complessità dell'attività e al budget:

PresetCostoEfficienza dei costiIdeale per
Efficiency~0,3x Balance (riduzione del 70%)3,2x più efficiente di SonnetAttività semplici, correzioni rapide, prototipazione veloce
Balance (predefinito)1x baseline1x baselineAttività di sviluppo generali, coding quotidiano
Performance1-2x BalanceEfficienza 0,5x (costo 2x, contesto 1M)Decisioni architetturali complesse, refactoring intricati

Modelli aggiuntivi:

  • Claude-4.5-sonnet: modello generico bilanciato (1x baseline)
  • Claude-4.5-sonnet-1m: contesto esteso per attività complesse (efficienza 0,5x, costo 2x quando l'input supera i 200k token)
  • Claude-4.5-haiku: il più veloce ed economico (3,2x più efficiente di Sonnet)
  • GPT-5 / GPT-5-codex: focus su ragionamento e creatività (Beta, 1,3x più efficiente di Sonnet)
  • Minimax-m2: veloce ed economico (Beta, gratuito fino al 10 novembre)

Configurazione della modalità di esecuzione

  • Piena autonomia senza richieste di approvazione
  • Nessuna interruzione per i permessi
  • Rischio massimo: usala solo in ambienti automatizzati
  • I comandi richiedono approvazione, le operazioni sui file sono automatiche
  • Meno richieste di permesso
  • Rischio inferiore, mantenendo la sicurezza per le operazioni pericolose
  • Ogni operazione richiede approvazione
  • Visibilità e controllo completi
  • La più lenta ma la più sicura: ideale per l'apprendimento e il codice di produzione
  • Pianificazione strategica prima dell'esecuzione
  • Fase di analisi in sola lettura
  • Rivedi e approva prima di qualsiasi modifica

Think Hard Mode

Attivala per attività di ragionamento complesse:

  • Accuratezza: massima profondità di ragionamento per problemi sofisticati
  • Velocità: più lenta a causa del budget di ragionamento esteso
  • Ideale per: decisioni architetturali, debug complesso, analisi intricate

Compromessi tra velocità e accuratezza

Bilancia la velocità di esecuzione con la profondità di analisi in base alle esigenze dell'attività.

Configurazione:

  • Modello: preset Efficiency (Claude-4.5-haiku)
  • Modalità permessi: Auto-Run Mode
  • Modalità di esecuzione: Agent Mode per l'esecuzione diretta
  • Casi d'uso: correzioni rapide, operazioni di routine, attività semplici

Vantaggi:

  • Tempi di risposta più rapidi
  • Interruzioni minime
  • Riduzione dei costi del 70% rispetto al preset Balance

Configurazione:

  • Modello: preset Performance (Claude-4.5-sonnet-1m)
  • Modalità permessi: Manual Accept Mode
  • Modalità di esecuzione: Plan Mode per la revisione strategica
  • Think Hard: attivo per un ragionamento sofisticato
  • Casi d'uso: funzionalità complesse, codice di produzione, decisioni architetturali

Vantaggi:

  • Finestra di contesto massima (1M token)
  • Visibilità e controllo completi
  • Ragionamento approfondito per problemi complessi
  • Revisione prima dell'esecuzione

La maggior parte degli utenti trae vantaggio dal passare da una configurazione all'altra a seconda del contesto:

  • Correzioni rapide: Efficiency + Agent Mode
  • Funzionalità complesse: Balance/Performance + Plan Mode
  • Esplorazione: Plan Mode per la strategia, poi Agent Mode per l'esecuzione

Strategia: adatta la configurazione al tipo di attività invece di usare un approccio universale.

Usa Auto-Run Mode per i progetti affidabili così da ridurre le richieste di permesso mantenendo la sicurezza per le operazioni pericolose. Questo snellisce il flusso di lavoro senza sacrificare le protezioni critiche.


Configurazione a livello di workspace

Verdent supporta la configurazione per progetto e per workspace per garantire coerenza a livello di team.

Configurazione specifica del progetto

Regole del progetto (AGENTS.md):

  • Posizione: directory root del progetto o cartella del workspace
  • Ambito: applicata solo al progetto corrente
  • Controllo di versione: effettua il commit in git per standard condivisi dal team
  • Contenuto: standard di codifica, requisiti di test, pattern architetturali

Esempio:

# Project Rules

## Code Standards
- Use TypeScript strict mode
- Generate unit tests for all new functions
- Follow MVC pattern

## Testing
- All endpoints require input validation
- Run tests before committing

Impostazioni del workspace di VS Code

Configura le impostazioni dell'estensione a livello di workspace:

Posizione: .vscode/settings.json nella root del workspace

Esempio:

{
  "verdent.enableCheckpoints": true
}

Priorità di configurazione

In caso di conflitto tra configurazioni, Verdent applica questo ordine di priorità:

  1. Regole del progetto (AGENTS.md) - priorità massima (specifiche del progetto)
  2. Impostazioni del workspace - impostazioni a livello di workspace di VS Code
  3. Regole utente (VERDENT.md) - preferenze utente globali
  4. Impostazioni predefinite - impostazioni predefinite integrate di Verdent

Personalizzazione specifica del progetto

Gestione del contesto per progetti di grandi dimensioni

  • Delega le operazioni complesse ai sottoagenti con finestre di contesto separate
  • Solo i risultati dei sottoagenti consumano il contesto principale, non l'intero processo
  • Evita che il contesto principale si riempia di dettagli implementativi
  • Aggiungi esplicitamente solo i file pertinenti usando @filename
  • Evita di caricare inutilmente l'intero progetto nel contesto
  • Concentra l'analisi su componenti specifici
  • Suddividi le attività di grandi dimensioni in blocchi più piccoli e completabili
  • Avvia nuove sessioni per funzionalità o componenti distinti
  • I punti di interruzione naturali prevengono l'esaurimento del contesto
  • Rivedi l'approccio prima di consumare contesto per l'esecuzione
  • Riduce lo spreco di contesto su implementazioni errate
  • Plan Mode ha una gestione del contesto separata

Ottimizzazione delle prestazioni

Attiva i checkpoint in modo selettivo:

L'impostazione verdent.enableCheckpoints usa git per il controllo di versione:

  • Può influire sulle prestazioni nei repository molto grandi
  • Attivala solo quando serve la funzionalità di checkpoint
  • Disattivala per ottenere le massime prestazioni su basi di codice di grandi dimensioni

Attiva i checkpoint in modo selettivo solo per le attività critiche: un checkpoint eccessivo rallenta i flussi di lavoro senza aggiungere valore.

Selezione del modello:

  • Usa il preset Efficiency (Haiku) per attività semplici e isolate
  • Riserva il preset Performance (Sonnet-1M) alle operazioni con molto contesto
  • Usa il preset Balance per il lavoro generale

Modalità di esecuzione:

  • Auto-Run Mode riduce il contesto consumato dalle richieste di permesso
  • Skip Permissions Mode massimizza l'efficienza per gli ambienti automatizzati

Gli scenari multi-workspace applicano automaticamente le regole di progetto appropriate quando si passa da un workspace all'altro. Non è richiesto alcun cambio di configurazione manuale.

Le configurazioni multi-workspace ti permettono di ottimizzare le impostazioni per tipo di progetto, sviluppo vs produzione, monorepo vs microservizi.


Vedi anche