Eżekuzzjoni fuq is-Server vs. fuq il-Klijent
F'din il-paġna
Lezzjoni aġġornata fit-3 ta’ Novembru 2026 abbażi tal-SDK
mistralai3.7.0 u d-dokumentazzjoni tal-Handoffs ta’ Mistral: dħulagent.handoffjidentifika l-aġent fil-mira permezz ta’next_agent_id(mhuxto_agent), uconversations.appendma jaċċettax parametruagent_id—kodiċi antik ikun ifalli. Ir-riattivazzjoni tal-aġent fil-mira hawnhekk issir permezz ta’ konversazzjoni ġdida, li fiha tgħaddi l-kuntest. Sorsi: Handoffs · client-python.
Żewġ Modi biex Timmaniġġja t-Trasferimenti
Meta aġent jittrasferixxi l-kontroll lil aġent ieħor, l-API ta’ Mistral toffri żewġ modi ta’ eżekuzzjoni: server (awtomatiku) u client (manwali). L-impostazzjoni hija kelma waħda biss, iżda tiddetermina min jiċċaqlaq il-fluss tax-xogħol fil-prattika. Fil-mod server, tiddelega l-koreografija kollha lil Mistral u tirċievi r-riżultat. Fil-mod client, terġa’ tikseb il-kontroll bejn kull pass. Kollox ieħor—l-aġenti, l-għodod tagħhom, il-miri tat-trasferiment tagħhom—jibqa’ eżattament l-istess.
Il-Mod Server, id-Default
response = client.beta.conversations.start(
agent_id=router_agent.id,
inputs="Analyze and calculate market trends.",
handoff_execution="server" # Default — can be omitted
)
Il-fluss huwa ġestit kompletament: ir-router jirċievi t-talba, jiddeċiedi li jittrasferixxi lill-aġent tar-riċerka, u Mistral jesegwixxi t-trasferiment; l-aġent tar-riċerka jagħmel ix-xogħol tiegħu mbagħad jittrasferixxi lill-kalkulatur, u Mistral jesegwixxi dan ukoll; il-kalkulatur jipproduċi r-riżultat. Inti tirċievi r-risposta finali, akkumpanjata mill-output intermedjarju kollu—allara tara x’ġara, iżda wara l-fatt.
Dan il-mod għandu tliet kwalitajiet li jispjegaw għaliex huwa d-default. Huwa sempliċi, peress li ma tikteb l-ebda loġika ta’ kontroll fuq in-naħa tiegħek. Huwa mgħaġġel, għax il-katina kollha tesegwixxi f’Mistral mingħajr vjaġġi round-trip tan-netwerk f’kull rilè. Huwa affidabbli, hekk kif l-immaniġġjar tal-iżbalji u l-iskadenzi (timeouts) bejn l-aġenti huma ġestiti għalik.
Il-limitazzjonijiet tiegħu huma l-kontroparti eżatta. M’għandek l-ebda kontroll intermedjarju: impossibbli li tivvalida jew timmodifika trasferiment waqt li jseħħ. L-ispiża hija opaka, fis-sens li l-aġenti kollha fil-katina jesegwixxu mingħajr ma tkun tista’ tinterrrompi talba f’nofs il-fluss li qed tmur f’direzzjoni mhux meħtieġa. U ma tista’ daħħal l-ebda loġika personalizzata bejn il-passi—l-ebda reġistrazzjoni (logging) dettaljata, l-ebda validazzjoni, l-ebda deċiżjoni tan-negozju.
Il-Mod Client, Meta Trid il-Kontroll
response = client.beta.conversations.start(
agent_id=router_agent.id,
inputs="Analyze the cloud market.",
handoff_execution="client"
)
Ir-router jirċievi t-talba u jiddeċiedi li jittrasferixxi, eżattament bħal qabel. Iżda minflok it-trasferiment jesegwixxi, inti tirċievi avveniment agent.handoff u l-katina tieqaf hemmhekk. Jiddependi minnek li terġa’ tibdilha billi ssejjaħ lill-aġent fil-mira—li jħallik il-libertà li tivvalida, tirreġistra, tarrikkixxi l-kuntest, jew sempliċiment tirrifjuta.
response = client.beta.conversations.start(
agent_id=router_agent.id,
inputs="Search for the latest tech news.",
handoff_execution="client"
)
for entry in response.outputs:
if entry.type == "agent.handoff":
target_agent_id = entry.next_agent_id
print(f"Handoff requested to: {target_agent_id}")
# Validate, then hand over to the target agent, with useful context
next_response = client.beta.conversations.start(
agent_id=target_agent_id,
inputs="Search for the latest tech news.",
)
# Process the target agent's response
for next_entry in next_response.outputs:
print(f"{next_entry.type}: {next_entry.content}")
Punt wieħed jixraq attenzjoni: id-dokumentazzjoni ta’ Mistral tiddeskrivi l-mod client—il-kontroll jerġa’ lura għandek fil-ħin tat-trasferiment—iżda ma tipprovdi l-ebda metodu biex l-aġent fil-mira jkompli l-istess konversazzjoni, u conversations.append ma jaċċettax parametru agent_id. Għalhekk, l-eżempju jibda konversazzjoni mal-aġent fil-mira, li lilu tgħaddi espliċitament dak li għandu bżonn: it-talba oriġinali, u jekk applikabbli, sommarju ta’ dak li diġà sar. Din hija wkoll opportunità biex tgħaddi biss dak li għandhom jaraw.
Is-snippet ta’ hawn fuq jimmaniġġja rilè wieħed biss. Katina reali torbot diversi, li jsejjaħ għal loop.
def execute_with_control(router_id, query):
"""Executes a multi-agent workflow with control at each step."""
response = client.beta.conversations.start(
agent_id=router_id,
inputs=query,
handoff_execution="client"
)
conversation_id = response.conversation_id
results = []
while True:
handoff_found = False
for entry in response.outputs:
if entry.type == "agent.handoff":
handoff_found = True
target = entry.next_agent_id
print(f"[LOG] Handoff to {target}")
# Here you can add: validation, logging, metrics
response = client.beta.conversations.start(
agent_id=target,
inputs=query, # the original request, enriched if needed
handoff_execution="client",
)
conversation_id = response.conversation_id
break
elif entry.type == "message.output":
results.append(entry.content)
if not handoff_found:
break
return results
L-istruttura hija dik ta’ pompa: sakemm jidher trasferiment fl-outputs, tipproċessah u terġa’ tibda; malli iterazzjoni tal-loop ma ssib l-ebda wieħed, il-katina tispiċċa u toħroġ bil-messaġġi akkumulati. Il-kumment fin-nofs jimmarka l-post li jiġġustifika dan il-mod kollu: huwa hemmhekk, u biss hemmhekk, li l-kodiċi tiegħek jinterponi ruħu bejn żewġ aġenti.
L-Għażla Bejn iż-Żewġ
Il-mod server ikopri l-produzzjoni standard. Jekk il-fluss tax-xogħol tiegħek huwa prevedibbli, jekk tifda l-aġenti li ktibt, jew jekk qed tipprototipa u trid tara r-riżultati malajr, l-awtomazzjoni sħiħa hija l-għażla t-tajba—u li tikteb loop ta’ kontroll ikun sforz mitluf.
Il-mod client huwa ġġustifikat malli rekwiżit estern jidħol fil-katina. Validazzjoni umana, meta operatur irid japprova trasferiment lil aġent li jattiva azzjonijiet sensittivi. Ħtieġa għar-reġistrazzjoni u l-awditjar, meta l-konformità teħtieġ li ttraċċa kull pass bl-identifikaturi tiegħek stess u l-marki tal-ħin tiegħek stess. Ir-rotta kondizzjonali, meta d-deċiżjoni tiddependi fuq regoli tan-negozju li l-mudell ma jistax ikun jaf—status tal-klijent, ħin tal-ġurnata, kwota. Limitu massimu (cap), jew limitazzjoni tar-rata (rate limiting), meta trid tillimita n-numru ta’ aġenti eżegwiti għal talba. Strateġija ta’ ripjieg (fallback), finalment, meta l-falliment ta’ aġent wieħed irid jattiva xi ħaġa oħra ħlief żball ippreżentat lill-utent.
Hawnhekk hawn x’jidher l-ewwel waħda minn dawn is-sitwazzjonijiet, imnaqqsa għall-qafas tagħha.
def workflow_with_validation(router_id, query):
response = client.beta.conversations.start(
agent_id=router_id,
inputs=query,
handoff_execution="client"
)
for entry in response.outputs:
if entry.type == "agent.handoff":
target = entry.next_agent_id
approval = input(f"Authorize transfer to {target}? (y/n) ")
if approval.lower() == "y":
response = client.beta.conversations.start(
agent_id=target,
inputs=query,
)
else:
print("Transfer refused.")
break
L-input tal-console jservi bħala dimostrazzjoni; f’applikazzjoni, se jiġi sostitwit b’avviż lil operatur u bir-riattivazzjoni tal-fluss tax-xogħol meta tasib ir-risposta. Il-prinċipju jibqa’ l-istess: it-trasferiment iseħħ biss jekk il-kodiċi tiegħek jattivah.
L-approċċ it-tajjeb huwa li tibda bil-mod server u tibdel biss il-jum li fih restrizzjoni speċifika teħtieġu. Li tibdel għall-mod client “għal kull każ” iħallsek tħallas immedjatament għall-kumplessità ta’ loop u vjaġġi round-trip tan-netwerk, għal kontroll li għadek ma qed tużax.
Punti Ewlenin
- Mod Server = awtomatiku kompletament, sempliċi u mgħaġġel, l-ebda kontroll intermedjarju
- Mod Client = inti tirċievi avvenimenti ta’ trasferiment u tiddeċiedi x’tagħmel
- Il-mod client jippermetti validazzjoni, reġistrazzjoni (logging), rotta kondizzjonali, u ġestjoni tal-iżbalji
- Għall-biċċa l-kbira tal-każijiet, il-mod server huwa biżżejjed—ibdel għall-mod client meta jkollok bżonn il-kontroll
- Iż-żewġ modi jappoġġjaw l-istess ktajjen ta’ aġenti; biss il-kontroll ivarja