Munka a Plan Studióban

Ez az útmutató bemutatja, hogyan dolgozhat a tervekkel a Plan Studióban. Arról, hogy mi az az orchestráció és a tervdokumentum, lásd: Orchestráció és Tervmód használata.

Terv megnyitása

Egy terv ahhoz a beszélgetéshez tartozik, amely létrehozta, így általában ott érhető el: a terv sorának a beszélgetésben van egy Megnyitás művelete, és a Plan Studio a beszélgetés melletti szerkesztőfülként nyílik meg.

Nincs „Tervek” bejegyzés az oldalsávban

Ez szándékos, nem figyelmetlenség. A /workspaces/<workspace-id>/plans címen elérhető központ csak útvonalazható mélyhivatkozásként létezik, ezért tegye könyvjelzőbe, ha állandó listát szeretne.

A központ három szakaszt sorol fel:

• Aktív tervek — orchestrációk, elöl a javasoltak, az állapotukkal, a lépésszámmal és a revíziószámmal.
• Tervdokumentumok — olyan tervek, amelyeket egyetlen ügynök nyújtott be a submit_plan hívással tervmódban, amíg javasolt vagy jóváhagyott állapotban vannak.
• Playbookok — mentett, paraméterezett tervsablonok.

Kattintson egy kártyára, hogy megnyissa a Plan Studióban. Az útvonal /workspaces/<workspace-id>/plans/<kind>/<plan-id>, ahol a kind értéke orchestration vagy document, így egyetlen tervet is mélyhivatkozhat.

Ha orchestrációt nyitott meg, a szerkeszthető vásznat, a verzióidővonalat és a jóváhagyási sávot kapja. Ha tervdokumentumot nyitott meg, ugyanaz a gráf csak olvashatóként jelenik meg — a tervdokumentumokat ügynök írja; Ön átnézi, megbecsüli, majd jóváhagyja vagy elutasítja őket, a jóváhagyott dokumentum pedig az élő, csomópontonkénti futási állapotot mutatja abból az orchestrációból, amelybe lefordult.

A DAG szerkesztése

A szerkesztés orchestráció esetén lehetséges, amíg az proposed állapotban van. A vászon minden szerkesztése billentyűzetről vezérelhető:

1. Kattintson a vászonra, majd mozgassa a kijelölést a nyílbillentyűkkel.
2. Nyomja meg az n billentyűt egy lépés hozzáadásához. „Új lépés” néven, kijelölve jelenik meg; nevezze át a jobb oldali ellenőrző panelen.
3. Nyomja meg az e billentyűt azon a lépésen, amelynek előbb kell futnia, majd kattintson a tőle függő lépésre (vagy jelölje ki, és nyomjon Enter-t) egy függőség összekapcsolásához. Egy függőben lévő kapcsolat elvetéséhez nyomja meg az Esc billentyűt.
4. Nyomja meg az x billentyűt a kijelölt lépés legújabb függőségének elvágásához, vagy a pontos függőségeket az ellenőrző panel függőségszerkesztőjében kapcsolhatja be és ki.
5. Nyomja meg a Delete billentyűt a kijelölt lépés eltávolításához; a rá mutató hivatkozások eltűnnek a megmaradó lépések függőségei közül.

Az ellenőrző panelen a lépés leírását, szerepét és kimeneti sémáját is szerkesztheti. A szerkesztések rövid szünet után automatikusan új revízióként mentődnek; egy érvényesítési hiba (amely a jóváhagyási sávban látható) blokkolja a mentést, amíg ki nem javítja.

Csak a munkalépések szerkeszthetők. A strukturális csomópontok — kutatás, megbeszélés és szintézis — csak olvashatók, és az is minden olyan lépés, amelynek a munkája már lefutott („már végrehajtva” jelölést kap, mert a szerkesztése elágaztatná a tervet).

A mentés optimista párhuzamossággal történik arra a revízióra, amelyből kiindult. Ha az orchestrátor Ön alatt újratervezi a tervet, a mentést „a terv továbblépett” üzenettel utasítja el, nem fésüli össze és nem írja felül csendben; olvassa be újra az aktuális revíziót, és végezze el újra a szerkesztést. Az ügynök által kezdeményezett újratervezések maguk is kettő percenként egyre vannak korlátozva, így ez ritka marad.

Megjegyzés

A vásznon nincs húzással átpozicionálás: az elrendezés a függőségi szerkezetből számolódik, így egy lépés „mozgatása” a függőségeinek átkötését jelenti.

Költség-, idő- és kockázatbecslések olvasása

Nyomja meg a Becslés gombot a jóváhagyási sávban.

• A vásznon minden lépés kap egy jelvényt a költségtartománnyal és a mögötte álló mintamérettel, vagy a „Még nincs előzmény” feliratot, ha a lépés szerepe még soha nem futott. Jelöljön ki egy lépést a részletes adatokért az ellenőrző panelen: költségtartomány a mintamérettel, időtartamtartomány és egy hatósugár (fájlok és szimbólumok), amely a lépés származásából következik — vagy „ismeretlen”, ha a lépéshez nem tartozik származás.
• A jóváhagyási sáv a terv összesítését mutatja: egy általános költségtartományt, a kritikus út időtartamtartományát (a párhuzamos ágak átfedik egymást, így ez nem az összeg) és a költségkeretet, ha a terv meghatároz egyet.
• Ha csak néhány lépéshez van előzmény, az összesítés részleges jelölést kap, és csak a becsülhető lépéseket fedi le. Ha a becslés felső vége meghaladja a költségkeretet, az összesítés pirosra vált, egy kerettúllépési figyelmeztetéssel.

A becslések vagy őszinték, vagy hiányoznak: egy olyan lépés, amelynek szerepéhez nincs lefutott futtatási előzmény, nulla mintaméretet jelent, tartományok nélkül, és ismeretlenként jelenik meg, nem tippként. A „Még nincs előzmény” feliratot tekintse úgy, hogy „senki sem tudja”, és ne úgy, hogy „olcsó”.

A költségkeret a becsléssel való megjelenítési összehasonlítás. Amint a terv fut, semmi sem kényszeríti ki — a kiadásokat ténylegesen leállító szabályozásért lásd: Költségek kezelése.

Egy revízió összevetése egy korábbi javaslattal

Minden szerkesztés és az orchestrátor minden újratervezése egy csak hozzáfűzhető revízióidővonalhoz fűződik hozzá, amely egy orchestrációs terv bal oldalán, a Verziók panelen látható.

1. Kattintson egy revízióra, hogy összevesse az aktuális javaslattal. Kijelölés nélkül a panel az előző revíziót veti össze az aktuálissal.
2. Olvassa el a diffet a panel alsó felében: a két revízió között hozzáadott, eltávolított vagy módosított lépések.
3. Ha a terv még proposed állapotban van, kattintson egy revízió visszatekerés ikonjára, hogy visszatérjen hozzá. A visszatekerés új revízióként menti azt a javaslatot — semmi sem vész el.

A propose_orchestration és a szerkesztő is elutasítja a változtatásokat, ha a terv már nem proposed, így egy folyamatban lévő futtatás nem vesz fel egy végrehajtás közbeni újratervezést.

Terv jóváhagyása, elutasítása vagy kiterjesztése

Az alkalmazásban egy javasolt terv egyetlen, egészében meghozott döntés: Terv jóváhagyása vagy Elutasítás a jóváhagyási sávban. A Terv jóváhagyása mindig minden lépést jóváhagy — nincs mód előbb egy részhalmaz kijelölésére. A jóváhagyás blokkolva van, amíg a javaslatnak érvényesítési hibái vannak, amelyek a gombok mellett jelennek meg.

A jóváhagyás csak operátorok számára érhető el. Nincs hozzá MCP-eszköz, így az ügynök javasolhat és módosíthat egy tervet, de soha nem hagyhatja jóvá.

Amint egy orchestráció végrehajtás alatt áll, a sáv megváltozik:

• Ha egy lépés futás közben megállt, hogy kérdezzen, jelölje ki, és nyomja meg a Csomópont folytatása gombot a folytatásához.
• Nyomja meg a Kijelöltek jóváhagyása gombot, hogy egy részleges jóváhagyást kiterjesszen a kijelölt lépésre és mindenre, amitől az tranzitívan függ (egy lépés soha nem hagyható jóvá a függőségei nélkül). A vezérlő minden orchestráció végrehajtó sávján megtalálható; nem csinál semmit, ha a tervet egészében hagyták jóvá.
• Nyomja meg a Futtatás megszakítása gombot a teljes orchestráció leállításához.

A részlegesen jóváhagyott halmazon kívüli lépések elhalasztottként jelennek meg, és nem futnak, amíg ki nem terjeszti a halmazt.

Részleges jóváhagyás nem indulhat ki az alkalmazásból

Részleges jóváhagyás csak akkor létezik, ha valami RPC-n meghívta az orchestration.approve műveletet egy explicit approved_node_keys listával. Az alkalmazás Terv jóváhagyása gombja mindig minden lépést jóváhagy. A tervdokumentumokat minden esetben egészében hagyják jóvá, így egy futó dokumentum csak a Futtatás megszakítása lehetőséget kínálja.

Playbook futtatása paraméterekkel

A playbook egy mentett tervsablon, típusos {{param}} helyőrzőkkel a céljában, a lépéscímeiben, a leírásaiban és a promptjaiban. A helyettesítés szó szerinti — nincs kifejezésnyelv; ha logikára van szüksége, használjon helyette pipeline-t.

1. A központ Playbookok szakaszában nyomja meg a playbook Futtatás gombját (vagy nyissa meg a ⌘K palettát, és válassza ki ott a playbookot).
2. Töltse ki a paramétereket. A felsorolás típusú paraméterek legördülő menüként jelennek meg; a repó- és ügynökparaméterek egy repó- vagy ügynökhivatkozást vesznek fel; az opcionális paraméterek az alapértelmezett értékükre esnek vissza.
3. Válassza ki a horgonyjegyet, amelyhez a tervet javasolja, majd erősítse meg.

Egy playbook futtatása csak javasol egy tervet — a példányosított orchestráció proposed állapotban nyílik meg a Plan Studióban, és semmi sem fut, amíg ott jóvá nem hagyja. Egy playbook eltávolításához nyomja meg a kártyáján a kuka ikont.

Az ügynökök a create_playbook és run_playbook MCP-eszközökkel hoznak létre és futtatnak playbookokat; lásd az MCP-eszközök referenciáját.

Kapcsolódó útmutatók

• Tervmód használata: hogyan készít az ügynök tervdokumentumot a submit_plan hívással
• Orchestráció futtatása: az egyszeri jóváhagyás életciklusa a beszélgetés oldaláról
• Pipeline-sablon létrehozása: amikor olyan logikára van szüksége, amit egy playbook nem tud kifejezni
• Pipeline-futtatások figyelése: egy jóváhagyott terv motoroldali nézete

Kapcsolódó fogalmak

• Orchestráció