Werken in Plan Studio

Deze gids laat zien hoe je in Plan Studio met plannen werkt. Wat orkestraties en plandocumenten zijn, lees je in Orkestratie en Planmodus gebruiken.

Een plan openen

Een plan hoort bij het gesprek dat het heeft opgeleverd, dus daar kom je er normaal gesproken bij uit: de rij van het plan in het gesprek heeft een actie Openen en Plan Studio opent als editortab naast het gesprek.

De hub toont drie secties:

Actieve plannen — orkestraties, de voorgestelde eerst, met hun status, aantal stappen en revisienummer.
Plandocumenten — plannen die één agent met submit_plan heeft ingediend in planmodus, zolang ze voorgesteld of goedgekeurd zijn.
Playbooks — opgeslagen, geparameteriseerde plansjablonen.

Klik op een kaart om die in Plan Studio te openen. De route is /workspaces/<workspace-id>/plans/<kind>/<plan-id>, waarbij kind orchestration of document is, dus je kunt ook naar één plan deeplinken.

Als je een orkestratie hebt geopend, krijg je het bewerkbare canvas, de tijdlijn met versies en de goedkeuringsbalk. Als je een plandocument hebt geopend, wordt dezelfde graaf alleen-lezen weergegeven — plandocumenten zijn door agenten geschreven; je beoordeelt, schat en keurt ze goed of wijst ze af, en een goedgekeurd document toont de live runstatus per knooppunt uit de orkestratie waarin het is gecompileerd.

De DAG bewerken

Bewerkingen zijn mogelijk op een orkestratie zolang die proposed is. Alle canvasbewerkingen gaan via het toetsenbord:

Klik op het canvas en verplaats de selectie met de pijltoetsen.
Druk op n om een stap toe te voegen. Die verschijnt geselecteerd als “Nieuwe stap”; hernoem hem in de inspecteur aan de rechterkant.
Druk op e op de stap die eerst moet draaien en klik vervolgens op de afhankelijke stap (of selecteer die en druk op Enter) om een afhankelijkheid te verbinden. Druk op Esc om een openstaande verbinding te verbreken.
Druk op x om de nieuwste afhankelijkheid van de geselecteerde stap te kappen, of schakel exacte afhankelijkheden in en uit in de afhankelijkhedeneditor van de inspecteur.
Druk op Delete om de geselecteerde stap te verwijderen; verwijzingen ernaar worden uit de afhankelijkheden van de overige stappen gehaald.

In de inspecteur kun je ook de beschrijving, rol en het uitvoerschema van de stap bewerken. Bewerkingen worden na een korte pauze automatisch opgeslagen als een nieuwe revisie; een validatiefout (te zien in de goedkeuringsbalk) blokkeert het opslaan tot je die hebt opgelost.

Alleen werkstappen zijn bewerkbaar. Structurele knooppunten — onderzoek, discussie en synthese — zijn alleen-lezen, en dat geldt ook voor elke stap waarvan het werk al heeft gedraaid (die is gemarkeerd als “al uitgevoerd”, want bewerken zou het plan vertakken).

Opslaan gebeurt optimistisch gelijktijdig op de revisie waarmee je bent begonnen. Als de orchestrator onder je handen herplant, wordt je opslag geweigerd met “the plan moved on” in plaats van samengevoegd of stilzwijgend overschreven; lees de huidige revisie opnieuw en doe je bewerking opnieuw. Herplanningen die door een agent zijn gestart, zijn zelf beperkt tot één per twee minuten, dus dit blijft zeldzaam.

Kosten-, tijd- en risicoschattingen lezen

Druk op Schatten in de goedkeuringsbalk.

Elke stap op het canvas krijgt een badge met een kostenbereik en de steekproefgrootte erachter, of “Nog geen geschiedenis” wanneer de rol van de stap nooit heeft gedraaid. Selecteer een stap voor alle details in de inspecteur: kostenbereik met steekproefgrootte, een duurbereik en een impactstraal (bestanden en symbolen) afgeleid van de herkomst van de stap — of “onbekend” wanneer de stap geen herkomst heeft.
De goedkeuringsbalk toont het plantotaal: een algemeen kostenbereik, een duurbereik voor het kritieke pad (parallelle takken overlappen elkaar, dus dit is niet de som) en het budgetplafond wanneer het plan er een instelt.
Als alleen sommige stappen geschiedenis hebben, wordt het totaal gemarkeerd als gedeeltelijk en dekt het alleen de schatbare stappen. Als de bovengrens van de schatting het budgetplafond overschrijdt, wordt het totaal rood met een waarschuwing “boven budget”.

Schattingen zijn eerlijk of afwezig: een stap waarvan de rol geen geschiedenis van voltooide runs heeft, rapporteert een steekproefgrootte van nul zonder enige bereiken en wordt als onbekend getoond in plaats van gegokt. Zie “Nog geen geschiedenis” als “niemand weet het”, niet als “goedkoop”.

Het budgetplafond is een weergavevergelijking met deze schatting. Niets handhaaft het zodra het plan draait — zie Kosten beheren voor maatregelen die de uitgaven daadwerkelijk stoppen.

Een revisie vergelijken met een eerder voorstel

Elke bewerking en elke herplanning door de orchestrator wordt toegevoegd aan een alleen-toevoegende tijdlijn met revisies, te zien in het paneel Versies links van een orkestratieplan.

Klik op een revisie om die met het huidige voorstel te vergelijken. Zonder selectie vergelijkt het paneel de vorige revisie met de huidige.
Lees de diff in de onderste helft van het paneel: stappen die tussen de twee revisies zijn toegevoegd, verwijderd of gewijzigd.
Als het plan nog proposed is, klik je op het terugspoelpictogram bij een revisie om ernaar terug te gaan. Terugspoelen slaat dat voorstel op als een nieuwe revisie — er gaat niets verloren.

propose_orchestration en de editor weigeren beide wijzigingen zodra het plan niet meer proposed is, zodat een lopende run geen herplanning halverwege de uitvoering oppikt.

Een plan goedkeuren, afwijzen of verbreden

In de app is een voorgesteld plan één beslissing, in één keer genomen: Plan goedkeuren of Afwijzen in de goedkeuringsbalk. Plan goedkeuren keurt altijd elke stap goed — je kunt niet eerst een deelverzameling selecteren. Goedkeuren is geblokkeerd zolang het voorstel validatiefouten heeft, die naast de knoppen worden getoond.

Goedkeuren is alleen voor operators. Er is geen MCP-tool voor, dus een agent kan een plan voorstellen en herzien, maar nooit goedkeuren.

Zodra een orkestratie wordt uitgevoerd, verandert de balk:

Als een stap halverwege de run is gestopt om iets te vragen, selecteer je die en druk je op Knooppunt hervatten om hem te hervatten.
Druk op Selectie goedkeuren om een gedeeltelijke goedkeuring te verbreden naar de geselecteerde stap plus alles waarvan die transitief afhangt (een stap kan nooit worden goedgekeurd zonder zijn afhankelijkheden). Het element staat bij elke orkestratie op de uitvoeringsbalk; het doet niets wanneer het plan in zijn geheel is goedgekeurd.
Druk op Uitvoering annuleren om de hele orkestratie te stoppen.

Stappen buiten een gedeeltelijk goedgekeurde verzameling worden als uitgesteld weergegeven en draaien niet tot je de verzameling verbreedt.

Een playbook met parameters uitvoeren

Een playbook is een opgeslagen plansjabloon met getypeerde {{param}}- placeholders in het doel, de staptitels, beschrijvingen en prompts. Vervanging is letterlijk — er is geen expressietaal; als je logica nodig hebt, gebruik je in plaats daarvan een pipeline.

Druk in de sectie Playbooks van de hub op Uitvoeren bij het playbook (of open het ⌘K-palet en kies het playbook daar).
Vul de parameters in. Enumeratieparameters worden als keuzelijsten weergegeven; repo- en agentparameters nemen een repo- of agentverwijzing; optionele parameters vallen terug op hun standaardwaarde.
Kies het Anker-ticket waartegen het plan wordt voorgesteld en bevestig.

Een playbook uitvoeren stelt alleen een plan voor — de geïnstantieerde orkestratie opent in Plan Studio als proposed en er wordt niets uitgevoerd tot je het daar goedkeurt. Om een playbook te verwijderen, druk je op het prullenbakpictogram op zijn kaart.

Agenten maken en voeren playbooks uit met de MCP-tools create_playbook en run_playbook; zie de MCP-tools-referentie.

Gerelateerde gidsen

Planmodus gebruiken: hoe een agent met submit_plan een plandocument maakt
Een orkestratie uitvoeren: de levenscyclus met één goedkeuring vanuit het gesprek
Een pipeline-sjabloon maken: wanneer je logica nodig hebt die een playbook niet kan uitdrukken
Pipeline-runs monitoren: de engineweergave van een goedgekeurd plan

Gerelateerde concepten

Orkestratie