# Sottoagenti (/it/docs/verdent-manager/configuration/subagents) > Agenti esperti specializzati che l'agente principale può richiamare all'occorrenza Un sottoagente è un "esperto" specializzato che l'agente principale (Worker) può richiamare in qualsiasi momento durante l'esecuzione di un'attività. Ogni sottoagente ha la propria area di competenza, un prompt dedicato e può persino funzionare su un modello diverso. In chat basta digitare `@SubagentName` e si unisce per dare una mano, proprio come quando tagghi un collega in una chat di gruppo. *** ## Sottoagenti integrati [#sottoagenti-integrati] Verdent include 6 sottoagenti pronti all'uso, che coprono le esigenze più comuni nello sviluppo software: | Nome | Modello predefinito | In cosa è bravo | | ----------------------- | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | **General** | Segue l'agente principale | Un agente di ricerca generico per problemi complessi, ricerca nel codice e attività a più passaggi: può aiutare praticamente in qualsiasi cosa | | **Fast Context** | Gemini 3 Flash | Individua rapidamente il codice e raccoglie prove contestuali; è specializzato nell'indicizzazione del codebase ed è estremamente veloce | | **Verifier** | Sonnet 4.6 | Revisione del codice rapida: dopo aver apportato modifiche, tagga per individuare problemi evidenti | | **Verdent Helper** | Haiku 4.5 | Un assistente per l'uso di Verdent; chiedigli qualsiasi cosa sul funzionamento di Verdent | | **Multi-Model Planner** | Gemini 3.1 Pro; Opus 4.6; GPT-5.4 | Genera piani usando più modelli (Claude, GPT, Gemini) e unisce i loro output | | **Reviewer** | Gemini 3.1 Pro; Opus 4.6; GPT-5.4 | Revisione del codice completa: errori logici, casi limite, rischi nascosti | Due sottoagenti sono speciali: **Multi-Model Planner** e **Reviewer** eseguono 2-3 modelli in parallelo. Ogni modello ragiona in modo indipendente, produce il proprio output e i risultati vengono poi combinati. Tutti gli altri sottoagenti sono a modello singolo. *** ## Come usare i sottoagenti [#come-usare-i-sottoagenti] In qualsiasi conversazione, digita `@` per aprire il menu di selezione dei sottoagenti (con supporto per la ricerca fuzzy). Seleziona il sottoagente desiderato e prenderà in carico il contesto corrente. **Esempi:** * Dopo aver scritto una logica di autenticazione complessa: `@Reviewer please review this` → Reviewer la controlla dal punto di vista della sicurezza, della logica e dei casi limite. * Per una decisione architetturale complicata: `@Multi-Model Planner` → più modelli propongono soluzioni e tu scegli la migliore. * Dopo aver scritto codice, esegui rapidamente `@Verifier` → più veloce dell'esecuzione di suite di test complete per una validazione di base. *** ## Sottoagenti personalizzati [#sottoagenti-personalizzati] I sottoagenti integrati coprono la maggior parte delle esigenze, ma a volte serve uno specialista adatto al tuo progetto. Puoi crearne uno tuo. ### Dove archiviarli [#dove-archiviarli] I sottoagenti personalizzati vengono archiviati come file Markdown in: ``` ~/.verdent/subagents/ ``` Per l'organizzazione sono supportati fino a 5 livelli di sottocartelle. ### Formato del file [#formato-del-file] Ogni sottoagente è un file Markdown con frontmatter YAML: ```markdown --- name: SQL-Expert description: Specializes in SQL optimization and database design, good at analyzing slow queries and indexing strategies color: blue model: claude-sonnet-4-6 --- You are a senior database expert focused on PostgreSQL performance optimization. When users provide SQL queries, you should: 1. Analyze the query execution plan 2. Identify performance bottlenecks (full table scans, missing indexes, etc.) 3. Provide concrete optimization suggestions and rewritten SQL ... ``` ### Dettagli chiave [#dettagli-chiave] * **Nome:** deve contenere solo lettere, numeri e trattini (ad es. `SQL-Expert`, `MyAgent123`). Niente spazi o caratteri non ASCII. * **Colore:** uno tra `dark-green`, `light-green`, `red-orange`, `amber`, `cyan`, `blue`, `pink`, `purple`, `verdent`, per un riconoscimento visivo più facile. * **Ricaricamento a caldo:** salvare il file `.md` ha effetto immediato, senza bisogno di riavviare Verdent. *** ## Gestire i sottoagenti nelle impostazioni [#gestire-i-sottoagenti-nelle-impostazioni] Tutta la gestione dei sottoagenti avviene in **Settings → Subagents**. | Azione | Descrizione | | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | **Visualizza elenco** | Tutti i sottoagenti sono mostrati come schede. Quelli integrati sono etichettati come "Built-in"; quelli basati su plugin mostrano i nomi dei plugin. | | **Abilita / Disabilita** | Attiva o disattiva ciascun sottoagente senza influire sugli altri. | | **Crea nuovo** | Seleziona **Add Subagent** e compila Identifier (nome univoco), Model, Description e Prompt. | | **Modifica** | Passa il mouse su una scheda per modificarla. I sottoagenti integrati consentono di modificare solo Model e Description. | | **Duplica** | Copia qualsiasi sottoagente personalizzato (i duplicati sono disabilitati per impostazione predefinita finché non vengono abilitati). | | **Elimina** | I sottoagenti personalizzati possono essere rimossi (con conferma). Quelli integrati non possono essere eliminati. | ### Differenze nella selezione del modello [#differenze-nella-selezione-del-modello] * **Multi-Model Planner** e **Reviewer** supportano la selezione multi-modello (2-3 modelli contemporaneamente). * Gli altri sottoagenti usano la selezione a modello singolo. * **General** ha un'opzione speciale: può seguire automaticamente il modello dell'agente principale, evitando di dover mantenere una configurazione separata. *** ## Casi d'uso [#casi-duso] ### Revisione del codice [#revisione-del-codice] Dopo aver implementato una logica complessa, tagga `@Reviewer`. Controlla la correttezza, i casi limite e i potenziali bug, risparmiandoti l'ispezione manuale riga per riga. ### Progettazione architetturale multi-prospettiva [#progettazione-architetturale-multi-prospettiva] Per decisioni importanti (ad es. l'adozione di microservizi, la scelta del database), usa `@Multi-Model Planner` per ottenere proposte indipendenti da più modelli di punta e ridurre il rischio decisionale. ### Validazione rapida [#validazione-rapida] Dopo le modifiche al codice, `@Verifier` controlla rapidamente sintassi, tipi e problemi di base: più veloce delle suite di test complete, più affidabile di nessun controllo. ### Esperti di dominio personalizzati [#esperti-di-dominio-personalizzati] Crea sottoagenti su misura per il tuo progetto: * Un esperto di ottimizzazione SQL che conosce il tuo schema e i tuoi pattern di query * Un guardiano degli standard del codice frontend che applica le regole del tuo ESLint e del tuo design system * Un assistente alla documentazione che adatta i contenuti tecnici in una scrittura chiara e facile da leggere *** ## Note [#note] * I sottoagenti personalizzati devono essere configurati con un modello valido per poter essere abilitati. Se usi BYOK e la chiave scade o il modello viene dismesso, il sottoagente verrà disabilitato automaticamente. * I modelli dei sottoagenti integrati possono essere modificati, ma i valori predefiniti sono ottimizzati: modificarli può ridurre le prestazioni. * **La descrizione conta:** viene iniettata nel contesto dell'agente principale e influisce su quando i sottoagenti vengono richiamati. Descrizioni migliori portano a un instradamento più intelligente. * I sottoagenti non possono chiamarsi a vicenda. Possono essere invocati solo dall'agente principale (Worker): non è consentito un annidamento più profondo.