Subagent

Wat is een Subagent?

Een subagent is een kind-agent die een lead-agent spawnt om één afgebakende taak te behandelen in een apart contextvenster. Hij ontvangt een briefing, werkt onafhankelijk met zijn eigen tools en instructies, en geeft alleen zijn resultaat terug. De ouder houdt zijn eigen context schoon terwijl de subagent de verkennende ruis absorbeert. Anthropics onderzoekssysteem is op dit idee gebouwd, en start 3 tot 5 subagents parallel op, elk in zijn eigen contextvenster, om een complexe query te behandelen [1].

De belangrijkste punten

• Het kernvoordeel is context-isolatie. Een subagent kan vijftig bestanden lezen en twintig commando's draaien, en de ouder ontvangt een antwoord van drie alinea's in plaats van al dat ruwe materiaal.
• Een subagent weet alleen wat zijn briefing bevat. Hij erft niet het gesprek van de ouder, dus produceert vage delegatie zelfverzekerde antwoorden op de verkeerde vraag.
• Subagents kunnen andere rechten, modellen, en instructies dragen dan hun ouder, wat ze een natuurlijke eenheid maakt voor least-privilege-ontwerp en kostenbeheersing.
• Ze passen bij taken met een duidelijk opleverbare. Open-einde samenwerking over veel beurten is de taak van de ouder; een subagent schittert bij "zoek X uit en rapporteer terug."

Hoe het werkt

Wanneer een lead-agent beslist dat een stuk werk delegatie verdient, spawnt hij een subagent met een taakomschrijving. Het platform start een verse agentinstantie: nieuw contextvenster, een rolprompt, en welke toolgang de configuratie ook verleent. Projectniveau-instructiebestanden zoals CLAUDE.md of AGENTS.md laden meestal nog steeds, dus kent het kind de codebase-conventies ook al zag het nooit het gesprek van de ouder. De subagent draait dan zijn eigen lus, redeneert en gebruikt tool calling tot de taak klaar is, en geeft een eindrapport terug. De ouder leest dat rapport en gaat verder.

Dit mechanisme is wat hiërarchische agentorchestratie praktisch maakt. Lange taken putten één contextvenster uit; onderzoek, audits, en verificatie delegeren aan subagents betekent dat de dure ouderlijke context alleen beslissingen en resultaten bevat. Het maakt ook parallellisme mogelijk, want een ouder kan meerdere subagents tegelijk uitsturen en hun rapporten verzamelen naarmate ze klaar zijn. In Anthropics systeem sneed het parallel draaien van subagents met parallelle tool calling onderzoekstijd met tot 90% voor complexe queries [2]. Moderne AI-coding-agent-platforms stellen dit direct bloot: Claude Code heeft zijn Task-tool en genoemde agentdefinities, en andere frameworks bieden equivalente spawn-en-rapporteer-primitieven.

Configuratie is waar teams hefboomwerking krijgen. Een subagent gedefinieerd voor codereview kan een goedkoper model draaien met read-only-bestandstoegang, terwijl een migratiewerker schrijftoegang krijgt maar een strak mapbereik. Omdat de rechten van elk kind apart gedeclareerd zijn, dienen subagents dubbel als AI-guardrails: de verkennende agent die niet-vertrouwde webcontent aanraakt, kan de credentials geweigerd worden die de ouder bezit.

Voorbeeld

Een engineer vraagt een coding-agent een verouderde feature flag te verwijderen uit een grote codebase. De lead-agent spawnt drie subagents parallel: één doorzoekt de backend naar elke lezing van de flag en classificeert elke call site, één doet hetzelfde voor de frontend, en één controleert infrastructuurcode en dashboards op verwijzingen. Elk kind leest tientallen bestanden, maar elk geeft alleen een gestructureerde lijst locaties terug met een aanbevolen bewerking. De ouder, wiens context nu drie nette rapporten bevat in plaats van een paar honderd bestandsuittreksels, plant de verwijdering, maakt de bewerkingen zelf, en spawnt één laatste subagent om de testsuite te draaien en mislukkingen samen te vatten. De hele taak voltooit binnen één ouder-sessie die zonder delegatie twee keer zou zijn overgelopen.

Veelvoorkomende misvattingen

De hardnekkige misvatting is dat een subagent de kennis van de ouder deelt. Engineers schrijven briefings zoals "fix het probleem dat we bespraken" en zijn verrast wanneer het kind zijn eigen interpretatie verzint, want het kind zag de discussie nooit. Alles wat de subagent nodig heeft moet in de briefing reizen: het doel, de relevante paden, beperkingen, en het verwachte outputformaat. Teams die de briefing als een miniatuurspec behandelen krijgen betrouwbare delegatie; teams die het als een chatbericht behandelen krijgen aannemelijk werk aan het verkeerde probleem, en de fout komt vaak pas naar boven nadat de ouder erop heeft voortgebouwd.

FAQ

Wanneer moet een agent subagents spawnen in plaats van het werk zelf te doen? Wanneer het werk de context van de ouder zou overspoelen met materiaal zonder blijvende waarde (brede zoekopdrachten, loganalyse, grote-bestandslezingen), wanneer onafhankelijke stukken parallel kunnen draaien, of wanneer de taak andere rechten of een ander model nodig heeft. Voor kleine, sequentiële bewerkingen voegt delegatie overhead toe zonder voordeel. Wanneer de fit goed is, is de winst groot: een lead-agent die delegeert aan Claude Sonnet 4-subagents versloeg single-agent Claude Opus 4 met 90,2% op Anthropics interne onderzoekseval, tegen een kost van ongeveer 15x de tokens van een chatinteractie [3].

Praten subagents met elkaar? Meestal niet direct. In de meeste implementaties rapporteert elk kind aan de ouder, en geeft de ouder door welke context de volgende taak nodig heeft. Peer-to-peer-ontwerpen bestaan in een breder multi-agentsysteem, maar het ouder-bemiddelde patroon is makkelijker te traceren en debuggen.

Hoe verschilt een subagent van gewoon een tool aanroepen? Een tool-aanroep voert één vaste operatie uit. Een subagent draait een volledige agentic lus, en kiest zijn eigen reeks tool-aanroepen om aan een doel te voldoen. De praktische grens: gebruik een tool wanneer je de operatie kent, gebruik een subagent wanneer je alleen de uitkomst kent die je wilt.

Bronnen

1. Anthropic. "Onderzoekssysteem start 3-5 subagents parallel op, elk in zijn eigen contextvenster." https://www.anthropic.com/engineering/built-multi-agent-research-system. Geraadpleegd augustus 2026.
2. Anthropic. "Parallelle subagents en parallelle tool calling sneden onderzoekstijd met tot 90% voor complexe queries." https://www.anthropic.com/engineering/built-multi-agent-research-system. Geraadpleegd augustus 2026.
3. Anthropic. "Lead-agent met Claude Sonnet 4-subagents overtrof single-agent Claude Opus 4 met 90,2%, met ongeveer 15x de tokens van chat." https://www.anthropic.com/engineering/built-multi-agent-research-system. Geraadpleegd augustus 2026.