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

max_turns i alati poslužitelja/klijenta

Lekcija 8 od 12 Ažurirano 30. srpnja 2026. Napredno
Na ovoj stranici
  1. Alati poslužitelja i alati klijenta
  2. Parametar max_turns
  3. Resetiranje putem alata klijenta
  4. Hibridni tijekovi rada
  5. Postavljanje max_turns
  6. Ključne točke

Alati poslužitelja i alati klijenta

xAI platforma razlikuje dvije vrste alata koje Grok može koristiti u razgovoru:

  • Alati na strani poslužitelja: web pretraživanje, izvršavanje koda, pretraživanje X-a. Ovi se alati automatski pokreću na xAI poslužiteljima. Grok ih poziva, dobiva rezultat i nastavlja bez ikakve tvoje intervencije.
  • Alati na strani klijenta: tvoje prilagođene funkcije (pozivanje funkcija). Kada Grok želi pozvati jednu od tvojih funkcija, API ti vraća poziv funkcije. Tvoj kod je izvršava, a zatim šalje rezultat natrag API-ju.

Ova je razlika ključna za razumijevanje ponašanja parametra max_turns.

Parametar max_turns

max_turns kontrolira broj poteza asistenta/alata koje Grok može izvesti u jednom zahtjevu API-ju. Svaka upotreba alata na poslužitelju troši jedan potez.

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
)

Ako Grok treba pokrenuti web pretraživanje, zatim izvršiti kod za analizu rezultata, a potom pokrenuti drugo pretraživanje za zaključak, to troši 3 poteza. S max_turns=5, preostaju mu 2 poteza.

Resetiranje putem alata klijenta

Ključno ponašanje koje trebaš zapamtiti: pozivi alata na strani klijenta resetiraju brojač max_turns. Kada tvoj kod obradi poziv funkcije i vrati rezultat u novom zahtjevu API-ju, Grok dobiva natrag punu dodjelu poteza.

# 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
    )

Ovo resetiranje ima smisla: svaki je zahtjev API-ju neovisan. Brojač max_turns vrijedi samo za poteze izvedene unutar istog zahtjeva.

Hibridni tijekovi rada

Kombiniranjem alata poslužitelja i klijenta omogućuješ složene tijekove rada. Na primjer, Grok može:

  1. Pokrenuti web pretraživanje (alat poslužitelja, 1 potez)
  2. Izvršiti kod za analizu rezultata (alat poslužitelja, 1 potez)
  3. Zatražiti od tvoje prilagođene funkcije da spremi rezultate (alat klijenta, resetiranje)
  4. Pokrenuti novo pretraživanje na temelju spremljenih rezultata (alat poslužitelja, 1 potez s novim brojačem)
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
            })

Ovaj obrazac petlje automatski obrađuje razmjenu između Groka i tvojih lokalnih funkcija. Petlja se nastavlja sve dok Grok treba zvati tvoje alate. Zaustavlja se kada pruži konačni tekstualni odgovor.

Postavljanje max_turns

  • max_turns=1: Grok može koristiti samo jedan alat poslužitelja. Dovoljno za jednostavno web pretraživanje.
  • max_turns=3-5: dobra ravnoteža za većinu slučajeva. Grok može lančano povezati pretraživanje + analizu + provjeru.
  • max_turns=10+: za složene zadatke koji zahtijevaju mnogo iteracija. Pazi na troškove tokena.

Vrijednost max_turns koja je previsoka ne košta ništa ako se ne iskoristi, ali vrijednost max_turns koja je preniska može prekinuti Grokovo rezoniranje usred zadatka.

Ključne točke

  • Alati poslužitelja (web pretraživanje, izvršavanje koda) troše poteze max_turns
  • Alati klijenta (tvoje funkcije) resetiraju brojač sa svakim novim zahtjevom
  • Obrazac petlje while True obrađuje razmjenu do konačnog odgovora
  • Započni s max_turns=5 i prilagodi prema složenosti svog zadatka
  • Svaki potez poslužitelja troši dodatne tokene (kumulativni kontekst)