Sottoagenti
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
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
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
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
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
Ogni sottoagente è un file Markdown con frontmatter YAML:
---
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
- 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
.mdha effetto immediato, senza bisogno di riavviare Verdent.
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
- 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
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
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
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
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
- 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.