Sessioni multiagente

L'orchestrazione multi-agente consente a un agente di coordinarsi con altri per completare lavori complessi. Gli agenti possono operare in parallelo con il proprio contesto isolato, il che contribuisce a migliorare la qualità dell'output e il tempo di completamento.

Come funziona

Tutti gli agenti condividono lo stesso container e filesystem, ma ogni agente viene eseguito nel proprio thread di sessione, un flusso di eventi con contesto isolato e la propria cronologia delle conversazioni. Il coordinatore riporta l'attività nel thread primario (che coincide con il flusso di eventi a livello di sessione); i thread aggiuntivi vengono generati in fase di esecuzione quando il coordinatore decide di delegare.

I thread sono persistenti: il coordinatore può inviare un messaggio di follow-up a un agente chiamato in precedenza, e quell'agente conserva tutto ciò che è avvenuto nei turni precedenti.

Ogni agente utilizza la propria configurazione (modello, prompt di sistema, strumenti, server MCP e competenze) come definita al momento della creazione dell'agente. Strumenti e contesto non sono condivisi.

Cosa delegare

Le sessioni multiagente funzionano meglio quando ci sono più attività ben definite e specializzate all'interno di un obiettivo complessivo:

• Revisione del codice: Un agente revisore con un prompt di sistema mirato e strumenti di sola lettura.
• Generazione di test: Un agente di test che scrive ed esegue test senza toccare il codice di produzione.
• Ricerca: Un agente di ricerca con strumenti web che riassume i risultati al coordinatore.

Dichiarare gli agenti chiamabili

Quando si definisce il proprio agente, elencare gli ID aggiuntivi degli agenti che è autorizzato a chiamare:

Ogni voce in callable_agents deve essere l'ID di un agente esistente. È supportato un solo livello di delega: il coordinatore può chiamare altri agenti, ma quegli agenti non possono chiamare agenti propri.

Quindi creare una sessione che faccia riferimento all'orchestratore:

Gli agenti chiamabili vengono risolti dalla configurazione dell'orchestratore. Non è necessario fare riferimento a loro durante la creazione della sessione.

Thread di sessione

Il flusso di eventi a livello di sessione (/v1/sessions/:id/stream) è considerato il thread primario, che contiene una vista condensata di tutta l'attività su tutti i thread. Non si vedranno le tracce individuali degli agenti chiamati, ma si vedrà l'inizio e la fine del loro lavoro. I thread di sessione sono dove si approfondisce il ragionamento e le chiamate agli strumenti di un agente specifico.

Lo stato della sessione è anche un'aggregazione di tutta l'attività degli agenti; se almeno un thread è running, anche lo stato complessivo della sessione sarà running.

Elencare tutti i thread in una sessione come segue:

Trasmettere in streaming gli eventi da un thread specifico:

Elencare gli eventi passati per un thread:

Tipi di eventi multiagente

Questi eventi mostrano l'attività multiagente sul flusso di sessione di primo livello.

Permessi degli strumenti e strumenti personalizzati nei thread

Quando un thread callable_agent ha bisogno di qualcosa dal client (permesso per eseguire uno strumento always_ask, o il risultato di uno strumento personalizzato) la richiesta appare nel flusso di sessione con un campo session_thread_id. Includere lo stesso session_thread_id quando si pubblica la risposta in modo che la piattaforma la instradi al thread in attesa.

• session_thread_id è presente: l'evento ha avuto origine in un thread di subagente. Ripeterlo nella risposta.
• session_thread_id è assente: l'evento proviene dal thread primario. Rispondere senza il campo.
• Abbinare tool_use_id per associare richieste e risposte.

L'esempio seguente estende il gestore di conferma degli strumenti per instradare le risposte. Lo stesso schema si applica a user.custom_tool_result.