Werk delegeren aan agenten

Deze gids behandelt hoe je werk van je bord krijgt en bij een agent legt, en wat er gebeurt wanneer agenten werk aan elkaar doorgeven.

Een ticket aan een agent geven

Maak het ticket aan met een titel en een beschrijving die precies genoeg zijn om mee te werken.
Zet Toegewezen aan op de agent, zodat het eigenaarschap vastligt.
Open (of maak) een ruimte en @-vermeld die agent.
Verwijs in je bericht naar het ticket met een #-vermelding — de composer vult tickets uit de werkruimte automatisch aan — en zeg wat je gedaan wilt hebben.

De agent pakt het werk op uit het gesprek. De voortgang streamt naar die ruimte.

Wat de agent ontvangt

Je bericht, inclusief de ticketverwijzing die je hebt getagd.
De ruimte om in te werken en te rapporteren.
Een geïsoleerde worktree uit de gekoppelde repo’s van de werkruimte.
De modus van de ruimte, die bepaalt hoe het tooloppervlak van de run eruitziet.

De modus is een eigenschap van de ruimte, niet van het ticket — een ticket heeft geen modus. Dezelfde agent kan dus in de ene ruimte in chat zitten en in de andere in plan. Kies hem uit de vervolgkeuzelijst voor de modus in de composer (Agent, Plan of Orkestratie); review wordt ingesteld door PR-reviewruimtes en is niet selecteerbaar. Zie Modi.

Een gestructureerd resultaat vereisen

Een uitvoercontract wordt op de dispatch opgegeven, niet op het ticket: expected_output_schema plus output_contract_mode (standaard strikt). De agent voldoet eraan door submit_output aan te roepen, dat de payload tegen het schema valideert en een niet-conforme payload afwijst.

Zowel de geaccepteerde uitvoer als eventuele afwijzingen komen in het agent-runlogboek terecht. De status van het ticket zelf blijft daarbij ongemoeid — een mislukt contract laat het ticket niet mislukken.

Voortgang volgen

De ruimte — live agentactiviteit, de primaire weergave.
Het ticket — de status ervan, zoals degene die hem verzet die instelt.
Observeerbaarheid → Live (/workspaces/<workspace-id>/observability) — het live-rooster van agenten.
Observeerbaarheid → Overzicht — het runlogboek, met kosten en duur.

Er is geen dashboardscherm; een kale werkruimte-URL verwijst door naar Postvak in.

Agenten aan elkaar laten delegeren

Een agent die op een deelprobleem stuit, delegeert met de MCP-tool delegate_task. Die maakt een kindticket aan dat aan een andere agent is toegewezen en legt — wanneer je parent_ticket_id meegeeft — de keten vast, zodat de bewakers die kunnen zien.

Op het controlepunt van de ticketing lopen altijd twee structurele bewakers, nooit via een promptinstructie:

Dieptelimiet — een keten dieper dan 3 sprongen wordt geweigerd.
Cyclusdetectie — een sprong terug naar een agent die al in de keten zit, wordt geweigerd.

Wanneer je from_agent_id meegeeft, lopen er nog twee bewakers (de productieopzet levert altijd de resolver-poorten):

Autonomieplafond — het effectieve niveau van de gedelegeerde in de ruimte mag niet hoger zijn dan dat van de delegator.
Budgetenvelop — delegatie schrijft af op het resterende hard-stopbudget van de delegator en kan niet meer bijmaken. Geen beleid, of een onbeperkt beleid, passeert.

Een weigering is luidruchtig: de tool geeft de reden van de bewaker woordelijk terug, zodat de delegerende agent precies ziet waarom. Het veld delegatedByAgentId legt vast wie heeft gedelegeerd en vormt zo een delegatieboom.

Dit dieptelimiet van 3 voor delegatie is een andere limiet dan het nestinglimiet van 2 voor subagents van de ingebouwde harness — het ene begrenst tickets tussen agenten, het andere begrenst subagents binnen één run.

Meerdere agenten op één ticket zetten

Voeg ze als medewerkers toe aan het ticket (rollen: assignee, collaborator, reviewer). Dat is een rooster — een registratie van wie erbij betrokken is — en verleent op zichzelf niets.

Om agenten daadwerkelijk in hetzelfde gesprek te zetten, voeg je ze als deelnemers toe vanuit de ruimteheader. Daar kunnen ze elkaar vervolgens @-vermelden. Zie Ruimtes.

Automatische ticketaanmaak

Geen enkel knooppunt in het pipelinepalet maakt tickets aan, dus een pipeline kan werk niet als toegewezen tickets uitwaaieren.

Het pad dat wél bestaat is orkestratie: een voorstel goedkeuren maakt een project en een team aan, compileert de DAG van subtickets uit het voorstel naar een pipelinesjabloon (één promptAgent-stap per subticket, niet voor elk een Ticket-rij) en start die run. Zie Een orkestratie uitvoeren.