Home / Glossary / Sub-Agenti

Definition

Sub-Agenti

I sub-agenti sono processi figlio paralleli generati da un agente AI di coding principale per gestire parti indipendenti di un task complesso simultaneamente. Invece di elaborare tutto sequenzialmente, l'agente principale delega sotto-task ad agenti figlio specializzati che girano in parallelo e riportano i risultati al genitore.

Come funzionano i sub-agenti

Quando un agente principale incontra un task con più parti indipendenti, può generare sub-agenti per gestirle in parallelo. Per esempio, se chiedi "refactorizza i moduli di autenticazione, pagamento e notifiche per usare il nuovo pattern di gestione errori", l'agente principale potrebbe generare tre sub-agenti—uno per ogni modulo. Ogni sub-agente legge i file rilevanti, apporta modifiche ed esegue test indipendentemente. L'agente principale raccoglie i risultati e assicura la coerenza tra le modifiche.

Quando i sub-agenti sono utili

  • +Task di refactoring grandi che coprono più moduli indipendenti
  • +Ricerca in parti diverse del codebase simultaneamente
  • +Esecuzione di più task di analisi (audit sicurezza, check prestazioni, revisione stile) in parallelo
  • +Generazione di codice per più componenti indipendenti contemporaneamente
  • +Investigazione di bug complessi che possono avere più cause radice

I sub-agenti sono più efficaci quando i sotto-task sono veramente indipendenti—non modificano gli stessi file e non dipendono dall'output degli altri. Quando i task hanno dipendenze, l'esecuzione sequenziale da parte di un singolo agente è più appropriata per evitare conflitti.

Claude Code supporta i sub-agenti tramite il suo strumento Task. L'agente principale può generare agenti figlio con istruzioni specifiche e permessi delimitati, poi sintetizzare i loro risultati in una risposta coerente.

I sub-agenti condividono il contesto con l'agente principale?+
I sub-agenti ricevono contesto dall'agente principale quando vengono creati, ma non condividono una finestra di contesto live. Ogni sub-agente opera indipendentemente con il proprio contesto. L'agente principale riceve il loro output finale e lo sintetizza.
Quanti sub-agenti possono girare contemporaneamente?+
Questo dipende dallo strumento e dalle risorse disponibili. Claude Code può eseguire più sub-agenti in parallelo, tipicamente 2-5 a seconda della complessità di ogni task. Il limite pratico è determinato dall'uso dei token e dai limiti di frequenza delle API.
I sub-agenti possono generare i propri sub-agenti?+
In principio, sì—questo crea un albero di agenti. In pratica, la maggior parte dei task viene gestita bene con un singolo livello di delega. L'annidamento profondo aggiunge complessità senza beneficio proporzionale per la maggior parte dei task di coding.
Quando dovrei evitare di usare i sub-agenti?+
Evita i sub-agenti quando i task hanno dipendenze tra loro, quando modificherebbero gli stessi file (rischiando conflitti di merge) o quando il task è abbastanza piccolo che l'elaborazione sequenziale è più veloce del costo di generazione e coordinamento di più agenti.

Related terms

Coding AgenticoClaude CodeAgente di CodingAgente AI Headless

Master Claude Code in days, not months

37 hands-on lessons from beginner to CI/CD automation. Module 1 is free.

START FREE →
← ALL TERMS