AI orchestration: verdeel werk zonder de samenhang kwijt te raken

Drie agents werken aan één rapport. De eerste past de cijfers aan, de tweede schrijft conclusies op basis van de oude cijfers en de derde overschrijft hun gezamenlijke bestand. Er is veel activiteit, maar niemand weet welk resultaat leidend is.

AI orchestration is het coördineren van taken, afhankelijkheden en overdrachten tussen AI-onderdelen. Het belangrijkste ontwerpbesluit is vaak heel gewoon: welk werk kan tegelijk, en welk werk moet wachten op een gecontroleerd resultaat?

Orchestration bepaalt wie werk krijgt, welke informatie meegaat en wanneer het vervolg mag beginnen. Ook de toestand van de taak hoort erbij: bezig, opgeleverd, afgekeurd of onderbroken. Het gaat daarmee verder dan meerdere agents tegelijk starten.

Anthropic beschrijft verschillende samenwerkingspatronen, waaronder onafhankelijke parallelle taken en een coördinator die werk verdeelt. Die patronen zijn keuzemogelijkheden. Een taak met vaste afhankelijkheden kan juist overzichtelijk blijven met een vaste volgorde.

Op de begrippenpagina over orchestration staat de korte definitie. Hieronder bouwen we een productonafhankelijk werkplan voor één rapport, inclusief de afspraken die botsingen en onduidelijke overdrachten moeten voorkomen.

Neem een vereniging die een kwartaaloverzicht wil maken. Het rapport moet de verhuur van zalen en de onderhoudskosten beschrijven. De penningmeester is inhoudelijk eigenaar. Twee onderzoeksrollen kunnen afzonderlijke gegevens onderzoeken; een derde rol brengt de uitkomsten samen.

De opdracht is afgebakend: een conceptrapport over dezelfde drie maanden, met bronverwijzingen en open vragen. Niemand past de administratie aan of verstuurt het rapport. De eigenaar bepaalt vooraf welke boekingsdatum telt en hoe bedragen worden weergegeven. Zonder die afspraken kunnen twee correct uitgevoerde deeltaken alsnog onvergelijkbaar blijken.

De coördinatie kan door een mens of een geautomatiseerde voorziening gebeuren. De eisen aan input, output en eigenaarschap blijven in beide gevallen hetzelfde.

Rol één onderzoekt zaalgebruik. Input: de goedgekeurde verhuurexport voor het kwartaal en de definities van boeking en annulering. Output: een eigen resultaatbestand met aantallen per zaal, relevante uitzonderingen en verwijzingen naar de gebruikte regels. Deze rol doet geen uitspraken over kosten.

Rol twee onderzoekt onderhoud. Input: de kostenexport over dezelfde periode en de afgesproken kostencategorieën. Output: een afzonderlijk resultaatbestand met bedragen per categorie, onduidelijke boekingen en bronverwijzingen. Deze rol verandert de verhuurcijfers niet.

Rol drie integreert. Input: de geaccepteerde versies van beide resultaten en de rapportopzet. Output: één conceptrapport met gescheiden feiten, conclusies en vragen voor de penningmeester. Een ontbrekend resultaat blijft zichtbaar als ontbrekend; de integrator vult geen vermoedelijke cijfers in.

De verhuuronderzoeker kan rekenen terwijl de kostenonderzoeker categorieën controleert. Hun bronbestanden en resultaatbestanden zijn gescheiden. Dat is een zinvolle parallelle fase. Het schrijven van de gezamenlijke conclusie wacht totdat beide resultaten zijn beoordeeld.

De LangGraph-documentatie beschrijft parallelisatie voor onafhankelijke deeltaken. De afhankelijkheid blijft de toets: kan rol twee correct opleveren zonder te weten wat rol één straks verandert? Zo ja, dan kunnen ze naast elkaar werken.

Ontdekt de kostenonderzoeker dat een verhuurcategorie verkeerd is gedefinieerd, dan verandert hij niet zelf de gedeelde afspraak. Hij meldt de bevinding aan de eigenaar. Die bepaalt of de opdracht van beide rollen moet worden aangepast en welke resultaten opnieuw moeten worden berekend.

Leg vóór het starten vast wie welk bestand mag wijzigen. In dit voorbeeld bezit elke onderzoeker zijn eigen resultaatbestand. De integrator beheert het gezamenlijke rapport. De definitielijst blijft van de inhoudelijke eigenaar, tenzij die het beheer expliciet overdraagt.

Een bestandsclaim voorkomt niet elke inhoudelijke fout, maar maakt een botsing zichtbaar. Als twee rollen dezelfde tabel willen wijzigen, moet eerst duidelijk worden wie de wijziging uitvoert en wie controleert. Gelijktijdig in hetzelfde bestand schrijven is geen samenwerking op zichzelf.

Voor softwarewerk geldt hetzelfde principe bij een gedeeld datamodel of configuratiebestand. Onze AI-codinggids geeft de bredere bouwcontext. Parallel onderzoek kan prima, terwijl het toepassen van wijzigingen in gedeelde onderdelen één voor één gebeurt.

Stel dat de integrator stopt voordat het rapport af is. Een opvolger heeft meer nodig dan 'onderzoek klaar'. Hij moet de bronversies, de geaccepteerde resultaatbestanden, de al opgenomen onderdelen en de open kwesties kunnen terugvinden.

Bewaar daarom per taak een herkenbaar nummer, eigenaar, status, inputversie en resultaatverwijzing. 'Opgeleverd' betekent dat er een resultaat ligt; 'geaccepteerd' betekent dat de afgesproken controle is doorlopen. Dat verschil voorkomt dat een onvolledig bestand stilzwijgend de basis wordt voor een definitief rapport.

LangGraph beschrijft checkpoints om toestand vast te houden. Voor ons werkplan telt het onderliggende doel: hervatten vanaf gecontroleerde voortgang. De opvolger controleert eerst of de genoemde bestanden en versies werkelijk aanwezig zijn.

De integrator neemt eerst de verhuuruitkomst over en daarna de kostenuitkomst. Hij controleert of periode en definities overeenkomen. Een conclusie over hoge onderhoudskosten per verhuurdag kan pas ontstaan als de koppeling tussen beide tabellen inhoudelijk klopt.

De penningmeester beoordeelt vervolgens het hele rapport. Zijn afwijkingen verklaard? Zijn open vragen nog zichtbaar? Verwijzen conclusies naar de juiste cijfers? De integratiecontrole is eigen werk; twee goede deelresultaten bewijzen nog geen goed geheel.

Voeg pas meer rollen toe als dit werkplan daar een concrete reden voor heeft. Wil je taakverdeling, context en integratie aan je ontwikkelwerk koppelen, bekijk de cursus Claude Code voor gevorderden. Neem een taak mee die je in onafhankelijke resultaten kunt opdelen.