Funzionalità avanzate
Funzionalità complesse e coordinamento multi-agente
Cosa imparerai
Questa sezione illustra le funzionalità per utenti esperti di Verdent, tra cui la gestione dei sottoagenti, i sistemi di regole, l'integrazione di strumenti personalizzati e le opzioni avanzate di estensibilità.
Spiegazione delle funzionalità complesse
Verdent for VS Code offre funzionalità sofisticate che abilitano flussi di lavoro di sviluppo avanzati, andando oltre la semplice generazione di codice.
Sistema di sottoagenti
Agenti AI specializzati:
Verdent include sottoagenti integrati (@Verifier, @Explorer, @Code-reviewer) che operano con finestre di contesto isolate e prompt di sistema personalizzati. Ogni sottoagente si specializza in attività specifiche come l'esplorazione del codice, la validazione o la revisione della qualità.
Delega automatica e manuale: L'agente principale instrada automaticamente le attività ai sottoagenti appropriati in base ai pattern delle richieste, oppure puoi specificare manualmente i sottoagenti tramite @-mention. Questa delega preserva il contesto principale gestendo al contempo le operazioni specializzate in modo efficiente.
Sottoagenti personalizzati:
Crea sottoagenti specifici per il progetto definendo file markdown con frontmatter YAML in ~/.verdent/subagents/. I sottoagenti personalizzati possono specializzarsi in competenze di dominio, flussi di lavoro di team od ottimizzazioni specifiche per una tecnologia.
Scopri di più sulla gestione dei sottoagenti
Sistemi di regole
Personalizzazione del comportamento: I file di regole guidano il comportamento di Verdent, la formattazione dell'output e il processo decisionale tramite semplici documenti Markdown. Tre tipi di regole controllano ambiti differenti:
- VERDENT.md - Preferenze personali globali per tutti i progetti
- AGENTS.md - Standard di team specifici del progetto (sotto controllo di versione)
- plan_rules.md - Personalizzazione del formato di output di Plan Mode
Precedenza delle regole:
In caso di conflitto, le regole del progetto (AGENTS.md) hanno la precedenza sulle regole utente, garantendo la coerenza del team pur preservando le preferenze personali nei progetti individuali.
Scopri di più sui sistemi di regole
Sistema di strumenti e MCP
Strumenti integrati:
Verdent offre strumenti completi per le operazioni sui file, la ricerca (glob/grep), l'esecuzione di comandi (bash), l'accesso al web e la delega agli agenti. Gli strumenti abilitano tutta la manipolazione del codice, la navigazione e l'interazione esterna.
Model Context Protocol (MCP): MCP estende le capacità di Verdent connettendosi a strumenti, fonti di dati e servizi esterni. Configura i server MCP tramite Settings → MCP Servers per integrare API specifici del progetto e funzionalità personalizzate.
Consulta il riferimento degli strumenti Scopri di più sull'integrazione con MCP
Coordinamento multi-agente
L'architettura multi-sottoagente di Verdent abilita l'esecuzione parallela delle attività con instradamento e coordinamento automatici.
Agente principale (orchestratore): L'agente primario analizza le richieste, scompone le attività complesse e delega il lavoro specializzato ai sottoagenti, mantenendo al contempo il contesto della conversazione e consolidando i risultati.
Esecuzione parallela: Più sottoagenti vengono eseguiti contemporaneamente per le operazioni complesse. Esempio: il sottoagente Explorer cerca nel codebase mentre Code-reviewer analizza la sicurezza simultaneamente, fornendo risultati più rapidi.
Isolamento del contesto: Ogni sottoagente opera con la propria finestra di contesto. Solo i risultati finali occupano spazio nel contesto dell'agente principale, evitandone l'esaurimento durante le operazioni in più passaggi.
Instradamento delle attività: Il rilevamento automatico instrada le attività in base ai pattern:
- Domande sul codebase → sottoagente
@Explorer - Revisioni di sicurezza → sottoagente
@Code-reviewer - Controlli di validazione → sottoagente
@Verifier
Creazione di flussi di lavoro personalizzati
Gli utenti esperti possono personalizzare il comportamento di Verdent per adattarlo ai processi del team e ai requisiti del progetto.
Flussi di lavoro con sottoagenti personalizzati: Crea sottoagenti specializzati per esigenze specifiche di dominio:
- Generatori di documentazione API - Estraggono endpoint e parametri dal codice
- Revisori di migrazioni di database - Validano le modifiche allo schema per garantirne la sicurezza
- Auditor di accessibilità - Verificano la conformità del codice frontend alle linee guida WCAG
Personalizzazione basata su regole: Definisci standard di codifica, requisiti di test e preferenze di output tramite file di regole:
- Imponi le convenzioni del team (indentazione, denominazione, pattern)
- Specifica gli stili di documentazione e i livelli di dettaglio dei commenti
- Controlla la struttura e la granularità dell'output di Plan Mode
Estensibilità tramite MCP: Integra strumenti e servizi esterni:
- Strumenti di query sui database
- API di servizi cloud (AWS, Azure, GCP)
- Integrazioni di project management (Jira, Linear)
- Connessioni a pipeline CI/CD
Scopri di più sui sottoagenti personalizzati Esplora le opzioni di estensibilità
Tecniche avanzate di gestione del contesto
Una gestione efficiente del contesto è fondamentale per i progetti complessi e le lunghe sessioni di codifica.
Lettura strategica dei file:
Usa file_read con intervalli di righe per i file di grandi dimensioni, così da evitare il sovraccarico del contesto. Leggi solo le sezioni necessarie all'attività invece dei file interi.
Delega ai sottoagenti per la ricerca:
Delega le attività esplorative al sottoagente @Explorer per mantenere pulito il contesto della conversazione principale. I risultati di ricerca del sottoagente occupano uno spazio minimo nel contesto principale.
Cerca prima di leggere:
Usa grep_file per identificare i file rilevanti prima di leggerne l'intero contenuto. Combina i pattern glob con grep_content per ricerche precise che riducono al minimo le operazioni sui file superflue.
Selezione degli strumenti in base al contesto:
- Codebase di grandi dimensioni: sottoagente
@Explorerper comprendere l'architettura - Validazione isolata: sottoagente
@Verifierper controlli rapidi - Revisioni di sicurezza: sottoagente
@Code-reviewerper la valutazione della qualità
Monitoraggio dell'uso del contesto: Tieni traccia di quali sottoagenti sono in esecuzione tramite gli indicatori della Chat View. Le operazioni dei sottoagenti compaiono nella cronologia della conversazione con indicatori di avanzamento e attribuzione dei risultati.