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

Eżekuzzjoni fuq is-Server vs. fuq il-Klijent

Lezzjoni 14 / 18 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Żewġ Modi biex Timmaniġġja t-Trasferimenti
  2. Il-Mod Server, id-Default
  3. Il-Mod Client, Meta Trid il-Kontroll
  4. L-Għażla Bejn iż-Żewġ
  5. Punti Ewlenin

Lezzjoni aġġornata fit-3 ta’ Novembru 2026 abbażi tal-SDK mistralai 3.7.0 u d-dokumentazzjoni tal-Handoffs ta’ Mistral: dħul agent.handoff jidentifika l-aġent fil-mira permezz ta’ next_agent_id (mhux to_agent), u conversations.append ma jaċċettax parametru agent_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