Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Introduzzjoni għat-Trasferimenti bejn Aġenti Multipli

Lezzjoni 12 / 18 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Għaliex tikkordina aġenti multipli?
  2. Kif jaħdmu t-trasferimenti (handoffs)
  3. Arkitettura tipika
  4. Modi ta’ eżekuzzjoni
  5. Avvenimenti tal-output
  6. Punti Ewlenin

Għaliex tikkordina aġenti multipli?

S’issa, ħdimt ma’ aġenti individwali: aġent wieħed, l-istruzzjonijiet tiegħu, l-għodod tiegħu. Dan il-mudell jilħaq il-limiti tiegħu malajr meta kompitu jeħtieġ ħiliet eteroġenji. Ħu, pereżempju, talba għal riċerka tas-suq: trid tfittex data, tanalizzaha numerikament, u mbagħad toħroġ rapport li jinqara. Tista’ tipprova tagħti kollox lil aġent wieħed, b’istruzzjonijiet li jikbru b’mod eċċessiv ma’ kull rekwiżit ġdid sakemm isiru blokk ta’ test kontradittorju li l-mudell japplika dejjem inqas b’mod effettiv. L-API ta’ Mistral toffri alternattiva: katini ta’ aġenti speċjalizzati li jgħaddu l-vanga.

Dan huwa l-kunċett ta’ handoff (trasferiment): aġent wieħed jittrasferixxi l-kontroll tal-konversazzjoni lil aġent ieħor imħarreġ aħjar għas-sottokompitu attwali. Il-konversazzjoni nnifisha ma tinbidilx—biss tinbidel l-id li qed iżżomm ir-riedni.

Kif jaħdmu t-trasferimenti (handoffs)

Il-mekkaniżmu jirrifletti eżattament dak li tagħmel organizzazzjoni umana meta tiffaċċja talba komposta. Aġent router (mogħdija) jirċievi l-mistoqsija inizjali, bħal operatur ta’ ċentralin li jwieġeb sejħa. Dan janalizza t-talba, jidentifika liema aġent speċjalista huwa fl-aħjar pożizzjoni biex jittrattaha, u mbagħad jittrasferixxi l-konversazzjoni lil dak l-ispeċjalista. L-ispeċjalista jittratta s-sottokompitu tiegħu u, jekk jiltaqa’ ma’ ħtieġa lil hinn mill-kamp ta’ applikazzjoni tiegħu, jista’ jittrasferixxi lil aġent ieħor. Ir-risposta finali terġa’ lura għand l-utent, li jara interlokutur wieħed biss.

Erba’ benefiċċji jirriżultaw minn dan, u jsaħħu lil xulxin. L-ewwel, speċjalizzazzjoni: kull aġent għandu kamp ta’ applikazzjoni limitat u istruzzjonijiet preċiżi. L-aġent tat-tiftix fuq il-web ma jittrattax kalkoli, u viċi versa. Dan itejjeb il-kwalità tar-risposta għax l-ebda istruzzjoni ma tikkontradixxi oħra. It-tieni, manutenzjonabbiltà: tibdil fl-imġiba ta’ speċjalista ma jaffettwax lill-oħrajn. Tista’ tbiddel il-mudell, l-istruzzjonijiet jew l-għodod tiegħu mingħajr ma tmiss il-bqija tas-sistema. It-tielet, skalebbiltà tiġi direttament wara—li żżid kapaċità tfisser li toħloq aġent speċjalista ġdid u tirreġistrah bħala mira għat-trasferiment. Ir-router imbagħad jagħżlu meta t-talba taqbel miegħu. Fl-aħħar nett, traċċabbiltà: kull trasferiment jiġġenera avveniment agent.handoff fl-outputs, u jħallik tirrikostruwixxi wara l-fatt liema aġent ittratta liema parti mit-talba mingħajr ma trid tistrumenta xejn int stess.

Arkitettura tipika

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

Ir-router jiddeċiedi dinamikament lil liema aġent jittrasferixxi abbażi tal-mistoqsija. Mhuwiex limitat għal trasferiment wieħed: jista’ wkoll jikkordina flussi sekwenzjali, bħal tfittxija imbagħad kalkolu imbagħad kittieb, fejn kull pass jarrikkixxi l-kuntest għal dak li jmiss.

Ejja nsegwu talba reali: “Sib ir-rata tal-imgħax attwali tal-BĊE u kkalkula l-effett kompost fuq 10 snin għal investiment ta’ €100K.” L-aġent tal-Finanzi, li jaġixxi bħala router, jirċievi t-talba u jara li fiha żewġ ħtiġijiet distinti. L-ewwel jittrasferixxi lill-aġent tat-Tiftix fuq il-Web, li jiġbor ir-rata attwali tal-BĊE—data li l-ebda mudell ma jista’ jaf mill-memorja. It-tieni trasferiment jgħaddi l-kontroll lill-aġent tal-Kalkolatur, li japplika l-formula tal-imgħax kompost għar-rata li għadha kemm instabet. L-utent jirċievi riżultat wieħed, akkumpanjat mis-sorsi tat-tiftix u d-dettalji tal-kalkolu.

Modi ta’ eżekuzzjoni

L-API ta’ Mistral toffri żewġ modi għat-trasferimenti, u inti tagħżel waqt il-bidu tal-konversazzjoni. Il-modalità tas-server hija d-default.

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

Mistral imbagħad jimmaniġġja kollox awtomatikament: it-trasferimenti, l-eżekuzzjoni tal-aġenti, u s-sinteżi tar-risposta. Int tirċievi biss ir-riżultat finali, li huwa konvenjenti u biżżejjed sakemm ma jkollokx bżonn tinterponi xi ħaġa bejn il-passi.

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

Fil-modalità tal-klijent, int tirċievi avvenimenti ta’ trasferiment (handoff events) u tiddeċiedi x’tagħmel f’kull pass. Agħżel dan il-mod meta bniedem irid japprova trasferiment sensittiv, meta jkollok bżonn tirreġistra kull trasferiment għal skopijiet ta’ awditjar, jew meta l-loġika tan-negozju tiegħek teħtieġ routing li l-mudell ma jistax jiddedduċi. Il-lezzjoni ddedikata għal dawn iż-żewġ modi se tiddettalja l-kompromessi.

Avvenimenti tal-output

Meta jseħħ trasferiment, tliet tipi ta’ avvenimenti jidhru fl-outputs:

  • agent.handoff — L-Aġent A jittrasferixxi lill-Aġent B (fih iż-żewġ ID tal-aġenti)
  • tool.execution — L-Aġent B jesegwixxi l-għodod tiegħu
  • message.output — Ir-risposta tal-Aġent 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}")

Ikteb dan iċ-ċiklu matul l-ewwel provi tiegħek, anke qabel ma s-sistema tkun kompluta. Sistema multi-aġent li twieġeb b’mod korrett iżda li l-mogħdija tagħha ma tistax tiġi traċċata ssir impossibbli biex tissewwa l-jum li twieġeb ħażin: ma tkunx taf jekk ir-routerx idderieġa ħażin, jekk l-ispeċjalista wettaq ħażin, jew jekk it-trasferiment intilifx fit-triq. Tliet stqarrijiet print imqiegħda sew ifarrfuk minn din l-għamja.

Punti Ewlenin

  • It-trasferimenti (handoffs) jħallu lill-aġent jittrasferixxi l-kontroll lil aġent speċjalizzat ieħor
  • Arkitettura tipika: aġent router → aġenti speċjalisti
  • Modalità server = awtomatika kompletament; modalità client = kontroll manwali tat-trasferimenti
  • Kull trasferiment jiġġenera avveniment traċċabbli fl-outputs
  • M’hemm l-ebda limitu għall-fond tal-katina bejn l-aġenti