Jobb i Plan Studio

Denne veiledningen viser hvordan du jobber med planer i Plan Studio. For hva orkestreringer og plandokumenter er, se Orkestrering og Bruk planmodus.

Åpne en plan

En plan hører til samtalen som produserte den, så det er der du vanligvis finner den: raden for planen i samtalen har en Åpne-handling, og Plan Studio åpnes som en redigeringsfane ved siden av samtalen.

Navet viser tre seksjoner:

Aktive planer — orkestreringer, foreslåtte først, med status, antall steg og revisjonsnummer.
Plandokumenter — planer en enkelt agent sendte inn med submit_plan i planmodus, mens de er foreslått eller godkjent.
Playbooks — lagrede, parametriserte planmaler.

Klikk på et kort for å åpne det i Plan Studio. Ruten er /workspaces/<workspace-id>/plans/<kind>/<plan-id>, der kind er orchestration eller document, så du kan dypelenke til en enkelt plan også.

Hvis du åpnet en orkestrering, får du det redigerbare lerretet, versjonstidslinjen og godkjenningslinjen. Hvis du åpnet et plandokument, tegnes den samme grafen skrivebeskyttet — plandokumenter er skrevet av agenter; du gjennomgår, estimerer og godkjenner eller avviser dem, og et godkjent dokument viser kjøringstilstanden per node i sanntid fra orkestreringen det ble kompilert til.

Rediger DAG-en

Endringer er mulige på en orkestrering så lenge den er proposed. Alle endringer på lerretet gjøres med tastaturet:

Klikk på lerretet, og flytt markeringen med piltastene.
Trykk n for å legge til et steg. Det vises markert som «Nytt steg»; gi det nytt navn i inspektøren til høyre.
Trykk e på steget som må kjøre først, og klikk deretter på steget som avhenger av det (eller velg det og trykk Enter) for å koble til en avhengighet. Trykk Esc for å forkaste en ventende kobling.
Trykk x for å klippe den nyeste avhengigheten til det valgte steget, eller slå bestemte avhengigheter av og på i avhengighetsredigeringen i inspektøren.
Trykk Delete for å fjerne det valgte steget; referanser til det fjernes fra avhengighetene til de gjenværende stegene.

I inspektøren kan du også redigere beskrivelsen, rollen og utdataskjemaet til steget. Endringer lagres automatisk som en ny revisjon etter en kort pause; en valideringsfeil (vist i godkjenningslinjen) blokkerer lagringen til du retter den.

Bare arbeidssteg kan redigeres. Strukturelle noder — forskning, diskusjon og syntese — er skrivebeskyttet, og det samme er alle steg der arbeidet allerede har kjørt (det merkes «allerede utført», fordi redigering ville forgrene planen).

Lagring bruker optimistisk samtidighet mot revisjonen du startet fra. Hvis orkestratoren omplanlegger under deg, avvises lagringen med «planen har gått videre» i stedet for å bli slått sammen eller overskrevet i stillhet; les den gjeldende revisjonen på nytt og gjør endringen om igjen. Omplanlegginger som agenter setter i gang, er selv begrenset til én hvert andre minutt, så dette skjer sjelden.

Les estimater for kostnad, tid og risiko

Trykk Estimer i godkjenningslinjen.

Hvert steg på lerretet får et merke med et kostnadsintervall og utvalgsstørrelsen bak det, eller «Ingen historikk ennå» når rollen til steget aldri har kjørt. Velg et steg for alle detaljene i inspektøren: kostnadsintervall med utvalgsstørrelse, et varighetsintervall og en sprengningsradius (filer og symboler) utledet fra opphavet til steget — eller «ukjent» når steget ikke har noe opphav.
Godkjenningslinjen viser totalen for planen: et samlet kostnadsintervall, et varighetsintervall for den kritiske stien (parallelle grener overlapper, så dette er ikke summen) og budsjettaket når planen angir ett.
Hvis bare noen steg har historikk, merkes totalen som delvis og dekker bare de estimebare stegene. Hvis den høye enden av estimatet overstiger budsjettaket, blir totalen rød med en advarsel om over budsjett.

Estimatene er ærlige eller fraværende: et steg der rollen ikke har historikk fra fullførte kjøringer, rapporterer en utvalgsstørrelse på null uten intervaller i det hele tatt og vises som ukjent i stedet for å gjettes. Behandle «Ingen historikk ennå» som «ingen vet», ikke som «billig».

Budsjettaket er en visuell sammenligning mot dette estimatet. Ingenting håndhever det når planen først kjører — se Administrer kostnader for kontroller som faktisk stopper forbruket.

Sammenlign en revisjon med et tidligere forslag

Hver endring og hver omplanlegging fra orkestratoren legges til i en revisjonstidslinje som bare vokser, vist i Versjoner-panelet til venstre i en orkestreringsplan.

Klikk på en revisjon for å sammenligne den med det gjeldende forslaget. Uten noe valg sammenligner panelet den forrige revisjonen med den gjeldende.
Les diffen i den nedre halvdelen av panelet: steg som er lagt til, fjernet eller endret mellom de to revisjonene.
Hvis planen fortsatt er proposed, klikker du på spoleikonet på en revisjon for å gå tilbake til den. Spoling lagrer det forslaget som en ny revisjon — ingenting går tapt.

propose_orchestration og redigeringen avviser begge endringer når planen ikke lenger er proposed, så en kjøring som er i gang, plukker ikke opp en omplanlegging midt i kjøringen.

Godkjenn, avvis eller utvid en plan

I appen er en foreslått plan én beslutning, tatt som helhet: Godkjenn plan eller Avvis i godkjenningslinjen. Godkjenn plan godkjenner alltid hvert steg — det finnes ingen måte å velge ut en delmengde først. Godkjenning er blokkert så lenge forslaget har valideringsfeil, som vises ved siden av knappene.

Godkjenning er forbeholdt operatøren. Det finnes ikke noe MCP-verktøy for det, så en agent kan foreslå og revidere en plan, men aldri godkjenne en.

Når en orkestrering kjører, endres linjen:

Hvis et steg stoppet for å spørre midt i kjøringen, velger du det og trykker Fortsett node for å gjenoppta det.
Trykk Godkjenn valgte for å utvide en delvis godkjenning til det valgte steget pluss alt det avhenger av transitivt (et steg kan aldri godkjennes uten avhengighetene sine). Kontrollen finnes på kjøringslinjen for alle orkestreringer; den gjør ingenting når planen ble godkjent som helhet.
Trykk Avbryt kjøring for å stoppe hele orkestreringen.

Steg utenfor et delvis godkjent sett vises som utsatte og kjører ikke før du utvider settet.

Kjør en playbook med parametere

En playbook er en lagret planmal med typede {{param}}-plassholdere i målet, stegetitlene, beskrivelsene og promptene. Substitusjonen er bokstavelig — det finnes ikke noe uttrykksspråk; hvis du trenger logikk, bruker du en pipeline i stedet.

I Playbooks-seksjonen i navet trykker du Kjør på playbooken (eller åpner ⌘K-paletten og velger playbooken der).
Fyll inn parameterne. Oppregningsparametere vises som nedtrekkslister; repo- og agentparametere tar en repo- eller agentreferanse; valgfrie parametere faller tilbake til standardverdien.
Velg ankersaken planen foreslås mot, og bekreft.

Å kjøre en playbook foreslår bare en plan — den instansierte orkestreringen åpnes i Plan Studio som proposed, og ingenting utføres før du godkjenner den der. For å fjerne en playbook trykker du på søppelbøtteikonet på kortet.

Agenter oppretter og kjører playbooks med MCP-verktøyene create_playbook og run_playbook; se MCP-verktøyreferansen.

Relaterte veiledninger

Bruk planmodus: hvordan en agent lager et plandokument med submit_plan
Kjør en orkestrering: livssyklusen med én godkjenning, sett fra samtalen
Opprett en pipeline-mal: når du trenger logikk en playbook ikke kan uttrykke
Overvåk pipeline-kjøringer: motorens visning av en godkjent plan

Relaterte konsepter

Orkestrering