Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Izvajanje na strežniku ali odjemalcu

Lekcija 14 od 18 Posodobljeno 3. november 2026 Razvijalec
Na tej strani
  1. Dva načina obravnave predaj
  2. Strežniški način, privzeta izbira
  3. Odjemalčev način, ko želiš nadzor
  4. Izbira med obema
  5. Ključne ugotovitve

Lekcija posodobljena 3. novembra 2026 na podlagi SDK mistralai različice 3.7.0 in dokumentacije Mistral Handoffs: vnos agent.handoff ciljnega agenta identificira preko next_agent_id (ne to_agent), metoda conversations.append pa ne sprejme parametra agent_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