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

max_turns in orodja strežnika/odjemalca

Lekcija 8 od 12 Posodobljeno 30. julij 2026 Napredni
Na tej strani
  1. Orodja strežnika in orodja odjemalca
  2. Parameter max_turns
  3. Ponastavitev prek orodij odjemalca
  4. Hibridni delovni tokovi
  5. Nastavljanje vrednosti max_turns
  6. Ključne ugotovitve

Orodja strežnika in orodja odjemalca

Platforma xAI razlikuje dve vrsti orodij, ki jih lahko Grok uporabi med pogovorom:

  • Orodja na strani strežnika: spletno iskanje, izvajanje kode, iskanje po X. Ta orodja se samodejno izvajajo na strežnikih xAI. Grok jih prikliče, prejme rezultat in nadaljuje brez tvojega posredovanja.
  • Orodja na strani odjemalca: tvoje funkcije po meri (klicanje funkcij). Ko želi Grok poklicati eno izmed tvojih funkcij, API vrne klic funkcije tebi. Tvoja koda jo izvrši, nato pa rezultat pošlje nazaj v API.

Ta razlika je ključna za razumevanje delovanja parametra max_turns.

Parameter max_turns

max_turns nadzira število potez asistenta/orodja, ki jih lahko Grok izvede v enem samem zahtevku API. Vsaka uporaba orodja na strani strežnika porabi eno potezo.

response = await client.chat.completions.create(
    model="grok-4.5",
    messages=[{"role": "user", "content": "Search for the latest news on Python 3.13"}],
    tools=[...],
    max_turns=5  # Grok can use up to 5 server tools
)

Če mora Grok izvesti spletno iskanje, nato izvršiti kodo za analizo rezultatov in nato opraviti drugo iskanje za zaključek, to porabi 3 poteze. Pri max_turns=5 mu ostanejo še 2 potezi.

Ponastavitev prek orodij odjemalca

Ključno vedenje, ki si ga moraš zapomniti: klici orodij na strani odjemalca ponastavijo števec max_turns. Ko tvoja koda obdela klic funkcije in vrne rezultat v novem zahtevku API, Grok ponovno prejme celotno dodeljeno število potez.

# First request: max_turns=3
response = await client.chat.completions.create(
    model="grok-4.5",
    messages=messages,
    tools=my_tools,
    max_turns=3
)

# Grok requests a client function call
if response.choices[0].message.tool_calls:
    # You execute the function locally
    tool_result = execute_tool(response.choices[0].message.tool_calls[0])

    # Second request: max_turns resets to 3
    messages.append(response.choices[0].message)
    messages.append({"role": "tool", "content": tool_result, ...})

    response = await client.chat.completions.create(
        model="grok-4.5",
        messages=messages,
        tools=my_tools,
        max_turns=3  # new counter
    )

Ta ponastavitev ima smisel: vsak zahtevek API je neodvisen. Števec max_turns velja le za poteze, izvedene znotraj istega zahtevka.

Hibridni delovni tokovi

Kombiniranje orodij strežnika in odjemalca omogoča kompleksne delovne tokove. Na primer, Grok lahko:

  1. Izvede spletno iskanje (orodje strežnika, 1 poteza)
  2. Izvrši kodo za analizo rezultatov (orodje strežnika, 1 poteza)
  3. Zaprosi tvojo funkcijo po meri za shranjevanje rezultatov (orodje odjemalca, ponastavitev)
  4. Izvede novo iskanje na podlagi shranjenih rezultatov (orodje strežnika, 1 poteza z novim števcem)
async def hybrid_workflow(question: str) -> str:
    messages = [{"role": "user", "content": question}]

    while True:
        response = await client.chat.completions.create(
            model="grok-4.5",
            messages=messages,
            tools=server_and_client_tools,
            max_turns=5
        )

        message = response.choices[0].message

        # If no client tool call, we have the final answer
        if not message.tool_calls:
            return message.content

        # Process client tool calls
        messages.append(message)
        for tool_call in message.tool_calls:
            result = await execute_local_tool(tool_call)
            messages.append({
                "role": "tool",
                "tool_call_id": tool_call.id,
                "content": result
            })

Ta vzorec zanke samodejno obravnava izmenjavo med Grokom in tvojimi lokalnimi funkcijami. Zanka se nadaljuje, dokler Grok potrebuje klic tvojih orodij. Ustavi se, ko zagotovi končni besedni odgovor.

Nastavljanje vrednosti max_turns

  • max_turns=1: Grok lahko uporabi le eno orodje strežnika. Dovolj za preprosto spletno iskanje.
  • max_turns=3–5: dobro ravnovesje za večino primerov. Grok lahko veriži iskanje + analizo + preverjanje.
  • max_turns=10+: za kompleksne naloge, ki zahtevajo veliko iteracij. Pozoren bodi na stroške žetonov.

Vrednost max_turns, ki je previsoka, ne stane nič, če se ne porabi, medtem ko lahko prenizka vrednost max_turns prekine Grokovo sklepanje sredi naloge.

Ključne ugotovitve

  • Orodja strežnika (spletno iskanje, izvajanje kode) porabijo poteze max_turns
  • Orodja odjemalca (tvoje funkcije) ponastavijo števec z vsakim novim zahtevkom
  • Vzorec zanke while True obravnava izmenjavo do končnega odgovora
  • Začni z max_turns=5 in prilagodi glede na kompleksnost svoje naloge
  • Vsaka poteza strežnika porabi dodatne žetone (kumulativni kontekst)