Izvršavanje na poslužitelju naspram klijentu
Na ovoj stranici
Lekcija ažurirana 3. studenog 2026. na temelju
mistralaiSDK verzije 3.7.0 i Mistralove dokumentacije o Handoffs: unosagent.handoffidentificira ciljnog agenta putemnext_agent_id(a neto_agent), aconversations.appendne prihvaća parametaragent_id—stariji kod bi failao. Ovdje se nastavak rada ciljnog agenta odvija kroz novi razgovor kojem prosljeđuješ kontekst. Izvori: Handoffs · client-python.
Dva načina rukovanja predajama
Kada agent preda kontrolu drugom agentu, Mistral API nudi dva načina izvršavanja: server (automatski) i client (ručni). Postavka je jedna jedina riječ, ali ona određuje tko zapravo upravlja tijekovima rada. U načinu rada sa serverom, cijelu koreografiju prepuštaš Mistralu i primaš rezultat. U načinu rada s klijentom, preuzimaš kontrolu između svakog koraka. Sve ostalo—agenti, njihovi alati, njihovi ciljevi predaje—ostaje potpuno isto.
Način rada sa serverom, zadana postavka
response = client.beta.conversations.start(
agent_id=router_agent.id,
inputs="Analyze and calculate market trends.",
handoff_execution="server" # Default — can be omitted
)
Tijek je u potpunosti upravljajan: usmjerivač (router) primi zahtjev, odluči prijeći na agenta za istraživanje i Mistral izvrši tu predaju; agent za istraživanje obavi svoj posao, a zatim preda kontrolu kalkulatoru, što Mistral također izvrši; kalkulator proizvede rezultat. Primaš konačni odgovor, popraćen svim međurezultatima—dakle, vidiš što se dogodilo, ali naknadno.
Ovaj način rada ima tri kvalitete koje objašnjavaju zašto je zadan. Jednostavan je jer ne pišeš nikakvu logiku kontrole na svojoj strani. Brz je jer se cijeli lanac izvršava kod Mistrala bez mrežnih povratnih putovanja (round-trips) kod svake relacije. Pouzdan je jer su rukovanje greškama i vremenska ograničenja (timeouts) između agenata riješeni umjesto tebe.
Njegova ograničenja su točna suprotnost tome. Nemaš međukontrolu: nemoguće je validirati ili modificirati predaju dok se ona odvija. Trošak je nevidljiv u smislu da se svi agenti u lancu izvršavaju bez mogućnosti da prekineš zahtjev koji ide u nepotrebnom smjeru usred tijeka. I ne možeš umetnuti nikakvu prilagođenu logiku između koraka—nema preciznog bilježenja (logginga), validacije niti poslovnih odluka.
Način rada s klijentom, kada želiš kontrolu
response = client.beta.conversations.start(
agent_id=router_agent.id,
inputs="Analyze the cloud market.",
handoff_execution="client"
)
Usmjerivač primi zahtjev i odluči izvršiti predaju, baš kao i prije. No umjesto da se predaja izvrši, ti primaš događaj agent.handoff i lanac se tu zaustavlja. Na tebi je da ga ponovno pokreneš pozivom ciljnog agenta—što ti ostavlja slobodu da validiraš, bilježiš, obogatiš kontekst ili jednostavno odbiješ predaju.
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}")
Jedna točka zaslužuje pažnju: Mistralova dokumentacija opisuje način client—kontrola se vraća tebi u trenutku predaje—ali ne nudi metodu da ciljni agent nastavi isti razgovor, a conversations.append ne prihvaća parametar agent_id. Primjer stoga pokreće razgovor s ciljnim agentom, kojem eksplicitno prenosiš ono što mu treba: izvorni zahtjev i, ako je primjenjivo, sažetak onoga što je već učinjeno. Ovo je također prilika da preneseš samo ono što oni moraju vidjeti.
Gornji isječak obrađuje samo jednu relaciju. Pravi lanac povezuje ih nekoliko, što zahtijeva petlju.
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 je poput pumpe: sve dok se u izlazima pojavljuje predaja, ti je obrađuješ i ponovno pokrećeš; čim iteracija petlje ne pronađe nijednu, lanac je završen i izlaziš s akumuliranim porukama. Komentar u sredini označava mjesto koje opravdava cijeli ovaj način rada: samo se tamo, i nigdje drugdje, tvoj kod umetne između dva agenta.
Odabir između ta dva
Način rada sa serverom pokriva standardnu proizvodnju. Ako je tvoj tijek rada predvidiv, ako vjeruješ agentima koje si napisao ili ako radiš prototip i želiš brzo vidjeti rezultate, potpuna automatizacija je pravi izbor—pisanje kontrolne petlje bilo bi gubljenje vremena.
Način rada s klijentom opravdan je čim se u lanac uključi vanjski zahtjev. Ljudska validacija, kada operater mora odobriti prijenos na agenta koji pokreće osjetljive radnje. Potreba za bilježenjem i revizijom, kada usklađenost zahtijeva praćenje svakog koraka s tvojim vlastitim identifikatorima i vremenskim oznakama. Uvjetno usmjeravanje, kada odluka ovisi o poslovnim pravilima koja model ne može znati—status kupca, doba dana, kvota. Ograničenje ili ograničenje stope (rate limiting), kada želiš ograničiti broj agenata izvršenih za jedan zahtjev. Konačno, strategija povrata (fallback), kada neuspjeh jednog agenta mora pokrenuti nešto drugo osim greške prikazane korisniku.
Evo kako izgleda prva od ovih situacija, svedena na svoj kostur.
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
Konzolni input služi kao demonstracija; u aplikaciji bit će zamijenjen obavijesti operateru i nastavkom tijeka rada kada stigne odgovor. Načelo ostaje isto: prijenos se događa samo ako ga tvoj kod pokrene.
Ispravan pristup je započeti u načinu rada sa serverom i prijeći na drugi samo onog dana kada specifično ograničenje to zahtijeva. Prelazak na način rada s klijentom „za svaki slučaj“ odmah te košta složenosti petlje i mrežnih povratnih putovanja, za kontrolu koju još ne koristiš.
Ključne točke
- Način rada sa serverom = potpuno automatski, jednostavan i brz, bez međukontrole
- Način rada s klijentom = primaš događaje predaje i sam odlučuješ što učiniti
- Način rada s klijentom omogućuje validaciju, bilježenje, uvjetno usmjeravanje i rukovanje greškama
- Za većinu slučajeva način rada sa serverom je dovoljan—prijeđi na način rada s klijentom kada trebaš kontrolu
- Oba načina rada podržavaju iste lance agenata; razlikuje se samo kontrola