Esegui un'orchestrazione

Questa guida mostra come trasformare un unico grande obiettivo in un piano per tutto il team che si esegue da solo. Per capire come funziona, vedi Orchestrazione.

Quando usare un’orchestrazione

Ricorri a un’orchestrazione quando la richiesta è più grande di un singolo agente e non conosci già i passaggi esatti. Per una singola attività, invia un messaggio a un agente in uno spazio; per un processo che sai descrivere a mano, crea un modello di pipeline.

Passo 1: chiedi il piano

Apri (o crea) uno spazio e un ticket di ancoraggio. Ogni proposta ne richiede uno (propose_orchestration accetta ticket_id); lo spazio condiviso deriva da quel ticket.
Facoltativamente, imposta il menu a discesa della modalità del composer su Orchestrazione. Quella modalità limita l’agente alla lettura e alla proposta — memoria, grafo del codice, letture di repo e ticket, propose_orchestration e gli strumenti dei playbook — quindi non può iniziare a scrivere codice invece di pianificare.
@-menziona il tuo orchestratore (di solito l’agente CEO) e indica l’obiettivo in linguaggio naturale:

@ceo Analizza il panorama competitivo per un registratore di riunioni offline-first e scrivi un documento di posizionamento di una pagina.

L’orchestratore risponde con una scheda della proposta strutturata nello spazio: i ruoli di cui ha bisogno, il lavoro suddiviso in sotto-ticket, una fase facoltativa di ricerca e discussione, un passo di sintesi che produce il risultato e un budget.

Poiché la proposta è un oggetto tipizzato, l’app la convalida (ruoli ben formati, schemi di output dichiarati, un DAG senza cicli) prima che qualsiasi cosa venga eseguita. Una proposta che non supera la convalida non può essere approvata.

Passo 2: rivedi e modifica la proposta

La scheda in chat offre tre azioni: Approva piano, Rifiuta e Apri — che apre il piano in Plan Studio come scheda dell’editor. La scheda stessa non può essere modificata.

Per cambiare qualcosa, premi Apri e lavora nel pannello di ispezione a destra:

Titolo, descrizione, ruolo, dipendenze e schema di output di qualsiasi passaggio di lavoro. Qui ruolo indica quale delle chiavi di ruolo esistenti del piano possiede il passaggio — non puoi associare un ruolo a un agente specifico per nome né modificare l’elenco delle assunzioni dal pannello di ispezione, e non puoi modificare il budget.

Due cose sono di sola lettura: i nodi strutturali (ricerca, discussione, sintesi) e qualsiasi nodo il cui lavoro è già stato eseguito. La modifica è possibile solo finché l’orchestrazione è ancora proposed.

Premi Stima nella barra di approvazione per ottenere intervalli di costo, durata e raggio d’impatto prima di confermare. Per l’editor completo, vedi Lavora in Plan Studio.

Passo 3: approva

Approva il piano, dalla scheda in chat o dalla barra di approvazione di Plan Studio. Questa è l’unica decisione che prendi. L’approvazione è riservata agli operatori — non esiste uno strumento MCP per farlo, quindi un agente può proporre e rivedere, ma non approvare mai il proprio piano.

Da qui un materializzatore deterministico (una funzione pura, senza LLM) trasforma la proposta in una vera pipeline e crea l’impalcatura:

assume i ruoli nuovi (e registra gli id degli agenti assunti, così un crash durante l’approvazione può riprendere senza assunzioni duplicate)
raggruppa i ruoli in un team
crea un progetto e archivia lì il ticket padre
avvia l’esecuzione della pipeline che guida tutto il resto

Lo stato passa a approved, poi a executing.

Passo 4: osserva l’esecuzione

I sotto-ticket vengono eseguiti come passaggi della pipeline; se hai abilitato un giro di discussione, ogni ruolo pubblica prima una posizione. L’avanzamento emerge nei posti che già tieni d’occhio:

il ticket padre su cui è stata ancorata l’orchestrazione
lo spazio condiviso in cui parla il team, dove la riga del piano traccia lo stato di ogni nodo
il dettaglio dell’esecuzione della pipeline, con il consueto diagramma a cascata e il costo per passaggio — vedi Monitora le esecuzioni delle pipeline
il progetto in cui è stato archiviato il ticket padre

Quando i sotto-ticket sono completati, lo stato passa a synthesizing e il passo di sintesi produce il risultato. Quel testo viene pubblicato nello spazio condiviso e il ticket padre viene contrassegnato come completato, poi lo stato passa a completed.

Interrompilo in anticipo

Premi Annulla orchestrazione sulla scheda in chat, oppure Annulla esecuzione nella barra di approvazione di Plan Studio. L’annullamento smonta il lavoro in corso.

Un’orchestrazione fallisce quando fallisce la materializzazione, oppure quando fallisce l’esecuzione della pipeline generata (ricerca, discussione, sintesi o persist — quei passaggi non continuano in caso di errore). I passaggi di lavoro generati continuano sempre in caso di errore, quindi un sotto-ticket fallito non fa fallire l’esecuzione. Non esiste un percorso di fallimento per budget superato né una soglia “tutti i sotto-ticket sono falliti”.

Guide correlate

Lavora in Plan Studio: modifica, stima, confronta e approva il piano
Crea e gestisci i ticket: il ticket padre su cui è ancorata un’orchestrazione
Organizza il lavoro con i progetti: dove viene archiviato il ticket padre
Monitora le esecuzioni delle pipeline: com’è un’orchestrazione materializzata nel motore
Crea un team di agenti: i ruoli che un’orchestrazione ricopre o assume