Gemini CLI Subagents

Cos'è Gemini CLI subagents?

I subagenti sono agenti esperti specializzati che operano accanto alla tua sessione principale di Gemini CLI. Quando assegni a Gemini CLI un compito ampio o complesso, l'agente principale può delegare sottotask specifici al subagente più rilevante, agendo come orchestratore.

Ogni subagente opera in isolamento con la propria finestra di contesto separata, istruzioni di sistema personalizzate e un set curato di strumenti. Il loro lavoro — potenzialmente comprendente molte chiamate a strumenti, ricerche o esecuzioni di test — viene consolidato in una singola risposta restituita alla sessione principale.

Caratteristiche principali

• Delega a esperti specializzati: Gemini CLI può suddividere un compito complesso in sottotask e instradarli verso subagenti mirati.
• Ambienti di esecuzione isolati: Ogni subagente opera con la propria finestra di contesto, istruzioni di sistema e strumenti curati, evitando di affollare la sessione principale.
• Consolidamento di strumenti e contesto: I passaggi intermedi eseguiti dai subagenti vengono consolidati in una singola risposta per l'agente principale.
• Esecuzione parallela di subagenti: Gemini CLI supporta l'esecuzione simultanea di più subagenti (sia subagenti diversi sia più istanze dello stesso subagente).
• Definizioni personalizzate di subagenti: Puoi creare i tuoi subagenti usando semplici file Markdown con YAML frontmatter.

Come usare Gemini CLI subagents

1. Crea una definizione di subagente usando un file Markdown (.md) con YAML frontmatter che specifica campi come name, description, tools e model (come mostrato nell'esempio fornito per un “frontend-specialist”).
2. Aggiungi la definizione in una delle posizioni supportate:
   • Per flussi di lavoro personali: ~/.gemini/agents
   • Per condivisione team/progetto: .gemini/agents
   • Per estensioni: includi i file Markdown di definizione degli agenti nella directory agents/ dell'estensione.
3. Usa Gemini CLI come al solito: fornisci il tuo compito generale nella sessione principale di Gemini CLI; Gemini CLI può quindi dispatching subagenti per gestire i sottotask rilevanti.
4. (Se necessario) esegui lavoro in parallelo: quando i task si dividono naturalmente in più tracciati indipendenti di ricerca/refactoring/testing, Gemini CLI può dispatching più subagenti contemporaneamente.

Casi d'uso

• Ricerca su più argomenti: Delega thread di ricerca separati a subagenti diversi e avviali in parallelo, ricevendo poi output consolidati nella sessione principale.
• Refactoring di più componenti: Suddividi un refactoring in task distinti a livello di componente e fai lavorare subagenti specializzati su ciascuna area senza riempire la finestra di contesto principale.
• Esplorazione e analisi del codice: Usa subagenti esperti per indagare sezioni di codice e restituire riassunti o risultati formattati, mentre l'agente principale mantiene il processo decisionale e la sintesi finale.
• Testing e validazione: Sposta sequenze di passaggi legati ai test (che possono comportare molte chiamate a strumenti) sui subagenti per mantenere la sessione principale reattiva.
• Automazione specifica per workflow con persona personalizzate: Crea un agente specialista riutilizzabile (es. una persona frontend/UI-UX) per imporre un approccio e un uso degli strumenti coerenti nei workflow di progetto ripetuti.

FAQ

In che modo i subagenti differiscono dalla sessione principale di Gemini CLI?
I subagenti sono agenti esperti specializzati che operano accanto alla tua sessione principale. Lavorano in isolamento con la propria finestra di contesto, istruzioni di sistema e strumenti, per poi restituire risultati consolidati.

Gemini CLI può eseguire più di un subagente contemporaneamente?
Sì. Gemini CLI supporta l'esecuzione parallela, inclusa la creazione di più subagenti o più istanze dello stesso subagente simultaneamente.

Come si configurano i subagenti personalizzati?
I subagenti personalizzati sono definiti con file Markdown (.md) che includono YAML frontmatter. Puoi posizionarli in ~/.gemini/agents per uso personale, .gemini/agents per condivisione a livello di progetto o nella directory agents/ di un'estensione.

Cosa succede al lavoro intermedio eseguito dai subagenti?
I subagenti possono eseguire molte chiamate a strumenti, ricerche di file o esecuzioni di test, ma la loro esecuzione viene consolidata in una singola risposta restituita all'agente principale.

I subagenti hanno i propri strumenti e istruzioni di sistema?
Sì. Ogni subagente opera con il proprio set curato di strumenti e istruzioni di sistema personalizzate, distinte dalla sessione principale.

Alternative

• Prompting single-agent senza delega: Puoi chiedere a Gemini CLI di gestire tutto in un unico contesto. Questo evita la configurazione di agenti personalizzati, ma potrebbe richiedere prompt più lunghi o soffrire di crescita del contesto.
• Suddivisione manuale del workflow: Puoi eseguire prompt separati e indipendenti per ogni sottotask e poi unire i risultati manualmente. Questo può simulare la delega, ma gestisci tu l'orchestrazione e la consolidazione.
• Framework multi-agente generici: Approcci multi-agente basati su tool o framework possono anch'essi instradare task a ruoli specializzati, anche se il workflow e la configurazione differiscono dalle definizioni subagent e dal modello di isolamento di Gemini CLI.
• Ruoli agent basati su chat (non subagent): Se il tuo caso d'uso è principalmente assistenza basata su ruoli piuttosto che esecuzione parallela isolata di tool, potresti trovare sufficiente un prompting di ruoli più semplice, con minor controllo su isolamento e output consolidati dei sub-work.