Usa la modalità piano

Questa guida mostra come ottenere da un agente un piano strutturato prima che scriva una sola riga di codice.

In modalità piano l’agente conduce la ricerca in sola lettura e il suo unico risultato è un piano tipizzato: un grafo delle dipendenze di passaggi che tu approvi e che Control Center compila poi in lavoro reale. Usala quando vuoi vedere l’ambito di una modifica, farti scomporre i passaggi o farti nominare rischi e dipendenze prima che venga toccato qualcosa.

Porta uno spazio in modalità piano

Ognuna di queste azioni cambia la modalità dello spazio e la modifica viene salvata:

Scegli Piano dal menu a discesa della modalità, all’estrema sinistra della barra degli strumenti del composer
Premi Shift+Tab
Invia /plan. Un /plan da solo si limita ad attivare la modalità; /plan <request> la attiva e invia il resto come tuo messaggio

/plan non viaggia mai come testo — imposta la modalità memorizzata, che è l’autorità da cui leggono la superficie degli strumenti, la preimpostazione della guardia e il prompt. La modalità vale quindi per questo turno e per ogni turno successivo, finché non la cambi di nuovo.

La modalità è memorizzata sullo spazio, quindi lo stesso agente può trovarsi in modalità piano qui e in modalità agente altrove.

Che cosa produce l’agente

Conduce la ricerca in sola lettura: memoria, indice del codice, file
Chiama submit_plan una sola volta, con un goal più dei nodes, ognuno con una key stabile, un title, una description e le chiavi dei nodi da cui dependsOn (ed è questo che permette al lavoro indipendente di procedere in parallelo)
Si ferma

Lo strumento convalida il grafo — chiavi duplicate, dipendenze pendenti, cicli — e restituisce le violazioni perché l’agente le corregga, anziché accettare un piano rotto.

Il piano compare nella conversazione come una riga compatta che mostra l’obiettivo, il suo stato e il numero di passaggi. Plan Studio — il grafo delle dipendenze, l’ispettore per singolo nodo e la stima dei costi — si apre come scheda accanto alla conversazione: premi Apri sulla riga, oppure aspetta e basta, perché un piano che arriva entro 30 secondi mentre stai guardando la conversazione apre da sé la sua scheda.

Quando la richiesta è ambigua, un agente in modalità piano può mettersi in pausa e farti fino a tre domande bloccanti con lo strumento ask_user. Visualizza un modulo nella conversazione — opzioni oppure testo libero — e l’esecuzione resta bloccata finché non rispondi. Lo strumento è di livello lettura, quindi sopravvive alla superficie di sola lettura della modalità piano, ed è esente dal wrapper di approvazione (un prompt davanti a un prompt fallirebbe chiuso senza alcun approvatore collegato, negando all’agente il gesto stesso di chiedere).

Ha bisogno di uno spazio in cui visualizzarsi, quindi un invio one-shot senza conversazione non ne dispone. Anticipare ambito, repo di destinazione e criteri di accettazione nel primo messaggio resta comunque più rapido di un giro di andata e ritorno.

La prosa qui non è un risultato. Un’esecuzione che termina senza chiamare submit_plan pubblica nella conversazione una riga visibile “Ended without submitting a plan (no submit_plan call).” e segnala l’esecuzione come una che non ha consegnato il proprio risultato. Lo stato dell’esecuzione resta deliberatamente completed — così le macchine a stati di pipeline e ticket non vengono toccate — quindi leggi la riga, non il badge di stato.

Approva il piano

Dalla riga del piano nella conversazione, premi Approva ed esegui. Dalla barra di approvazione di Plan Studio, premi Approva piano (oppure Rifiuta accanto; l’approvazione è disabilitata finché il grafo presenta un errore di convalida).

Poi:

Control Center compila il piano in un’orchestrazione e la materializza: i ticket e l’esecuzione. In questo passaggio non è coinvolto alcun modello; è deterministico
Il piano viene eseguito dall’agente che lo ha scritto. Se coinvolgere qualcun altro è una decisione che spetta a quell’agente al momento dell’esecuzione: può delegate_task un passaggio a un collega più adatto, entro il limite di profondità di delega dello spazio di lavoro
L’obiettivo del piano diventa l’obiettivo della conversazione e il lavoro viene eseguito in quella stessa conversazione: ogni passaggio pubblica ciò che è stato chiesto all’agente e trasmette in streaming il suo turno, così lo segui (e puoi fermare un turno) da dove ti trovi già
La riga dell’obiettivo nel pannello laterale Generale della conversazione (sotto Attività) riporta l’avanzamento dell’esecuzione come settled/total e il suo pulsante di arresto; Plan Studio mostra lo stato di ogni nodo sul grafo e consente di annullare anche da lì

Continua a lavorare senza approvare

Se preferisci restare in questa conversazione invece di approvare il piano, l’agente può chiamare exit_plan_mode. È l’unica uscita consentita: apre una richiesta di approvazione durevole collegata alla conversazione e restituisce pending — lo spazio resta in modalità piano e l’agente non deve agire. Una volta approvata la richiesta, la successiva chiamata a exit_plan_mode dell’agente porta lo spazio dalla modalità piano alla modalità agente e sblocca i suoi strumenti che mutano. Un rifiuto gli permette di aprire una nuova richiesta su un piano rivisto.

Per uscire dalla modalità piano, cambia il menu a discesa del composer (oppure Shift+Tab), o approva il piano inviato. exit_plan_mode apre un’approvazione durevole, decisa con lo strumento MCP decide_approval. L’overlay dei guardrail per le chiamate agli strumenti bloccate è una coda diversa, in memoria, e non trasporta le richieste di uscita dal piano.

La modalità piano in un passaggio di pipeline

Un nodo di pipeline messaging.createSpace legge la modalità della conversazione dall’extra mode della configurazione del nodo: extras['mode']: 'plan'. La chiave richiede una corrispondenza esatta: qualsiasi altra grafia, comprese conversationMode o dispatchMode, viene ignorata in silenzio e la stanza ricade sul valore predefinito del body, che è la modalità Revisione, non chat. Un passaggio promptAgent entra in una stanza che non ha creato e non ne ridefinisce i permessi. Il select Modalità di invio dell’editor di configurazione del nodo (allParallel / manager) serve per i nodi che inviano un team. Imposta la modalità della conversazione con extras['mode'] su un modello che apre lo spazio, oppure sulla configurazione di quel nodo tramite l’API.