Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Úvod do odovzdávania medzi viacerými agentmi

Lekcia 12 z 18 Aktualizované 3. novembra 2026 Vývojár
Na tejto strane
  1. Prečo orchestrácia viacerých agentov?
  2. Ako funguje odovzdávanie (handoff)
  3. Typická architektúra
  4. Režimy vykonávania
  5. Výstupné udalosti
  6. Kľúčové poznatky

Prečo orchestrácia viacerých agentov?

Doteraz si pracoval s jednotlivými agentmi: jeden agent, jeho inštrukcie, jeho nástroje. Tento model rýchlo narazí na svoje limity, keď úloha vyžaduje rôznorodé zručnosti. Vezmi si napríklad požiadavku na prieskum trhu: potrebuješ vyhľadať údaje, numericky ich analyzovať a následne vyprodukovať čitateľnú správu. Mohol by sa pokúsiť zveriť všetko jedinému agentovi s inštrukciami, ktoré by sa s každou novou požiadavkou nafukovali, až by sa stali protirečivým blokom textu, ktorý model aplikuje čoraz menej efektívne. Mistral API ponúka alternatívu: reťazce špecializovaných agentov, ktorí si odovzdávajú štafetu.

To je podstata konceptu handoff (odovzdanie): jeden agent prenesie kontrolu nad konverzáciou na iného agenta, ktorý je lepšie vybavený na aktuálnu čiastkovú úlohu. Samotná konverzácia sa nemení – mení sa iba ruka, ktorá drží opraty.

Ako funguje odovzdávanie (handoff)

Mechanizmus presne zrkadlí to, čo robí ľudská organizácia pri riešení zloženej požiadavky. Agent smerovač (router agent) prijme počiatočnú otázku, podobne ako operátor na ústredni, ktorý prijíma hovor. Analyzuje požiadavku, identifikuje, ktorý špecializovaný agent je na jej vybavenie najvhodnejší, a následne prevedie konverzáciu na tohto špecialistu. Špecialista vybaví svoju čiastkovú úlohu a ak narazí na potrebu presahujúcu jeho rozsah, môže konverzáciu odovzdať tretiemu agentovi. Konečná odpoveď putuje späť k používateľovi, ktorý vidí iba jedného interlocutora.

Z toho vyplývajú štyri výhody, ktoré sa navzájom posilňujú. Po prvé, špecializácia: každý agent má obmedzený rozsah a presné inštrukcie. Agent na webové vyhľadávanie nerobí výpočty a naopak. To zlepšuje kvalitu odpovedí, pretože sa žiadna inštrukcia navzájom nevylučuje. Po druhé, udržateľnosť: zmena správania špecialistu nemá vplyv na ostatných. Môžeš vymeniť jeho model, inštrukcie alebo nástroje bez toho, aby si sa dotkol zvyšku systému. Po tretie, priamo z toho vyplýva škálovateľnosť – pridanie novej schopnosti znamená vytvorenie nového špecializovaného agenta a jeho registráciu ako cieľa odovzdania. Smerovač ho potom vyberie, keď požiadavka zodpovedá jeho profilu. Nakoniec, vysledovateľnosť: každé odovzdanie generuje v výstupoch udalosť agent.handoff, čo ti umožňuje dodatočne zrekonštruovať, ktorý agent vybavil ktorú časť požiadavky, bez potreby vlastného inštrumentovania.

Typická architektúra

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

Smerovač dynamicky rozhoduje, ktorému agentovi konverzáciu odovzdá, na základe dotazu. Nie je obmedzený na jediné odovzdanie: môže tiež orchestrácia sekvenčné toky, ako napríklad vyhľadávanie, potom výpočet a nakoniec písanie, pričom každý krok obohacuje kontext pre ten nasledujúci.

Poďme si nasledovať reálnu požiadavku: „Nájdi aktuálnu úrokovú sadzbu ECB a vypočítaj zložený úrok za 10 rokov pre investíciu 100 000 €.“ Finančný agent, ktorý vystupuje ako smerovač, prijme požiadavku a vidí, že obsahuje dve odlišné potreby. Najprv ju odovzdá agentovi na webové vyhľadávanie, ktorý získa aktuálnu sadzbu ECB – údaj, ktorý žiadny model nemôže poznať z pamäte. Druhé odovzdanie prenesie kontrolu na Kalkulačného agenta, ktorý aplikuje vzorec pre zložené úročenie na práve nájdenú sadzbu. Používateľ dostane jeden výsledok, sprevádzaný zdrojmi vyhľadávania a detailmi výpočtu.

Režimy vykonávania

Mistral API ponúka dva režimy pre odovzdávanie a ty si vyberáš pri štarte konverzácie. Predvolený je serverový režim.

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

Mistral potom automaticky vybaví všetko: prevody, vykonávanie agentov a syntézu odpovede. Dostaneš iba konečný výsledok, čo je pohodlné a postačujúce, pokiaľ nepotrebuješ medzi kroky nič vkladať.

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

V klientskom režime dostávaš udalosti odovzdania a ty rozhoduješ, čo robiť v každom kroku. Tento režim si vyber, keď musí človek schváliť citlivý prevod, keď potrebuješ logovať každé odovzdanie na účely auditu, alebo keď tvoja business logika vyžaduje smerovanie, ktoré model nedokáže odvodiť. Lekcia venovaná týmto dvom režimom podrobne rozoberie kompromisy medzi nimi.

Výstupné udalosti

Keď dôjde k odovzdaniu, vo výstupoch sa objavia tri typy udalostí:

  • agent.handoff — Agent A odovzdáva Agentovi B (obsahuje ID oboch agentov)
  • tool.execution — Agent B vykonáva svoje nástroje
  • message.output — Odpoveď agenta 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}")

Napíš si tento cyklus počas svojich prvých pokusov, ešte predtým, než bude systém kompletný. Viacagentový systém, ktorý odpovedá správne, ale ktorého cestu nedokážeš vysledovať, sa stane neopraviteľným v deň, keď odpovie zle: nebudeš vedieť, či smerovač zle nasmeroval, či špecialista podal zlý výkon, alebo či sa odovzdanie niekde stratilo. Tri dobre umiestnené príkazy print ťa zachránia pred touto slepotou.

Kľúčové poznatky

  • Odovzdávanie umožňuje agentovi preniesť kontrolu na iného špecializovaného agenta
  • Typická architektúra: agent smerovač → špecializovaní agenti
  • Serverový režim = plne automatický; klientsky režim = manuálna kontrola prevodov
  • Každé odovzdanie generuje vo výstupoch vysledovateľnú udalosť
  • Neexistuje limit na hĺbku reťazenia medzi agentmi