Arbeta i Plan Studio

Den här guiden visar hur du arbetar med planer i Plan Studio. Vad orkestreringar och plandokument är hittar du i Orkestrering och Använd planläge.

Öppna en plan

En plan tillhör samtalet som tog fram den, så det är där du normalt når den: planens rad i samtalet har åtgärden Öppna och Plan Studio öppnas som en flik i redigeraren bredvid samtalet.

Navet listar tre avsnitt:

Aktiva planer – orkestreringar, föreslagna först, med sin status, sitt antal steg och sitt revisionsnummer.
Plandokument – planer som en enskild agent skickade in med submit_plan i planläge, medan de är föreslagna eller godkända.
Playbooks – sparade, parameteriserade planmallar.

Klicka på ett kort för att öppna det i Plan Studio. Rutten är /workspaces/<workspace-id>/plans/<kind>/<plan-id>, där kind är orchestration eller document, så du kan djuplänka till en enskild plan också.

Om du öppnade en orkestrering får du den redigerbara duken, versionstidslinjen och godkännandefältet. Om du öppnade ett plandokument renderas samma graf skrivskyddat – plandokument är skrivna av agenter; du granskar, uppskattar och godkänner eller avvisar dem, och ett godkänt dokument visar körningsstatus per nod i realtid från orkestreringen det kompilerades till.

Redigera DAG:en

Redigeringar är möjliga på en orkestrering medan den är proposed. Alla redigeringar på duken sker via tangentbordet:

Klicka på duken och flytta sedan markeringen med piltangenterna.
Tryck n för att lägga till ett steg. Det visas markerat som “Nytt steg”; byt namn på det i inspektören till höger.
Tryck e på steget som måste köras först och klicka sedan på det beroende steget (eller markera det och tryck Enter) för att koppla ett beroende. Tryck Esc för att avbryta en väntande koppling.
Tryck x för att kapa det markerade stegets nyaste beroende, eller växla exakta beroenden i inspektörens beroendeeditor.
Tryck Delete för att ta bort det markerade steget; referenser till det tas bort från de återstående stegens beroenden.

I inspektören kan du också redigera stegets beskrivning, roll och utdataschema. Redigeringar sparas automatiskt som en ny revision efter en kort paus; ett valideringsfel (som visas i godkännandefältet) blockerar sparandet tills du åtgärdar det.

Endast arbetssteg kan redigeras. Strukturella noder – forskning, diskussion och syntes – är skrivskyddade, och detsamma gäller alla steg vars arbete redan har körts (det markeras “Redan körd”, eftersom en redigering skulle förgrena planen).

Sparandet använder optimistisk samtidighetskontroll mot den revision du utgick från. Om orkestreraren omplanerar under dig avvisas din sparade version med “planen har gått vidare” i stället för att slås samman eller tyst skrivas över; läs om den aktuella revisionen och gör om redigeringen. Agentinitierade omplaneringar begränsas dessutom till en varannan minut, så det här förblir ovanligt.

Läs uppskattningar av kostnad, tid och risk

Tryck på Uppskatta i godkännandefältet.

Varje steg på duken får en bricka med ett kostnadsintervall och urvalsstorleken bakom det, eller “Ingen historik ännu” när stegets roll aldrig har körts. Markera ett steg för alla detaljer i inspektören: kostnadsintervall med urvalsstorlek, ett varaktighetsintervall och en spridningsradie (filer och symboler) härledd från stegets härkomst – eller “okänd” när steget inte har någon härkomst.
Godkännandefältet visar planens totalsumma: ett övergripande kostnadsintervall, ett varaktighetsintervall för den kritiska vägen (parallella grenar överlappar, så det är inte summan) och budgettaket när planen anger ett.
Om bara vissa steg har historik markeras summan som delvis och omfattar bara de steg som går att uppskatta. Om uppskattningens övre gräns överstiger budgettaket blir summan röd med en varning om att budgeten överskrids.

Uppskattningar är ärliga eller saknas helt: ett steg vars roll inte har någon historik över slutförda körningar rapporterar urvalsstorleken noll utan några intervall alls och visas som okänt i stället för att gissas fram. Behandla “Ingen historik ännu” som “ingen vet”, inte som “billigt”.

Budgettaket är en visuell jämförelse mot den här uppskattningen. Ingenting upprätthåller det när planen väl körs – se Hantera kostnader för kontroller som faktiskt stoppar utgifter.

Diffa en revision mot ett tidigare förslag

Varje redigering och varje omplanering av orkestreraren läggs till i en revisionstidslinje som bara växer, och som visas i panelen Versioner till vänster i en orkestreringsplan.

Klicka på en revision för att diffa den mot det aktuella förslaget. Utan markering diffar panelen den föregående revisionen mot den aktuella.
Läs diffen i panelens nedre halva: steg som lagts till, tagits bort eller ändrats mellan de två revisionerna.
Om planen fortfarande är proposed klickar du på spolningsikonen på en revision för att gå tillbaka till den. En spolning tillbaka sparar det förslaget som en ny revision – ingenting går förlorat.

propose_orchestration och redigeraren avvisar båda ändringar när planen inte längre är proposed, så en pågående körning plockar inte upp en omplanering mitt i körningen.

Godkänn, avvisa eller utöka en plan

I appen är en föreslagen plan ett enda beslut som fattas i sin helhet: Godkänn plan eller Avvisa i godkännandefältet. Godkänn plan godkänner alltid varje steg – det finns inget sätt att först välja en delmängd. Godkännandet blockeras medan förslaget har valideringsfel, som visas bredvid knapparna.

Att godkänna är förbehållet en operatör. Det finns inget MCP-verktyg för det, så en agent kan föreslå och revidera en plan men aldrig godkänna en.

När en orkestrering körs ändras fältet:

Om ett steg stannade för att fråga mitt i körningen markerar du det och trycker på Fortsätt nod för att återuppta det.
Tryck på Godkänn valda för att utöka ett delvis godkännande till det markerade steget plus allt det transitivt beror på (ett steg kan aldrig godkännas utan sina beroenden). Kontrollen finns i körningsfältet för varje orkestrering; den har ingen verkan när planen godkändes i sin helhet.
Tryck på Avbryt körning för att stoppa hela orkestreringen.

Steg utanför en delvis godkänd mängd renderas som uppskjutna och körs inte förrän du utökar mängden.

Kör en playbook med parametrar

En playbook är en sparad planmall med typade platshållare av formen {{param}} i sitt mål, sina stegtitlar, beskrivningar och prompter. Ersättningen är litteral – det finns inget uttrycksspråk; behöver du logik använder du en pipeline i stället.

I navets avsnitt Playbooks trycker du på Kör på playbooken (eller öppnar ⌘K-paletten och väljer playbooken där).
Fyll i parametrarna. Uppräkningsparametrar renderas som rullgardinsmenyer; repo- och agentparametrar tar en repo- eller agentreferens; valfria parametrar faller tillbaka på sitt standardvärde.
Välj det ankarsärende som planen föreslås mot och bekräfta sedan.

Att köra en playbook föreslår bara en plan – den instansierade orkestreringen öppnas i Plan Studio som proposed och ingenting körs förrän du godkänner den där. För att ta bort en playbook trycker du på papperskorgsikonen på dess kort.

Agenter skapar och kör playbooks med MCP-verktygen create_playbook och run_playbook; se MCP-verktygsreferensen.

Relaterade guider

Använd planläge: hur en agent tar fram ett plandokument med submit_plan
Kör en orkestrering: livscykeln med ett enda godkännande sett från samtalet
Skapa en pipelinemall: när du behöver logik som en playbook inte kan uttrycka
Övervaka pipelinekörningar: motorvyn över en godkänd plan

Relaterade koncept

Orkestrering