Pracujte v Plan Studio

Tenhle návod ukazuje, jak pracovat s plány v Plan Studio. Co jsou orchestrace a dokumenty plánů, je v orchestraci a v návodu Používejte režim plánu.

Otevři plán

Plán patří konverzaci, která ho vytvořila, a tam se k němu obvykle dostaneš: řádek plánu v konverzaci má akci Otevřít a Plan Studio se otevře jako karta editoru vedle konverzace.

V postranním panelu není položka „Plány“

Je to schválně. Přehled na /workspaces/<workspace-id>/plans je jen přímý odkaz, takže si ho přidej do záložek, když chceš stálý seznam.

Přehled má tři oddíly:

• Aktivní plány — orchestrace, nejdřív navržené, se stavem, počtem kroků a číslem revize.
• Dokumenty plánů — plány, které jeden agent odeslal přes submit_plan v režimu plánu, dokud jsou navržené nebo schválené.
• Playbooky — uložené, parametrizované šablony plánů.

Kliknutím na kartu ho otevřeš v Plan Studio. Trasa je /workspaces/<workspace-id>/plans/<kind>/<plan-id>, kde kind je orchestration nebo document, takže jde odkázat i na jeden plán.

Když otevřeš orchestraci, dostaneš upravitelné plátno, časovou osu verzí a lištu schválení. Když otevřeš dokument plánu, stejný graf je jen ke čtení. Dokumenty plánů píše agent; ty je kontroluješ, odhaduješ a schvaluješ, nebo odmítáš. Schválený dokument ukazuje živý stav běhu po uzlech z orchestrace, do které se zkompiloval.

Uprav DAG

Úpravy jdou u orchestrace, dokud je ve stavu proposed. Plátno se upravuje jen z klávesnice:

1. Klikni na plátno a výběr posouvej šipkami.
2. n přidá krok. Objeví se vybraný jako „Nový krok“; přejmenuj ho v inspektoru vpravo.
3. Na kroku, který má běžet jako první, stiskni e, pak klikni na závislý krok (nebo ho vyber a stiskni Enter) a propojíš závislost. Esc rozpracované spojení zahodí.
4. x odebere nejnovější závislost vybraného kroku. Jednotlivé závislosti zaškrtáváš v editoru závislostí v inspektoru.
5. Delete vybraný krok smaže; odkazy na něj zmizí ze závislostí zbylých kroků.

V inspektoru upravíš i popis kroku, roli a výstupní schéma. Úpravy se po krátké pauze samy uloží jako nová revize. Chyba ověření (v liště schválení) uložení zablokuje, dokud ji neopravíš.

Upravovat jde jen pracovní kroky. Strukturální uzly — průzkum, diskuse a syntéza — jsou jen ke čtení, stejně jako krok, jehož práce už proběhla. Ten je označený „Už provedeno“, protože úprava by plán rozvětvila.

Uložení drží optimistickou souběžnost vůči revizi, ze které jsi vyšel. Když orchestrátor pod tebou plán přeplánuje, uložení se odmítne hláškou „the plan moved on“, cizí změna se nesloučí a potichu se nepřepíše. Načti aktuální revizi znovu a úpravu udělej znovu. Přeplánování, která spouští agent, mají sama limit jedno za dvě minuty, takže se to stává zřídka.

Poznámka

Plátno nejde přetahováním přeskládat. Rozložení se počítá ze struktury závislostí, takže posunout krok znamená přepojit jeho závislosti.

Přečti odhady nákladů, času a rizika

V liště schválení stiskni Odhadnout.

• Každý krok na plátně dostane odznak s rozsahem nákladů a velikostí vzorku za ním, nebo „Zatím žádná historie“, když role kroku ještě nikdy neběžela. Vyber krok a v inspektoru uvidíš celý detail: rozsah nákladů s velikostí vzorku, rozsah trvání a dosah dopadu (soubory a symboly) odvozený z původu kroku, nebo „neznámý“, když krok původ nemá.
• Lišta schválení ukáže součet plánu: celkový rozsah nákladů, rozsah trvání kritické cesty (paralelní větve se překrývají, takže to není součet) a strop rozpočtu, když ho plán nastaví.
• Když má historii jen část kroků, součet je označený částečný a kryje jen odhadnutelné kroky. Když horní konec odhadu překročí strop rozpočtu, součet zčervená s varováním „nad rozpočtem“.

Odhady jsou poctivé, nebo žádné. Krok, jehož role nemá historii dokončených běhů, hlásí velikost vzorku nula, žádné rozsahy a ukáže se jako neznámý. „Zatím žádná historie“ ber jako „nikdo neví“, ne jako „levné“.

Strop rozpočtu je jen zobrazené srovnání s tímhle odhadem. Jakmile plán běží, nic ho nevynucuje. Ovládání, které výdaje doopravdy zastaví, je v návodu Spravujte náklady.

Porovnej revizi se starším návrhem

Každá úprava a každé přeplánování orchestrátorem se připíše na časovou osu revizí, do které se jen přidává. U orchestrace ji ukazuje panel Verze vlevo.

1. Klikni na revizi a porovnáš ji s aktuálním návrhem. Bez výběru panel porovná předchozí revizi s tou aktuální.
2. Diff čti v dolní polovině panelu: kroky přidané, odebrané nebo změněné mezi oběma revizemi.
3. Dokud je plán ve stavu proposed, klikni na ikonu přetočení u revize a vrať se k ní. Přetočení ten návrh uloží jako novou revizi a nic se neztratí.

propose_orchestration i editor odmítnou změny, jakmile plán už není proposed, takže probíhající běh nepřevezme přeplánování uprostřed provádění.

Schval, odmítni nebo plán rozšiř

Z aplikace je navržený plán jedno rozhodnutí, celé naráz: Schválit plán, nebo Odmítnout v liště schválení. Schválit plán schválí vždy každý krok. Podmnožinu předem vybrat nejde. Schválení je zablokované, dokud má návrh chyby ověření; ty se ukážou vedle tlačítek.

Schvalovat smí jen operátor. Nástroj MCP na to není, takže agent umí plán navrhnout a revidovat, schválit ho ale nikdy.

Jakmile se orchestrace provádí, lišta se změní:

• Když se krok uprostřed běhu zastavil, aby se zeptal, vyber ho a stiskni Pokračovat v uzlu.
• Schválit vybrané rozšíří částečné schválení na vybraný krok a na všechno, na čem tranzitivně závisí (krok bez svých závislostí schválit nejde). Ovládání je na liště provádění u každé orchestrace. Když byl plán schválený celý, nic neudělá.
• Zrušit běh zastaví celou orchestraci.

Kroky mimo částečně schválenou množinu se vykreslí jako odložené a neběží, dokud množinu nerozšíříš.

Částečné schválení v aplikaci nevznikne

Částečné schválení existuje, jen když něco zavolalo orchestration.approve přes RPC s explicitním seznamem approved_node_keys. Schválit plán v aplikaci schválí vždy každý krok. Dokumenty plánů se schvalují celé vždy, takže prováděný dokument nabízí jen Zrušit běh.

Spusť playbook s parametry

Playbook je uložená šablona plánu s typovanými zástupnými symboly {{param}} v cíli, názvech kroků, popisech a promptech. Dosazení je doslovné a žádný výrazový jazyk v tom není. Když potřebuješ logiku, použij pipeline.

1. V oddílu Playbooky v přehledu stiskni na playbooku Spustit (nebo otevři paletu ⌘K a playbook vyber tam).
2. Vyplň parametry. Výčtové parametry se vykreslí jako rozevírací seznamy. Parametry repozitáře a agenta berou odkaz na repozitář nebo agenta. Volitelné parametry spadnou na svou výchozí hodnotu.
3. Vyber Kotvicí ticket, proti kterému se plán navrhne, a potvrď.

Spuštění playbooku plán jen navrhne. Zinstancovaná orchestrace se v Plan Studio otevře jako proposed a nic se neprovede, dokud ji tam neschválíš. Playbook smažeš ikonou koše na jeho kartě.

Agenti playbooky zakládají a spouštějí nástroji MCP create_playbook a run_playbook. Viz nástroje MCP.

Související návody

• Používejte režim plánu: jak agent nástrojem submit_plan vytvoří dokument plánu
• Spusťte orchestraci: životní cyklus jednoho schválení ze strany konverzace
• Vytvořte šablonu pipeline: když potřebuješ logiku, kterou playbook nevyjádří
• Sledujte běhy pipeline: pohled enginu na schválený plán

Související koncepty

• Orchestrace