Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Izpilde serverī vai klientā

Nodarbība 14 no 18 Atjaunota 2026. gada 3. novembris Programmētājs
Šajā lapā
  1. Divi veidi, kā apstrādāt nodošanu
  2. Servera režīms: noklusējuma variants
  3. Klienta režīms, kad tev nepieciešama kontrole
  4. Izvēle starp abiem
  5. Galvenās atziņas

Nodarbība atjaunināta 2026. gada 3. novembrī, pamatojoties uz mistralai SDK 3.7.0 un Mistral Handoffs dokumentāciju: ieraksts agent.handoff identificē mērķa aģentu, izmantojot next_agent_id (nevis to_agent), un conversations.append nepieņem parametru agent_id—vecs kods neizdotos. Mērķa aģenta darbības atsākšana šeit notiek, izveidojot jaunu sarunu, kurai nodod kontekstu. Avoti: Handoffs · client-python.

Divi veidi, kā apstrādāt nodošanu

Kad viens aģents nodod vadību citam, Mistral API piedāvā divus izpildes režīmus: serveri (automātisku) un klientu (manuālu). Iestatījums ir tikai viens vārds, taču tas nosaka, kurš faktiski vada darbplūsmu. Servera režīmā tu uztici visu horeogrāfiju Mistral un saņem rezultātu. Klienta režīmā tu atgūsti kontroli starp katru soli. Viss pārējais—aģenti, to rīki, to nodošanas mērķi—paliek tieši tāds pats.

Servera režīms: noklusējuma variants

response = client.beta.conversations.start(
    agent_id=router_agent.id,
    inputs="Analyze and calculate market trends.",
    handoff_execution="server"  # Noklusējums — var izlaist
)

Plūsma tiek pilnībā pārvaldīta: maršrutētājs saņem pieprasījumu, nolemj nodot to pētniecības aģentam, un Mistral izpilda nodošanu; pētniecības aģents veic savu darbu, pēc tam nodod to kalkulatoram, un Mistral izpilda arī to; kalkulators ģenerē rezultātu. Tu saņem galīgo atbildi, ko papildina visi starpposma izvadi—tātad redzi, kas notika, bet tikai pēc fakta.

Šim režīmam ir trīs īpašības, kas izskaidro, kāpēc tas ir noklusējums. Tas ir vienkāršs, jo tev nav jāraksta nekāda vadības loģika savā pusē. Tas ir ātrs, jo visa ķēde izpildās pie Mistral bez tīkla aprites laika katrā pārsūtīšanas posmā. Tas ir uzticams, jo kļūdu apstrāde un noilgumi starp aģentiem tiek veikti tavā vietā.

Tā ierobežojumi ir precīzs šo priekšrocību pretstats. Tev nav starpposma kontroles: nav iespējams validēt vai modificēt nodošanu tās veikšanas brīdī. Izmaksas ir neskaidras tādā nozīmē, ka visi ķēdes aģenti izpildās, un tu nevari pārtraukt pieprasījumu, kas virzās nevajadzīgā virzienā. Un tu nevari ievietot pielāgotu loģiku starp soļiem—nav smalkgraudainas žurnālēšanas, validācijas vai biznesa lēmumu pieņemšanas.

Klienta režīms, kad tev nepieciešama kontrole

response = client.beta.conversations.start(
    agent_id=router_agent.id,
    inputs="Analyze the cloud market.",
    handoff_execution="client"
)

Maršrutētājs saņem pieprasījumu un nolemj veikt nodošanu, tieši tāpat kā iepriekš. Taču nodošanas vietā tu saņem notikumu agent.handoff, un ķēde šeit apstājas. Tev ir jāuzņemas iniciatīva, lai to atsāktu, izsaucot mērķa aģentu—kas dod tev iespēju validēt, žurnālēt, bagātināt kontekstu vai vienkārši atteikt.

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}")

        # Validē, tad nodod mērķa aģentam kopā ar noderīgu kontekstu
        next_response = client.beta.conversations.start(
            agent_id=target_agent_id,
            inputs="Search for the latest tech news.",
        )

        # Apstrādā mērķa aģenta atbildi
        for next_entry in next_response.outputs:
            print(f"{next_entry.type}: {next_entry.content}")

Viens punkts ir pelnījis uzmanību: Mistral dokumentācija apraksta režīmu client—kontrole atgriežas pie tevis nodošanas brīdī—taču nenorāda metodi, kā likt mērķa aģentam atsākt to pašu sarunu, un conversations.append nepieņem parametru agent_id. Tāpēc piemērā tiek uzsākta saruna ar mērķa aģentu, kam tu tieši nodod nepieciešamo: sākotnējo pieprasījumu un, ja nepieciešams, kopsavilkumu par to, kas jau ir paveikts. Tā ir arī iespēja nodot tikai to, ko viņam ir jāredz.

Iepriekšējais fragments apstrādā tikai vienu pārsūtīšanu. Reāla ķēde savieno vairākus, kas prasa ciklu.

def execute_with_control(router_id, query):
    """Izpilda daudz-aģentu darbplūsmu ar kontroli katrā solī."""
    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}")

                # Šeit vari pievienot: validāciju, žurnālēšanu, metrikas
                response = client.beta.conversations.start(
                    agent_id=target,
                    inputs=query,  # sākotnējais pieprasījums, vajadzības gadījumā bagātināts
                    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

Struktūra ir sūkņa veidā: kamēr izvados parādās nodošana, tu to apstrādā un atsāc; tiklīdz cikla iterācijā tāda netiek atrasta, ķēde ir pabeigta un tu izieci ar uzkrātajiem ziņojumiem. Komentārs vidū norāda vietu, kas attaisno visu šo režīmu: tieši tur un tikai tur tavs kods iestarpinās starp diviem aģentiem.

Izvēle starp abiem

Servera režīms aptver standarta ražošanu. Ja tava darbplūsma ir paredzama, ja uzticies aģentiem, kurus esi uzrakstījis, vai ja veido prototipu un vēlies ātri redzēt rezultātus, pilnīga automatizācija ir pareizā izvēle—un vadības cikla rakstīšana būtu lieks darbs.

Klienta režīms ir attaisnojams, tiklīdz ķēdē iesaistās ārēja prasība. Cilvēka validācija, kad operatoram ir jāapstiprina nodošana aģentam, kas izraisa sensitīvas darbības. Nepieciešamība pēc žurnālēšanas un auditēšanas, kad atbilstības prasības liek izsekot katram solim ar saviem identifikatoriem un saviem laika zīmogs. Nosacījummaršrutēšana, kad lēmums ir atkarīgs no biznesa noteikumiem, ko modelis nevar zināt—klienta statuss, diennakts laiks, kvota. Ierobežojums jeb ātruma ierobežojums, kad vēlies ierobežot pieprasījumam izpildīto aģentu skaitu. Visbeidzot, rezerves stratēģija, kad viena aģenta kļūmei ir jāizraisa kaut kas cits, nevis lietotājam parādīta kļūda.

Lūk, kā izskatās pirmā no šīm situācijām, reducēta līdz tās skeletam.

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

Konsoles input kalpo kā demonstrācija; lietojumprogrammā to aizstās paziņojums operatoram un darbplūsmas atsākšana, kad saņemta atbilde. Princips paliek tas pats: nodošana notiek tikai tad, ja to izraisa tavs kods.

Pareizā pieeja ir sākt servera režīmā un pāriet uz klientu tikai tajā dienā, kad konkrēts ierobežojums to prasa. Pāreja uz klientu režīmu „gadījumam, ja” liek tev uzreiz maksāt par cikla sarežģītību un tīkla aprites laiku par kontroli, kuru tu vēl neizmanto.

Galvenās atziņas

  • Servera režīms = pilnībā automātisks, vienkāršs un ātrs, bez starpposma kontroles
  • Klienta režīms = tu saņem nodošanas notikumus un lemj, ko darīt tālāk
  • Klienta režīms ļauj veikt validāciju, žurnālēšanu, nosacījummaršrutēšanu un kļūdu apstrādi
  • Vairumā gadījumu pietiek ar servera režīmu—pārej uz klientu režīmu, kad tev nepieciešama kontrole
  • Abi režīmi atbalsta tās pašas aģentu ķēdes; atšķiras tikai kontrole