Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Inleiding tot overdrachten tussen meerdere agenten

Les 12 van 18 Bijgewerkt op 3 november 2026 Ontwikkelaar
Op deze pagina
  1. Waarom meerdere agenten orchestreren?
  2. Hoe overdrachten werken
  3. Typische architectuur
  4. Uitvoeringsmodi
  5. Output-gebeurtenissen
  6. Belangrijkste punten

Waarom meerdere agenten orchestreren?

Tot nu toe heeft u gewerkt met individuele agenten: één agent, zijn instructies, zijn tools. Dit model stoot snel op grenzen wanneer een taak heterogene vaardigheden vereist. Neem bijvoorbeeld een verzoek voor marktonderzoek: u moet gegevens zoeken, deze numeriek analyseren en vervolgens een leesbaar rapport produceren. U zou alles aan één enkele agent kunnen toevertrouwen, maar de instructies zwellen dan bij elke nieuwe eis aan tot een tegenstrijdige tekstblok dat het model steeds minder effectief toepast. De Mistral API biedt een alternatief: ketens van gespecialiseerde agenten die het stokje doorgeven.

Dit is het concept van een overdracht (handoff): één agent draagt de controle over het gesprek over aan een andere agent die beter uitgerust is voor de huidige deeltaak. Het gesprek zelf verandert niet; alleen de hand die de teugels vasthoudt, wisselt.

Hoe overdrachten werken

Het mechanisme weerspiegelt exact wat een menselijke organisatie doet wanneer deze wordt geconfronteerd met een samengesteld verzoek. Een router-agent ontvangt de initiële vraag, vergelijkbaar met een telefoniste die een oproep aanneemt. Deze analyseert het verzoek, identificeert welke specialist-agent het beste gepositioneerd is om het af te handelen, en draagt vervolgens het gesprek over aan die specialist. De specialist voert zijn deeltaak uit en kan, als hij een behoefte tegenkomt die buiten zijn reikwijdte valt, het gesprek overdragen aan een derde agent. Het uiteindelijke antwoord stroomt terug naar de gebruiker, die slechts één gesprekspartner ziet.

Hieruit volgen vier voordelen die elkaar versterken. Ten eerste specialisatie: elke agent heeft een beperkte reikwijdte en precieze instructies. De webzoek-agent voert geen berekeningen uit, en omgekeerd. Dit verbetert de kwaliteit van het antwoord omdat geen enkele instructie een andere tegenspreekt. Ten tweede onderhoudbaarheid: het gedrag van een specialist wijzigen heeft geen invloed op anderen. U kunt het model, de instructies of de tools ervan vervangen zonder de rest van het systeem aan te raken. Ten derde volgt hier direct schaalbaarheid uit: een nieuwe mogelijkheid toevoegen betekent het creëren van een nieuwe specialist-agent en deze registreren als doelwit voor overdracht. De router selecteert deze vervolgens wanneer het verzoek overeenkomt. Tot slot traceerbaarheid: elke overdracht genereert een agent.handoff-gebeurtenis in de outputs, waardoor u achteraf kunt reconstrueren welke agent welk deel van het verzoek heeft afgehandeld, zonder dat u zelf instrumentatie hoeft toe te voegen.

Typische architectuur

User
    │
    ▼
Router Agent (orchestrator)
    ├── Web Search Agent (web_search)
    ├── Calculator Agent (code_interpreter)
    ├── Writer Agent (specific instructions)
    └── Document Agent (document_library)

De router beslist dynamisch naar welke agent wordt overgedragen op basis van de vraag. Dit is niet beperkt tot één enkele overdracht: de router kan ook opeenvolgende stromen orchestreren, zoals zoeken, dan berekenen, dan schrijven, waarbij elke stap de context voor de volgende verrijkt.

Laten we een echt verzoek volgen: “Zoek de huidige ECB-rente en bereken het samengestelde effect over 10 jaar voor een investering van €100.000.” De Finance-agent, die optreedt als router, ontvangt het verzoek en ziet dat het twee verschillende behoeften bevat. Hij draagt eerst over aan de Web Search-agent, die de huidige ECB-rente ophaalt; een gegeven dat geen enkel model uit het geheugen kan kennen. Een tweede overdracht geeft de controle aan de Calculator-agent, die de formule voor samengestelde interest toepast op de zojuist gevonden rente. De gebruiker ontvangt één enkel resultaat, vergezeld van de zoekbronnen en berekeningsdetails.

Uitvoeringsmodi

De Mistral API biedt twee modi voor overdrachten, die u kiest bij het starten van het gesprek. Servermodus is de standaard.

response = client.beta.conversations.start(
    agent_id=router_agent.id,
    inputs="Complex query",
    handoff_execution="server"
)

Mistral regelt vervolgens alles automatisch: overdrachten, uitvoering door agenten en synthese van het antwoord. U ontvangt alleen het eindresultaat, wat handig en voldoende is zolang u niets tussen de stappen hoeft te voegen.

response = client.beta.conversations.start(
    agent_id=router_agent.id,
    inputs="Complex query",
    handoff_execution="client"
)

In clientmodus ontvangt u overdrachtgebeurtenissen en beslist u zelf wat er bij elke stap gebeurt. Kies deze modus wanneer een mens een gevoelige overdracht moet goedkeuren, wanneer u elke overdracht moet loggen voor auditdoeleinden, of wanneer uw bedrijfslogica routing vereist die het model niet kan afleiden. De les die specifiek aan deze twee modi is gewijd, zal de afwegingen in detail behandelen.

Output-gebeurtenissen

Wanneer een overdracht plaatsvindt, verschijnen er drie soorten gebeurtenissen in de outputs:

  • agent.handoff — Agent A draagt over aan Agent B (bevat beide agent-ID’s)
  • tool.execution — Agent B voert zijn tools uit
  • message.output — Het antwoord van Agent B
for entry in response.outputs:
    if entry.type == "agent.handoff":
        print(f"Transfer: {entry.previous_agent_id} → {entry.next_agent_id}")
    elif entry.type == "tool.execution":
        print(f"Tool executed: {entry.tool_name}")
    elif entry.type == "message.output":
        print(f"Response: {entry.content}")

Schrijf deze lus tijdens uw eerste proeven, zelfs voordat het systeem volledig is. Een multi-agent-systeem dat correct antwoordt, maar waarvan u het pad niet kunt traceren, wordt onmogelijk te repareren op de dag dat het foutief antwoordt: u weet dan niet of de router verkeerd heeft doorverwezen, of de specialist slecht heeft gepresteerd, of dat de overdracht ergens onderweg is verloren gegaan. Drie goed geplaatste print-statements behoeden u voor deze blindheid.

Belangrijkste punten

  • Met overdrachten kan een agent de controle overdragen aan een andere gespecialiseerde agent
  • Typische architectuur: router-agent → specialist-agenten
  • Servermodus = volledig automatisch; clientmodus = handmatige controle van overdrachten
  • Elke overdracht genereert een traceerbare gebeurtenis in de outputs
  • Er is geen limiet aan de ketendiepte tussen agenten