Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Il ruolo del leader e dei sotto-agenti

Lezione 2 di 14 Aggiornata il 29 luglio 2026 Sviluppatore
In questa pagina
  1. Una gerarchia chiara
  2. L’agente leader
  3. I sotto-agenti
  4. Il ragionamento crittografato dei sotto-agenti
  5. La risposta finale
  6. Cosa significa questo per i tuoi prompt
  7. Punti chiave

Una gerarchia chiara

L’architettura multi-agente di Grok si basa su una distinzione fondamentale tra due tipi di agenti: il leader e i sotto-agenti. Finché non avrai compreso questa gerarchia, scriverai prompt rivolti alla parte sbagliata del sistema, chiedendoti poi perché le tue istruzioni non vengono seguite.

L’agente leader

Il leader è l’agente principale e l’unico che interagisce direttamente con te. Esegue tre funzioni in sequenza. Innanzitutto coordina, scomponendo la tua richiesta e assegnando i sotto-compiti ai sotto-agenti. Poi supervisiona, monitorando la ricerca di ciascun agente e orientando la discussione verso gli angoli che producono risultati. Infine sintetizza, compilando i contributi in una risposta strutturata.

C’è un punto da prendere esattamente come stated: solo le chiamate agli strumenti e la risposta del leader vengono restituite all’utente. Non vedi mai direttamente ciò che producono i sotto-agenti, ma solo il risultato finale del leader. In pratica, se un sotto-agente trova un’informazione cruciale ma il leader decide che rientra al di fuori della tua richiesta, quell’informazione non apparirà da nessuna parte in ciò che ricevi.

I sotto-agenti

I sotto-agenti sono i ricercatori del team e ognuno ha esattamente lo stesso set di strumenti del leader. Un agente responsabile del monitoraggio dei prodotti recupererà gli annunci ufficiali con web_search, per poi valutare le reazioni sul campo con x_search, che cerca nei post di X. L’agente che eredita la parte di lavoro ricca di numeri può aprire code_execution per ricalcolare una proiezione invece di stimarla a mente. collections_search interroga le tue collezioni e anche gli strumenti MCP remoti che hai dichiarato sono disponibili per tutto il team, non solo per il leader.

Comunicano tra loro e con il leader per affinare la loro ricerca, il che permette loro di esplorare un argomento da più angolazioni contemporaneamente senza che due agenti rifacciano lo stesso lavoro.

Il ragionamento crittografato dei sotto-agenti

Il ragionamento interno dei sotto-agenti rimane crittografato. Non puoi leggere il loro processo di pensiero, a differenza del ragionamento visibile che modelli più vecchi come grok-3-mini esponevano. Questa differenza sorprende spesso gli sviluppatori abituati a ispezionare le tracce di ragionamento per comprendere un risultato inaspettato: qui quella porta è chiusa.

Ne conseguono tre effetti. Vedi il risultato finale del leader, mai i passaggi intermedi. Lo stato del sotto-agente è accessibile solo abilitando il parametro use_encrypted_content=True. E anche con quel parametro, il contenuto rimane crittografato: serve al modello per mantenere una conversazione coerente tra i vari turni, non perché tu lo legga. Questa opacità è un compromesso deliberato: offre agli agenti la libertà di ragionare senza vincoli di visualizzazione, al costo di una minore trasparenza per te.

La risposta finale

Quando il leader ha ricevuto informazioni sufficienti dai suoi sotto-agenti, produce la risposta finale. Tale risposta incorpora i risultati della ricerca trovati dai vari agenti, le chiamate agli strumenti effettuate da uno qualsiasi di essi — ricerca web, esecuzione di codice — e la sintesi strutturata propria del leader.

Le chiamate agli strumenti meritano un’attenzione speciale: compaiono nella risposta indipendentemente dal fatto che le abbia effettuate il leader o un sotto-agente. È l’unico spiraglio che hai sul lavoro dei sotto-agenti. Se vuoi verificare che una ricerca abbia effettivamente colpito le fonti giuste, è lì che devi guardare, e nowhere else.

Cosa significa questo per i tuoi prompt

Questa architettura cambia il modo in cui formuli una richiesta. Poiché il leader gestisce la formattazione, sii preciso sul deliverable che ti aspetti: una tabella comparativa, una nota informativa, un elenco ragionato — deve sapere cosa costruire. Definisci anche l’ambito della ricerca, perché i sotto-agenti hanno bisogno di confini chiari o si disperdono; una richiesta vaga sul “mercato dell’IA” produrrà quattro esplorazioni divergenti che il leader faticherà poi a riconciliare.

Due abitudini completano il quadro. Chiedi esplicitamente le fonti se le vuoi: gli agenti sanno come citare, ma non lo fanno ogni volta. E rinuncia a pilotare i sotto-agenti dal tuo prompt: scrivere “fa’ controllare i prezzi all’agente 3” non ha alcun effetto, dato che il tuo unico contatto è il leader e la divisione del lavoro spetta a lui.

Punti chiave

  • Il leader coordina, supervisiona e sintetizza — è il tuo unico contatto
  • I sotto-agenti eseguono ricerca e analisi in parallelo
  • Vengono restituiti solo la risposta del leader e le chiamate agli strumenti
  • Il ragionamento dei sotto-agenti è crittografato e inaccessibile
  • I tuoi prompt devono rivolgersi al leader con istruzioni chiare sul deliverable