max_turns i alati poslužitelja/klijenta
Na ovoj stranici
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:
- Pokrenuti web pretraživanje (alat poslužitelja, 1 potez)
- Izvršiti kod za analizu rezultata (alat poslužitelja, 1 potez)
- Zatražiti od tvoje prilagođene funkcije da spremi rezultate (alat klijenta, resetiranje)
- 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 Trueobrađuje razmjenu do konačnog odgovora - Započni s
max_turns=5i prilagodi prema složenosti svog zadatka - Svaki potez poslužitelja troši dodatne tokene (kumulativni kontekst)