Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Sissejuhatus mitme agendi vahelistesse üleandmistesse

Õppetund 12 / 18 Värskendatud 3. november 2026 Arendajatele
Sellel lehel
  1. Miks orkestreerida mitut agenti?
  2. Kuidas üleandmised toimivad
  3. Tüüpiline arhitektuur
  4. Täitmise režiimid
  5. Väljundi sündmused
  6. Peamised punktid

Miks orkestreerida mitut agenti?

Seni oled töötanud üksikute agentidega: üks agent, selle juhised, selle tööriistad. See mudel jõuab kiiresti piiridesse, kui ülesanne nõuab heterogeenseid oskusi. Võtame näiteks turu-uuringu taotluse: pead otsima andmeid, analüüsima neid numbriliselt ja koostama seejärel loetava aruande. Võid proovida usaldada kõike ühele agendile, kuid selle juhised paisuvad iga uue nõudega, kuni muutuvad vastuoluliseks tekstiplokiks, mida mudel rakendab üha vähem efektiivselt. Mistral API pakub alternatiivi: spetsialiseerunud agentide ahelad, mis annavad teatepulga edasi.

See on üleandmise (handoff) kontseptsioon: üks agent annab vestluse juhtimise üle teisele agendile, kes on antud alamülesande jaoks paremini varustatud. Vestlus ise ei muutu – muutub vaid ohjad käes hoidev käsi.

Kuidas üleandmised toimivad

Mehhanism peegeldab täpselt seda, mida inimene organisatsioonis teeb liitküsimusega silmitsi seistes. Ruuter-agent saab algse päringu, nagu telefonikeskuse operaator kõne vastu võttes. See analüüsib taotlust, tuvastab, milline spetsialist-agent on selle lahendamiseks parimas positsioonis, ja annab vestluse sellele spetsialistile üle. Spetsialist lahendab oma alamülesande ja kui ta kohtab vajadust, mis ületab tema pädevust, võib ta vestluse edasi anda kolmandale agendile. Lõplik vastus jõuab tagasi kasutajani, kes näeb ainult üht vestluspartnerit.

Sellest tuleneb neli eelist, mis tugevdavad üksteist. Esiteks, spetsialiseerumine: igal agendil on piiratud ulatus ja täpsed juhised. Veebiotsingu agent ei tegele arvutustega ja vastupidi. See parandab vastuste kvaliteeti, sest ükski juhis ei ole teisele vastuolus. Teiseks, hooldatavus: spetsialisti käitumise muutmine ei mõjuta teisi. Saad vahetada selle mudelit, juhiseid või tööriistu, puutumata ülejäänud süsteemi. Kolmandaks, skaleeritavus tuleneb sellest otseselt – uue võimekuse lisamine tähendab uue spetsialist-agendi loomist ja selle registreerimist üleandmise sihtmärgina. Ruuter valib selle siis, kui taotlus sobib. Lõpuks, jälgitavus: iga üleandmine genereerib väljundites sündmuse agent.handoff, võimaldades sul tagantjärele rekonstrueerida, milline agent millist taotluse osa käsitles, ilma et peaksid ise instrumenteerima.

Tüüpiline arhitektuur

Kasutaja
    │
    ▼
Ruuter-agent (orkestraator)
    ├── Veebiotsingu agent (web_search)
    ├── Kalkulaatori agent (code_interpreter)
    ├── Kirjutaja agent (spetsiifilised juhised)
    └── Dokumendi agent (document_library)

Ruuter otsustab dünaamiliselt, millisele agendile üle anda, lähtudes päringust. See ei piirdu ühe üleandmisega: see saab orkestreerida ka järjestikuseid vooge, nagu otsing, seejärel arvutus ja seejärel kirjutamine, kus iga samm rikastab järgmise jaoks konteksti.

Järgime üht reaalset taotlust: “Leia EKP praegune intressimäär ja arvuta liitintressi mõju 10 aasta jooksul 100 000 € investeeringule.” Finantsagent, toimides ruuterina, saab taotluse ja näeb, et see sisaldab kahte erinevat vajadust. Esiteks annab ta vestluse üle veebiotsingu agendile, mis toob välja praeguse EKP määra – andme, mida ükski mudel ei saa mälust teada. Teine üleandmine annab juhtimise kalkulaatori agendile, mis rakendab leitud määrale liitintressi valemit. Kasutaja saab ühe tulemuse, millele on lisatud otsingu allikad ja arvutuse üksikasjad.

Täitmise režiimid

Mistral API pakub üleandmisteks kahte režiimi, mille valid vestluse käivitamisel. Serverirežiim on vaikevalik.

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

Mistral haldab seejärel kõike automaatselt: üleandmisi, agentide käivitamist ja vastuste sünteesi. Saad ainult lõpptulemuse, mis on mugav ja piisav, seni kuni sa ei pea sammude vahele midagi lisama.

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

Kliendirežiimis saad üleandmise sündmused ja otsustad iga sammu juures, mida teha. Vali see režiim, kui inimene peab heaks kiitma tundliku üleandmise, kui pead auditi eesmärgil logima iga üleandmise või kui sinu äriloogika nõuab marsruutimist, mida mudel ei suuda järeldada. Nendele kahele režiimile pühendatud õppetund kirjeldab üksikasjalikumalt kompromisse.

Väljundi sündmused

Kui üleandmine toimub, ilmuvad väljunditesse kolme tüüpi sündmused:

  • agent.handoff — Agent A annab üle agendile B (sisaldab mõlema agendi ID-sid)
  • tool.execution — Agent B käivitab oma tööriistad
  • message.output — Agendi B vastus
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}")

Kirjuta see tsükkel oma esimeste katsete ajal, isegi enne, kui süsteem on valmis. Mitme agendiga süsteem, mis vastab õigesti, kuid mille teekonda sa ei saa jälgida, muutub võimatuks parandada päeval, mil see vastab valesti: sa ei tea, kas ruuter suunas valesti, kas spetsialist tegi halva töö või kas üleandmine kadus kusagil teel. Kolm õigesti paigutatud print-lauset päästavad sind sellest pimedusest.

Peamised punktid

  • Üleandmised võimaldavad agendil anda juhtimine üle teisele spetsialiseerunud agendile
  • Tüüpiline arhitektuur: ruuter-agent → spetsialist-agendid
  • Serverirežiim = täielikult automaatne; kliendirežiim = üleandmiste manuaalne juhtimine
  • Iga üleandmine genereerib väljundites jälgitava sündmuse
  • Agentide vahelises aheldamises puudub sügavuse piirang