Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Izvršavanje na poslužitelju naspram klijentu

Lekcija 14 od 18 Ažurirano 3. studenoga 2026. Programer
Na ovoj stranici
  1. Dva načina rukovanja predajama
  2. Način rada sa serverom, zadana postavka
  3. Način rada s klijentom, kada želiš kontrolu
  4. Odabir između ta dva
  5. Ključne točke

Lekcija ažurirana 3. studenog 2026. na temelju mistralai SDK verzije 3.7.0 i Mistralove dokumentacije o Handoffs: unos agent.handoff identificira ciljnog agenta putem next_agent_id (a ne to_agent), a conversations.append ne prihvaća parametar agent_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