Lucrează în Plan Studio

Acest ghid îți arată cum să lucrezi cu planuri în Plan Studio. Pentru a afla ce sunt orchestrațiile și documentele de plan, vezi Orchestrare și Folosește modul plan.

Deschide un plan

Un plan aparține conversației care l-a produs, așa că de acolo îl accesezi de obicei: rândul planului din conversație are o acțiune Deschide, iar Plan Studio se deschide ca un tab de editor lângă conversație.

Hub-ul listează trei secțiuni:

Planuri active — orchestrare, cele propuse primele, cu starea lor, numărul de pași și numărul reviziei.
Documente de plan — planuri pe care un singur agent le-a trimis cu submit_plan în modul plan, cât timp sunt propuse sau aprobate.
Playbook-uri — șabloane de plan salvate și parametrizate.

Dă clic pe un card pentru a-l deschide în Plan Studio. Ruta este /workspaces/<workspace-id>/plans/<kind>/<plan-id>, unde kind este orchestration sau document, așa că poți crea un link direct și către un singur plan.

Dacă ai deschis o orchestrare, primești canvasul editabil, cronologia versiunilor și bara de aprobare. Dacă ai deschis un document de plan, același graf se randează doar în citire — documentele de plan sunt scrise de agenți; le revizuiești, le estimezi și le aprobi sau le respingi, iar un document aprobat afișează starea de rulare în timp real pe fiecare nod, din orchestrarea în care s-a compilat.

Editează DAG-ul

Editările sunt posibile pe o orchestrare cât timp aceasta este proposed. Toate editările pe canvas se fac de la tastatură:

Dă clic pe canvas, apoi mută selecția cu tastele cu săgeți.
Apasă n pentru a adăuga un pas. Acesta apare selectat ca „Pas nou”; redenumește-l în inspectorul din dreapta.
Apasă e pe pasul care trebuie să ruleze primul, apoi dă clic pe pasul dependent (sau selectează-l și apasă Enter) pentru a conecta o dependență. Apasă Esc pentru a abandona o conexiune în așteptare.
Apasă x pentru a elimina cea mai nouă dependență a pasului selectat sau comută dependențe exacte în editorul de dependențe din inspector.
Apasă Delete pentru a elimina pasul selectat; referințele la el sunt eliminate din dependențele pașilor rămași.

În inspector poți edita și descrierea, rolul și schema de ieșire ale pasului. Editările se salvează automat ca o revizie nouă după o scurtă pauză; o eroare de validare (afișată în bara de aprobare) blochează salvarea până când o remediezi.

Doar pașii de lucru sunt editabili. Nodurile structurale — cercetare, discuție și sinteză — sunt doar în citire, la fel ca orice pas a cărui muncă a rulat deja (este marcat „deja executat”, pentru că editarea lui ar bifurca planul).

Salvarea este optimist concurentă pe revizia de la care ai pornit. Dacă orchestratorul replanifică sub tine, salvarea ta este refuzată cu „planul a avansat” în loc să fie îmbinată sau suprascrisă în tăcere; recitește revizia curentă și refă editarea. Replanificările inițiate de agenți sunt ele însele limitate ca frecvență la una la fiecare două minute, așa că acest lucru rămâne rar.

Citește estimările de cost, timp și risc

Apasă Estimează în bara de aprobare.

Fiecare pas de pe canvas primește un ecuson cu un interval de cost și dimensiunea eșantionului din spatele lui sau „Niciun istoric încă” atunci când rolul pasului nu a rulat niciodată. Selectează un pas pentru detaliile complete în inspector: interval de cost cu dimensiunea eșantionului, un interval de durată și o rază de impact (fișiere și simboluri) derivată din proveniența pasului — sau „necunoscut” atunci când pasul nu are proveniență.
Bara de aprobare afișează totalul planului: un interval de cost general, un interval de durată pentru calea critică (ramurile paralele se suprapun, deci nu este suma) și plafonul de buget atunci când planul stabilește unul.
Dacă doar unii pași au istoric, totalul este marcat parțial și acoperă doar pașii estimabili. Dacă marginea superioară a estimării depășește plafonul de buget, totalul devine roșu, cu un avertisment de depășire a bugetului.

Estimările sunt sincere sau lipsesc: un pas al cărui rol nu are istoric de rulări finalizate raportează o dimensiune a eșantionului de zero, fără niciun interval, și este afișat ca necunoscut în loc să fie ghicit. Tratează „Niciun istoric încă” ca „nimeni nu știe”, nu ca „ieftin”.

Plafonul de buget este o comparație afișată față de această estimare. Nimic nu îl impune odată ce planul rulează — vezi Gestionează costurile pentru controalele care opresc efectiv cheltuiala.

Compară o revizie cu o propunere anterioară

Fiecare editare și fiecare replanificare a orchestratorului se adaugă la o cronologie de revizii doar cu adăugare, afișată în panoul Versiuni din stânga unui plan de orchestrare.

Dă clic pe o revizie pentru a o compara cu propunerea curentă. Fără nicio selecție, panoul compară revizia anterioară cu cea curentă.
Citește diferențele în jumătatea inferioară a panoului: pași adăugați, eliminați sau modificați între cele două revizii.
Dacă planul este încă proposed, dă clic pe pictograma de derulare înapoi de pe o revizie pentru a reveni la ea. Derularea înapoi salvează acea propunere ca o revizie nouă — nu se pierde nimic.

Atât propose_orchestration, cât și editorul refuză modificările odată ce planul nu mai este proposed, așa că o rulare în curs nu preia o replanificare din mijlocul execuției.

Aprobă, respinge sau extinde un plan

În aplicație, un plan propus este o singură decizie, luată în întregime: Aprobă planul sau Respinge în bara de aprobare. Aprobă planul aprobă întotdeauna fiecare pas — nu există nicio modalitate de a selecta mai întâi un subset. Aprobarea este blocată cât timp propunerea are erori de validare, care sunt afișate lângă butoane.

Aprobarea este exclusiv pentru operatori. Nu există un instrument MCP pentru ea, așa că un agent poate propune și revizui un plan, dar nu îl poate aproba niciodată.

Odată ce o orchestrare se execută, bara se schimbă:

Dacă un pas s-a oprit pentru a întreba în timpul rulării, selectează-l și apasă Continuă nodul pentru a-l relua.
Apasă Aprobă selecția pentru a extinde o aprobare parțială la pasul selectat plus tot ce depinde în mod tranzitiv de el (un pas nu poate fi niciodată aprobat fără dependențele sale). Controlul se află pe bara de execuție pentru fiecare orchestrare; nu are niciun efect atunci când planul a fost aprobat în întregime.
Apasă Anulează rularea pentru a opri întreaga orchestrare.

Pașii din afara unui set aprobat parțial se randează ca amânați și nu rulează până când extinzi setul.

Rulează un playbook cu parametri

Un playbook este un șablon de plan salvat, cu substituenți {{param}} tipizați în obiectivul, titlurile pașilor, descrierile și prompturile sale. Substituirea este literală — nu există un limbaj de expresii; dacă ai nevoie de logică, folosește în schimb un pipeline.

În secțiunea Playbook-uri a hub-ului, apasă Rulează pe playbook (sau deschide paleta ⌘K și alege playbook-ul de acolo).
Completează parametrii. Parametrii de enumerare se randează ca liste derulante; parametrii de repo și de agent primesc o referință de repo sau de agent; parametrii opționali revin la valoarea lor implicită.
Alege tichetul ancoră față de care este propus planul, apoi confirmă.

Rularea unui playbook doar propune un plan — orchestrarea instanțiată se deschide în Plan Studio ca proposed și nimic nu se execută până când îl aprobi acolo. Pentru a elimina un playbook, apasă pictograma de coș de gunoi de pe cardul lui.

Agenții creează și rulează playbook-uri cu instrumentele MCP create_playbook și run_playbook; vezi referința instrumentelor MCP.

Ghiduri conexe

Folosește modul plan: cum produce un agent un document de plan cu submit_plan
Rulează o orchestrare: ciclul de viață cu o singură aprobare, din perspectiva conversației
Creează un șablon de pipeline: când ai nevoie de logică pe care un playbook nu o poate exprima
Monitorizează rulările de pipeline: perspectiva motorului asupra unui plan aprobat

Concepte conexe

Orchestrare