Een orkestratie uitvoeren

In deze gids zie je hoe je één groot doel omzet in een plan voor het hele team dat zichzelf uitvoert. Zie Orkestratie voor hoe het werkt.

Wanneer je een orkestratie gebruikt

Kies een orkestratie wanneer de vraag groter is dan één agent en je de exacte stappen nog niet kent. Voor één taak stuur je een bericht naar een agent in een ruimte; voor een proces dat je met de hand kunt uitschrijven, bouw je een pipeline-sjabloon.

Stap 1: Vraag om het plan

Open (of maak) een ruimte en een Anker-ticket. Elk voorstel vereist er één (propose_orchestration neemt ticket_id); de gedeelde ruimte komt uit dat ticket.
Schakel optioneel de modusdropdown van de composer om naar Orkestratie. Die modus beperkt de agent tot lezen en voorstellen — geheugen, de codegraph, het lezen van repo’s en tickets, propose_orchestration en de playbook-tools — zodat hij niet code gaat schrijven in plaats van te plannen.
@-vermeld je orchestrator (meestal de CEO-agent) en noem het doel in gewone taal:

@ceo Onderzoek het concurrentielandschap voor een offline-first vergaderrecorder en schrijf een positioneringsdocument van één pagina.

De orchestrator antwoordt met een gestructureerde voorstelkaart in de ruimte: de rollen die hij nodig heeft, het werk opgesplitst in subtickets, een optionele onderzoeks- en discussiefase, een synthesestap die het eindresultaat oplevert en een budget.

Omdat het voorstel een getypeerd object is, valideert de app het (correct gevormde rollen, gedeclareerde uitvoerschema’s, een DAG zonder cycli) voordat er iets draait. Een voorstel dat de validatie niet doorstaat, kan niet worden goedgekeurd.

Stap 2: Beoordeel en bewerk het voorstel

De kaart in de chat biedt drie acties: Plan goedkeuren, Afwijzen en Openen — waarmee je het plan in Plan Studio opent als editortab. De kaart zelf kun je niet bewerken.

Om iets te wijzigen druk je op Openen en werk je in de inspecteur aan de rechterkant:

Titel, beschrijving, rol, afhankelijkheden en uitvoerschema van elke werkstap. Rol betekent hier welke van de bestaande rolsleutels van het plan eigenaar is van de stap — je kunt een rol niet vastpinnen op een met naam genoemde agent en je kunt de lijst met aanstellingen niet bewerken vanuit de inspecteur, en je kunt het budget niet bewerken.

Twee dingen zijn alleen-lezen: structurele knooppunten (onderzoek, discussie, synthese) en elk knooppunt waarvan het werk al is uitgevoerd. Bewerken kan alleen zolang de orkestratie nog proposed is.

Druk op Schatten in de goedkeuringsbalk voor bereiken voor kosten, duur en impactstraal voordat je je vastlegt. Zie Werken in Plan Studio voor de volledige editor.

Stap 3: Keur goed

Keur het plan goed, vanaf de kaart in de chat of vanaf de goedkeuringsbalk van Plan Studio. Dit is de enige beslissing die je neemt. Goedkeuren is alleen voor de operator — er is geen MCP-tool voor, dus een agent kan een plan voorstellen en herzien, maar nooit zijn eigen plan goedkeuren.

Vanaf hier zet een deterministische materialisator (een pure functie, geen LLM) het voorstel om in een echte pipeline en maakt hij de structuur aan:

werft nieuwe rollen aan (en legt de id’s van de aangenomen agents vast, zodat een crash halverwege de goedkeuring kan hervatten zonder dubbele aanstellingen)
groepeert de rollen in een team
maakt een project aan en brengt het bovenliggende ticket daarin onder
start de pipeline-run die alles aanstuurt

De status gaat naar approved en dan naar executing.

Stap 4: Volg de uitvoering

De subtickets worden uitgevoerd als pipeline-stappen; als je een discussieronde hebt ingeschakeld, plaatst elke rol eerst een standpunt. De voortgang verschijnt op de plekken waar je al kijkt:

het bovenliggende ticket waarop de orkestratie was verankerd
de gedeelde ruimte waarin het team praat, waar de rij van het plan de status van elk knooppunt volgt
de details van de pipeline-run, met de gebruikelijke tijdlijn en de kosten per stap — zie Pipeline-runs monitoren
het project waarin het bovenliggende ticket is ondergebracht

Zodra de subtickets klaar zijn, gaat de status naar synthesizing en levert de synthesestap het eindresultaat op. Die tekst wordt in de gedeelde ruimte geplaatst en het bovenliggende ticket wordt als voltooid gemarkeerd, en daarna completed.

Vroegtijdig stoppen

Druk op Orkestratie annuleren op de kaart in de chat, of op Uitvoering annuleren in de goedkeuringsbalk van Plan Studio. Annuleren breekt het werk af dat nog loopt.

Een orkestratie mislukt wanneer de materialisatie mislukt, of wanneer de run van de gegenereerde pipeline mislukt (onderzoek, discussie, synthese of persist — die stappen gaan niet door als ze mislukken). Gegenereerde werkstappen gaan altijd door als ze mislukken, dus één mislukt subticket laat de run niet mislukken. Er is geen faalpad voor budgetoverschrijding en geen drempel waarbij “elk subticket is mislukt”.

Gerelateerde gidsen

Werken in Plan Studio: het plan bewerken, schatten, diffen en goedkeuren
Tickets maken en beheren: het bovenliggende ticket waarop een orkestratie is verankerd
Werk organiseren met projecten: waar het bovenliggende ticket wordt ondergebracht
Pipeline-runs monitoren: hoe een gematerialiseerde orkestratie er in de engine uitziet
Een agententeam opbouwen: de rollen die een orkestratie invult of aanwerft