Izpilde serverī vai klientā
Šajā lapā
Nodarbība atjaunināta 2026. gada 3. novembrī, pamatojoties uz
mistralaiSDK 3.7.0 un Mistral Handoffs dokumentāciju: ierakstsagent.handoffidentificē mērķa aģentu, izmantojotnext_agent_id(nevisto_agent), unconversations.appendnepieņem parametruagent_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