Concetti fondamentali
Comprendere l'architettura e la terminologia chiave di Verdent
Verdent for VS Code porta precisione e controllo allo sviluppo assistito dall'AI. Gli strumenti di coding AI tradizionali indovinano le tue intenzioni. Verdent ti permette di vedere esattamente cosa farà l'AI prima che venga eseguito, verificare che funzioni correttamente e consegnare codice affidabile ogni volta.
Pianifica prima, verifica presto, consegna codice affidabile
Il flusso di lavoro di Verdent è costruito attorno a tre fasi fondamentali:
- Plan - Prima che venga eseguito qualcosa, discuti con l'AI attraverso un ciclo di chiarimento. Puoi personalizzarne il comportamento con le regole di pianificazione e usare la pianificazione interattiva dell'architettura, i diagrammi visivi e la suddivisione delle attività per rendere i tuoi requisiti perfettamente chiari
- Code - Rivedi le modifiche con l'analisi di livello enterprise di Code Diff e consegna risultati pronti per la produzione con sicurezza
- Verify - Garanzia di qualità con il sottoagente Verify e le azioni sul browser. Itera attraverso cicli di riparazione multipass finché il codice non supera una validazione completa
Comprendere questi concetti fondamentali e l'architettura di Verdent ti aiuterà a lavorare in modo più efficace con l'estensione.
Scopri di più: flusso di lavoro Plan-Code-Verify
Panoramica dell'architettura
Le attività complesse vengono suddivise e delegate ad agenti AI specializzati ottimizzati per scopi specifici. Ogni sottoagente opera con il proprio prompt di sistema personalizzato e una finestra di contesto separata, isolata dall'agente principale che lo ha invocato.
Questa separazione mantiene le prestazioni al massimo e previene l'inquinamento del contesto, permettendo a ciascun sottoagente di concentrarsi sulla propria attività specializzata senza gravare sull'agente principale con ogni dettaglio implementativo.
Sottoagenti predefiniti integrati:
Verdent include tre sottoagenti predefiniti immediatamente disponibili:
| Sottoagente | Scopo | Quando viene usato |
|---|---|---|
| @Verifier | Controlli e validazione rapidi del codice | Durante le attività di coding per garantire qualità e correttezza del codice |
| @Explorer | Esplorazione rapida del codebase | Trovare file e rispondere a domande sulla struttura del tuo codebase |
| @Code-reviewer | Valutazione istantanea della qualità del codice | Scansione proattiva per sicurezza, manutenibilità e problemi di prestazioni |
Sottoagenti personalizzati:
Puoi creare sottoagenti personalizzati adatti alle tue esigenze specifiche. Ogni sottoagente personalizzato opera con il proprio prompt di sistema, permettendoti di definire comportamenti specializzati per attività o flussi di lavoro particolari.
I sottoagenti personalizzati possono essere invocati automaticamente in base a pattern delle attività o manualmente usando le @-menzioni. I casi d'uso comuni includono:
- Specialisti dello stack tecnologico - Ottimizzatore delle prestazioni di React, ottimizzatore di query SQL, revisore della configurazione Docker
- Garanzia di qualità - Analizzatore della copertura dei test, revisore della gestione degli errori, controllore degli standard di logging
- Flussi di lavoro specifici del team - Controllore dello stile del codice, verificatore della coerenza della documentazione, revisore delle dipendenze
- Esigenze specifiche del progetto - Modernizzatore di codice legacy, assistente alla migrazione, controllore del budget di prestazioni
Scopri di più: Gestione dei sottoagenti
Modalità di esecuzione
Verdent supporta più modalità di esecuzione che controllano come l'AI gestisce i permessi e le interazioni:
Modalità di permesso:
- Manual Accept Mode - Richiede il permesso al primo utilizzo di ogni strumento. Ideale per l'apprendimento e lo sviluppo generale con il massimo controllo.
- Auto-Run Mode (predefinita) - Accetta automaticamente i permessi per le operazioni sicure (letture di file, ricerche web). Le modifiche ai file e l'esecuzione di comandi richiedono ancora l'approvazione. Ideale per progetti affidabili e prototipazione rapida.
- Skip Permissions Mode - Operazione completamente autonoma che ignora tutti i prompt. Solo per ambienti isolati e sicuri come test automatizzati o sandbox.
Per passare da una modalità di permesso all'altra, seleziona il pulsante Switch Permission nella casella di input (mostra la modalità corrente come "Manual" o "Auto") e scegli la modalità desiderata dal menu a discesa.
Switch Mode (controlla lo stile di interazione):
- Agent Mode - Comportamento agentico completo con esecuzione autonoma delle attività e operazioni sui file
- Plan Mode - Interazione focalizzata sulla pianificazione per rivedere gli approcci prima dell'esecuzione
- Chat Mode - Interazione conversazionale senza operazioni autonome sui file
Per passare da uno stile di interazione all'altro, seleziona il pulsante Switch Mode nella casella di input (mostra la modalità corrente come "Agent" o "Plan") e scegli la modalità desiderata dal menu a discesa.
Modalità aggiuntive:
- Think Hard Mode - Alloca le massime risorse di calcolo per analizzare i problemi in profondità, esplorare più approcci e fornire soluzioni più accurate. Ideale per decisioni architetturali, debug complessi e attività che richiedono un ragionamento sofisticato.
Per attivare Think Hard Mode, seleziona il pulsante Think Hard nella casella di input prima di inviare la tua richiesta.
Scopri di più: Panoramica delle modalità di esecuzione
Gestione del contesto
La gestione del contesto controlla a quali informazioni Verdent ha accesso durante la tua sessione. La finestra di contesto è il limite di memoria dell'agente, misurato in token e condiviso tra diversi componenti: istruzioni di sistema, contenuti dei file, messaggi della conversazione e risposte dell'agente.
Come funziona il contesto:
- @-menzioni - Aggiungi esplicitamente file al contesto usando
@filename.jsper un controllo preciso - Caricamento automatico - Verdent include automaticamente i file pertinenti in base all'attività
- Contesto separato dei sottoagenti - Ogni sottoagente opera con finestre di contesto isolate, prevenendo l'inquinamento della memoria dell'agente principale
- Limiti della finestra di contesto - Contesto finito misurato in token. Man mano che le conversazioni crescono, lo spazio disponibile diminuisce e le prestazioni del modello degradano
Buone pratiche:
- Suddividi le attività grandi in blocchi più piccoli con punti di interruzione naturali
- Usa Plan Mode per le attività complesse per rivedere gli approcci prima dell'esecuzione
- Completa i singoli componenti prima dell'integrazione per evitare l'esaurimento del contesto
- Avvia una nuova conversazione quando inizi una nuova attività per svuotare il contesto e mantenere prestazioni ottimali
Scopri di più: Buone pratiche per la gestione del contesto
Selezione del modello
Verdent orchestra modelli di più provider AI (Claude, GPT-5, Gemini, MiniMax) all'interno di un unico flusso di lavoro. Ogni agente specializzato può sfruttare il modello ottimale per la sua attività specifica.
Modelli preimpostati:
- Performance - Contesto massimo, modelli di frontiera (utilizzo di crediti 1-2x)
- Balance - Miscela ottimale di prestazioni e costi (utilizzo di crediti 1x)
- Efficiency - Attività veloci, reattive ed economiche (utilizzo di crediti ~0,3x)
Modelli singoli disponibili:
| Provider | Modello | Ideale per | Efficienza di costo |
|---|---|---|---|
| Anthropic | Claude 4.5 Opus | Ottimo per attività di coding approfondite e problem-solving. | costo 1,5x |
| Anthropic | Claude 4.5 Sonnet | Attività complesse bilanciate | 1x baseline |
| Anthropic | Claude 4.5 Sonnet 1M | Attività lunghe o complesse (>200k input) | efficienza 0,5x (costo 2x) |
| Anthropic | Claude 4.5 Haiku | Attività veloci e semplici | 3,2x più efficiente di Sonnet |
| OpenAI | GPT-5 (Beta) | Ragionamento e creatività | 1,3x più efficiente di Sonnet |
| OpenAI | GPT-5 Codex (Beta) | Coding e debug | 1,3x più efficiente di Sonnet |
| Gemini 3 Pro | Ragionamento avanzato e multimodale | Variabile | |
| Kimi | Kimi 2 Turbo (Beta) | Modello fulmineo per il coding | 3,1x più efficiente di Sonnet |
Scopri di più: Impostazioni di configurazione
Domande frequenti
Cos'è l'inquinamento del contesto?
Quando azioni e informazioni precedenti nel contesto creano pattern comportamentali indesiderati che influenzano le attività future. Ad esempio, se aggiorni ripetutamente il codice e poi lo distribuisci, l'agente potrebbe iniziare ad associare tutti gli aggiornamenti del codice a una distribuzione immediata, anche quando stai solo sperimentando. I sottoagenti prevengono l'inquinamento del contesto operando con finestre di contesto isolate, permettendo a ciascuna attività specializzata di partire da un contesto pulito ed evitando la contaminazione incrociata tra diversi tipi di lavoro.
Cosa sono le operazioni sicure?
Operazioni che si limitano a leggere dati senza apportare modifiche: letture di file e ricerche web. Queste vengono approvate automaticamente in Auto-Run Mode, mentre le modifiche ai file e l'esecuzione di comandi richiedono comunque l'approvazione per sicurezza.
Cos'è l'esecuzione di comandi?
L'esecuzione di comandi da terminale o script della shell tramite Verdent, comprese operazioni come l'esecuzione di test, l'installazione di pacchetti o l'esecuzione di comandi di build. L'esecuzione di comandi richiede l'approvazione nella maggior parte delle modalità di permesso per prevenire modifiche indesiderate al sistema.
Cos'è un token?
L'unità di misura per le finestre di contesto. I token rappresentano pezzi di testo (parole, parti di parole o caratteri) che il modello AI elabora. I limiti del contesto sono misurati in token anziché in caratteri o parole, con le conversazioni tipiche che consumano migliaia di token.
Cosa sono i crediti?
La valuta d'uso di Verdent. Modelli diversi hanno un'efficienza di costo diversa (ad esempio, Haiku è 3,2x più efficiente del baseline Sonnet, Sonnet è baseline 1x). Il tuo abbonamento include un'assegnazione mensile di crediti (ad esempio, 640 crediti per Starter, 2.000 per Pro, 6.000 per Max).
Cos'è il ciclo Multipass Generate-Test-Repair?
Un processo di verifica iterativo in cui il codice viene generato, testato e riparato finché non supera test completi. Verdent esegue automaticamente i test, analizza i fallimenti, corregge i problemi e ritesta in più passaggi finché il codice non funziona correttamente. Questo fornisce codice pronto per la produzione, non solo suggerimenti. Ogni risultato include riepiloghi dettagliati e diff del codice che mostrano esattamente cosa è cambiato.