Přeskočit na obsah

Spusťte orchestaci

Tenhle návod ukáže, jak z jednoho velkého cíle udělat plán pro celý tým, který poběží sám. Jak to funguje, popisuje Orchestace.

Kdy použít orchestraci

Sekce “Kdy použít orchestraci”

Sáhni po orchestraci, když je zadání větší než jeden agent a přesné kroky ještě neznáš. Jeden úkol pošli agentovi v prostoru. Postup, který umíš zapsat ručně, slož jako šablonu pipeline.

Krok 1: Požádej o plán

Sekce “Krok 1: Požádej o plán”
  1. Otevři (nebo založ) prostor a nadřazený ticket. Návrh ho vyžaduje (propose_orchestration bere ticket_id); sdílený prostor se vezme z toho ticketu.
  2. Volitelně přepni rozbalovací nabídku režimu v composeru na Orchestrate. Režim agenta zúží na čtení a navrhování: paměť, graf kódu, čtení repozitáře a ticketů, propose_orchestration a nástroje playbooků. Místo plánu kód psát nezačne.
  3. Oslov orchestrátora přes @ (obvykle agenta CEO) a cíl napiš obyčejně:

@ceo Prozkoumej konkurenční prostředí offline-first záznamníku schůzek a napiš jednostránkový dokument k pozicování.

Orchestrátor odpoví ve prostoru strukturovanou kartou návrhu: role, které potřebuje, práce rozložená do podřízených ticketů, volitelná fáze průzkumu a diskuse, krok syntézy, který vytvoří výstup, a rozpočet.

Návrh je typovaný objekt, takže ho aplikace před spuštěním ověří (správně utvořené role, deklarovaná výstupní schémata, DAG bez cyklů). Návrh, který ověřením neprojde, schválit nejde.

Krok 2: Projdi návrh a uprav ho

Sekce “Krok 2: Projdi návrh a uprav ho”

Karta v konverzaci nabízí tři akce: Schválit plán, Odmítnout a Otevřít. Otevřít otevře plán v Plan Studio jako kartu editoru. Samotnou kartu upravit nejde.

Cokoli chceš změnit, otevři přes Otevřít a uprav v inspektoru vpravo:

  • Název, Popis, Role, Závisí na a Výstupní schéma (JSON) u libovolného kroku práce. Role je klíč role, která v plánu už je a krok vlastní. Ke konkrétnímu pojmenovanému agentovi roli z inspektoru nepřipneš. Seznam náborů a rozpočet inspektor k úpravě nenabízí.

Jen ke čtení zůstávají strukturální uzly (průzkum, diskuse, syntéza) a každý uzel, jehož práce už proběhla. Upravovat jde, jen dokud je orchestrace ve stavu proposed.

Než se rozhodneš, stiskni na liště schválení Odhadnout. Dostaneš rozsahy nákladů, trvání a dosahu dopadu. Celý editor je v Pracujte v Plan Studio.

Plán schval z karty v konverzaci, nebo z lišty schválení v Plan Studio. Tohle je jediné rozhodnutí, které uděláš. Schválit smí jen operátor: nástroj MCP na to není. Agent návrh podá a revize pošle. Schválení zůstane na tobě.

Odtud deterministický materializátor (čistá funkce, bez LLM) udělá z návrhu skutečnou pipeline a postaví kostru:

  • najme nové role (a zapíše id najatých agentů, aby se pád uprostřed schválení dal obnovit bez duplicitních náborů)
  • sdruží role do týmu
  • založí projekt a zařadí pod něj nadřazený ticket
  • spustí běh pipeline, který to celé pohání

Stav přejde na approved, pak na executing.

Podřízené tickety se provedou jako kroky pipeline. Když jsi zapnul kolo diskuse, každá role nejdřív napíše stanovisko. Postup se ukáže tam, kam se díváš už teď:

  • nadřazený ticket, ke kterému je orchestrace ukotvená
  • sdílený prostor, ve kterém tým mluví a řádek plánu sleduje stav každého uzlu
  • detail běhu pipeline, s obvyklým vodopádem a nákladem za krok. Viz Sledujte běhy pipeline
  • projekt, pod který se nadřazený ticket zařadil

Jakmile jsou podřízené tickety hotové, stav přejde na synthesizing a krok syntézy vytvoří výstup. Text se zveřejní ve sdíleném prostoru, nadřazený ticket se označí jako dokončený a stav přejde na completed.

Na kartě v konverzaci stiskni Zrušit orchestraci, nebo na liště schválení v Plan Studio Zrušit běh. Zrušení strhne práci, která právě běží.

Orchestrace selže, když selže materializace, nebo když selže její vygenerovaný běh pipeline (průzkum, diskuse, syntéza nebo persist; tyhle kroky při selhání nepokračují). Vygenerované kroky práce při selhání vždy pokračují, takže jeden spadlý podřízený ticket běh neshodí. Překročení rozpočtu běh chybou neukončí a práh „selhaly všechny podřízené tickety“ orchestrace nemá.