Izvajanje na strežniku ali odjemalcu
Na tej strani
Lekcija posodobljena 3. novembra 2026 na podlagi SDK
mistralairazličice 3.7.0 in dokumentacije Mistral Handoffs: vnosagent.handoffciljnega agenta identificira prekonext_agent_id(neto_agent), metodaconversations.appendpa ne sprejme parametraagent_id—starejša koda bi odpovedala. Nadaljevanje dela ciljnega agenta se tu zgodi v novem pogovoru, kateremu posreduješ kontekst. Viri: Handoffs · client-python.
Dva načina obravnave predaj
Ko agent predaja nadzor drugemu agentu, API Mistral ponuja dva načina izvajanja: strežniški (samodejni) in odjemalčev (ročni). Nastavitev je sestavljena iz ene same besede, vendar določa, kdo dejansko vodi delovni tok. V strežniškem načinu celotno koreografijo prepustiš Mistralu in prejmeš rezultat. V odjemalčevem načinu med vsakim korakom ponovno prevzameš nadzor. Vse ostalo—agenti, njihova orodja, njihovi cilji predaje—ostane popolnoma enako.
Strežniški način, privzeta izbira
response = client.beta.conversations.start(
agent_id=router_agent.id,
inputs="Analyze and calculate market trends.",
handoff_execution="server" # Default — can be omitted
)
Tok je v celoti upravljan: usmerjevalnik prejme zahtevo, se odloči za prenos na raziskovalnega agenta in Mistral izvede prenos; raziskovalni agent opravi svoje delo, nato pa ga prenese na kalkulator in Mistral izvede tudi to; kalkulator proizvede rezultat. Prejmeš končni odgovor, ki ga spremljajo vsi vmesni izpisi—torej vidiš, kaj se je zgodilo, vendar šele naknadno.
Ta način ima tri lastnosti, ki pojasnjujejo, zakaj je privzet. Preprost je, saj na svoji strani ne pišeš nobene logike za nadzor. Hiter je, ker se celotna veriga izvrši pri Mistralu brez omrežnih povratnih potovanj pri vsakem releju. Zanesljiv je, saj so za tebe poskrbljeni obravnava napak in časovne omejitve med agenti.
Njegove omejitve so natančno nasprotje tega. Nimaš vmesnega nadzora: med potekom predaje je nemogoče validirati ali spremeniti predajo. Stroški so nepregledni v smislu, da se vsi agenti v verigi izvršijo, ne da bi lahko sredi toka prekinil zahtevo, ki gre v nepotrebno smer. Med koraki ne moreš vstaviti nobene prilagojene logike—ni podrobnega beleženja, ni validacije, ni poslovnih odločitev.
Odjemalčev način, ko želiš nadzor
response = client.beta.conversations.start(
agent_id=router_agent.id,
inputs="Analyze the cloud market.",
handoff_execution="client"
)
Usmerjevalnik prejme zahtevo in se odloči za prenos, popolnoma kot prej. Namesto da bi se prenos izvršil, pa prejmeš dogodek agent.handoff in veriga se tu ustavi. Od tebe je odvisno, da jo ponovno zaženeš s klicem ciljnega agenta—kar ti pušča možnost validacije, beleženja, obogatitve konteksta ali preproste zavrnitve.
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}")
Ena točka si zasluži pozornost: dokumentacija Mistral opisuje način client—nadzor se ti vrne ob času prenosa—vendar ne ponuja metode, s katero bi ciljni agent nadaljeval isti pogovor, metoda conversations.append pa ne sprejme parametra agent_id. Primer zato začne pogovor s ciljnim agentom, kateremu izrecno posreduješ tisto, kar potrebuje: prvotno zahtevo in po potrebi povzetek tega, kar je bilo že opravljeno. To je tudi priložnost, da posreduješ le tisto, kar mora videti.
Zgornji izsek obravnava le en relej. Prava veriga povezuje več agentov, kar zahteva zanko.
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
Struktura deluje kot črpalka: dokler se v izpisih pojavi predaja, jo obdelaš in ponovno zaženeš; takoj ko iteracija zanke ne najde nobene, je veriga končana in izstopiš z zbranimi sporočili. Komentar na sredini označuje lokacijo, ki upravičuje celoten ta način: prav tu in samo tu se tvoja koda vstavi med dva agenta.
Izbira med obema
Strežniški način pokriva standardno proizvodnjo. Če je tvoj delovni tok predvidljiv, če zaupaš agentom, ki si jih napisal, ali če izdeluješ prototip in želiš hitro videti rezultate, je popolna avtomatizacija prava izbira—pisanje nadzorne zanke bi bilo izguba časa.
Odjemalčev način je upravičen takoj, ko se v verigo vključi zunanja zahteva. Človeška validacija, ko mora operater odobriti prenos na agenta, ki sproži občutljiva dejanja. Potreba po beleženju in reviziji, ko skladnost zahteva sledenje vsakemu koraku z lastnimi identifikatorji in časovnimi žigi. Pogojno usmerjanje, ko je odločitev odvisna od poslovnih pravil, ki jih model ne more poznati—status stranke, čas dneva, kvota. Omejitev ali omejevanje hitrosti, ko želiš omejiti število agentov, izvršenih za določeno zahtevo. Končno strategija nadomestnega delovanja, ko mora neuspeh enega agenta sprožiti nekaj drugega kot napako, prikazano uporabniku.
Tako izgleda prva od teh situacij, zreducirana na svoj skelet.
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
Vnos v konzoli input služi kot demonstracija; v aplikaciji ga bo nadomestilo obvestilo operaterju in nadaljevanje delovnega toka, ko prispe odgovor. Načelo ostaja enako: prenos se zgodi le, če ga sproži tvoja koda.
Pravilen pristop je začeti v strežniškem načinu in preklopiti šele tisti dan, ko specifična omejitev to zahteva. Preklop v odjemalčev način „za vsak slučaj” te takoj stane kompleksnosti zanke in omrežnih povratnih potovanj, za nadzor, ki ga še ne uporabljaš.
Ključne ugotovitve
- Strežniški način = popolnoma samodejen, preprost in hiter, brez vmesnega nadzora
- Odjemalčev način = prejmeš dogodke predaje in se odločiš, kaj storiti
- Odjemalčev način omogoča validacijo, beleženje, pogojno usmerjanje in obravnavo napak
- Za večino primerov je strežniški način zadosten—preklopi na odjemalčev način, ko potrebuješ nadzor
- Oba načina podpirata enake verige agentov; razlikuje se le nadzor