Lavora in Plan Studio

Questa guida mostra come lavorare con i piani in Plan Studio. Per sapere cosa sono le orchestrazioni e i documenti di piano, vedi Orchestrazione e Usa la modalità piano.

Aprire un piano

Un piano appartiene alla conversazione che lo ha prodotto, quindi è lì che di solito lo raggiungi: la riga del piano nella conversazione ha un’azione Apri e Plan Studio si apre come scheda dell’editor accanto alla conversazione.

L’hub elenca tre sezioni:

Piani attivi — orchestrazioni, prima quelle proposte, con il loro stato, il numero di passaggi e il numero di revisione.
Documenti di piano — piani che un singolo agente ha inviato con submit_plan in modalità piano, finché sono proposti o approvati.
Playbook — modelli di piano salvati e parametrizzati.

Fai clic su una scheda per aprirla in Plan Studio. Il percorso è /workspaces/<workspace-id>/plans/<kind>/<plan-id>, dove kind è orchestration o document, così puoi creare un deep link anche a un singolo piano.

Se hai aperto un’orchestrazione, ottieni il canvas modificabile, la cronologia delle versioni e la barra di approvazione. Se hai aperto un documento di piano, lo stesso grafo viene mostrato in sola lettura: i documenti di piano sono scritti dagli agenti; tu li rivedi, li stimi e li approvi o li rifiuti, e un documento approvato mostra lo stato di esecuzione in tempo reale di ogni nodo dell’orchestrazione in cui è stato compilato.

Modificare il DAG

Le modifiche sono possibili su un’orchestrazione finché è proposed. Tutte le modifiche al canvas si fanno da tastiera:

Fai clic sul canvas, poi sposta la selezione con i tasti freccia.
Premi n per aggiungere un passaggio. Compare selezionato come “Nuovo passaggio”; rinominalo nel pannello di ispezione a destra.
Premi e sul passaggio che deve essere eseguito per primo, poi fai clic sul passaggio dipendente (oppure selezionalo e premi Enter) per collegare una dipendenza. Premi Esc per annullare un collegamento in sospeso.
Premi x per tagliare la dipendenza più recente del passaggio selezionato, oppure attiva o disattiva le dipendenze esatte nell’editor delle dipendenze del pannello di ispezione.
Premi Delete per rimuovere il passaggio selezionato; i riferimenti a esso vengono rimossi dalle dipendenze dei passaggi rimanenti.

Nel pannello di ispezione puoi anche modificare la descrizione, il ruolo e lo schema di output del passaggio. Le modifiche vengono salvate automaticamente come nuova revisione dopo una breve pausa; un errore di convalida (mostrato nella barra di approvazione) blocca il salvataggio finché non lo correggi.

Solo i passaggi di lavoro sono modificabili. I nodi strutturali — ricerca, discussione e sintesi — sono di sola lettura, e lo è anche qualsiasi passaggio il cui lavoro è già stato eseguito (è contrassegnato “già eseguito”, perché modificarlo biforcerebbe il piano).

Il salvataggio è ottimisticamente concorrente sulla revisione da cui sei partito. Se l’orchestratore ripianifica sotto di te, il tuo salvataggio viene rifiutato con “il piano è andato avanti” invece di essere unito o sovrascritto in silenzio; rileggi la revisione corrente e rifai la modifica. Le ripianificazioni avviate dagli agenti sono a loro volta limitate a una ogni due minuti, quindi resta un caso raro.

Leggere le stime di costo, tempo e rischio

Premi Stima nella barra di approvazione.

Ogni passaggio sul canvas riceve un badge con un intervallo di costo e la dimensione del campione su cui si basa, oppure “Ancora nessuno storico” quando il ruolo del passaggio non è mai stato eseguito. Seleziona un passaggio per il dettaglio completo nel pannello di ispezione: intervallo di costo con dimensione del campione, un intervallo di durata e un raggio d’impatto (file e simboli) derivato dalla provenienza del passaggio — o “sconosciuto” quando il passaggio non ha provenienza.
La barra di approvazione mostra il totale del piano: un intervallo di costo complessivo, un intervallo di durata per il percorso critico (i rami paralleli si sovrappongono, quindi non è la somma) e il tetto di budget quando il piano ne imposta uno.
Se solo alcuni passaggi hanno uno storico, il totale è contrassegnato come parziale e copre solo i passaggi stimabili. Se l’estremo superiore della stima supera il tetto di budget, il totale diventa rosso con un avviso “oltre budget”.

Le stime sono oneste o assenti: un passaggio il cui ruolo non ha uno storico di esecuzioni completate riporta una dimensione del campione pari a zero senza alcun intervallo ed è mostrato come sconosciuto invece che indovinato. Considera “Ancora nessuno storico” come “nessuno lo sa”, non come “economico”.

Il tetto di budget è un confronto visivo rispetto a questa stima. Niente lo applica una volta che il piano è in esecuzione — vedi Gestisci i costi per i controlli che fermano davvero la spesa.

Confrontare una revisione con una proposta precedente

Ogni modifica e ogni ripianificazione dell’orchestratore si aggiunge a una cronologia delle revisioni in sola aggiunta, mostrata nel pannello Versioni a sinistra di un piano di orchestrazione.

Fai clic su una revisione per confrontarla con la proposta corrente. Senza alcuna selezione, il pannello confronta la revisione precedente con quella corrente.
Leggi il diff nella metà inferiore del pannello: passaggi aggiunti, rimossi o modificati tra le due revisioni.
Se il piano è ancora proposed, fai clic sull’icona di riavvolgimento su una revisione per tornarci. Il riavvolgimento salva quella proposta come nuova revisione: non si perde nulla.

propose_orchestration e l’editor rifiutano entrambi le modifiche una volta che il piano non è più proposed, così un’esecuzione in corso non recepisce una ripianificazione a metà esecuzione.

Approvare, rifiutare o ampliare un piano

Dall’app un piano proposto è una sola decisione, presa in blocco: Approva piano o Rifiuta nella barra di approvazione. Approva piano approva sempre ogni passaggio — non c’è modo di selezionare prima un sottoinsieme. L’approvazione è bloccata finché la proposta ha errori di convalida, mostrati accanto ai pulsanti.

L’approvazione è riservata all’operatore. Non esiste uno strumento MCP per farlo, quindi un agente può proporre e rivedere un piano ma non può mai approvarlo.

Quando un’orchestrazione è in esecuzione, la barra cambia:

Se un passaggio si è fermato per fare una domanda a metà esecuzione, selezionalo e premi Continua nodo per riprenderlo.
Premi Approva selezionati per ampliare un’approvazione parziale al passaggio selezionato più tutto ciò da cui dipende in modo transitivo (un passaggio non può mai essere approvato senza le sue dipendenze). Il controllo è nella barra di esecuzione per ogni orchestrazione; non ha effetto quando il piano è stato approvato in blocco.
Premi Annulla esecuzione per fermare l’intera orchestrazione.

I passaggi fuori da un insieme approvato parziale vengono mostrati come rinviati e non vengono eseguiti finché non ampli l’insieme.

Eseguire un playbook con parametri

Un playbook è un modello di piano salvato con segnaposto {{param}} tipizzati nel suo obiettivo, nei titoli dei passaggi, nelle descrizioni e nei prompt. La sostituzione è letterale — non esiste un linguaggio di espressioni; se ti serve della logica, usa una pipeline invece.

Nella sezione Playbook dell’hub, premi Esegui sul playbook (oppure apri la palette ⌘K e scegli lì il playbook).
Compila i parametri. I parametri di enumerazione vengono mostrati come menu a discesa; i parametri repo e agente accettano un riferimento a un repo o a un agente; i parametri opzionali tornano al loro valore predefinito.
Scegli il Ticket di ancoraggio su cui viene proposto il piano, poi conferma.

Eseguire un playbook si limita a proporre un piano — l’orchestrazione istanziata si apre in Plan Studio come proposed e nulla viene eseguito finché non la approvi lì. Per rimuovere un playbook, premi l’icona del cestino sulla sua scheda.

Gli agenti creano ed eseguono i playbook con gli strumenti MCP create_playbook e run_playbook; vedi il riferimento degli strumenti MCP.

Guide correlate

Usa la modalità piano: come un agente produce un documento di piano con submit_plan
Esegui un’orchestrazione: il ciclo di vita con approvazione una tantum dal lato della conversazione
Crea un modello di pipeline: quando ti serve una logica che un playbook non può esprimere
Monitora le esecuzioni delle pipeline: la vista del motore di un piano approvato

Concetti correlati

Orchestrazione