max_turns a nástroje servera/klienta
Na tejto strane
Nástroje servera a nástroje klienta
Platforma xAI rozlišuje dva typy nástrojov, ktoré môže Grok využiť počas konverzácie:
- Nástroje na strane servera: vyhľadávanie na webe, vykonávanie kódu, vyhľadávanie na X. Tieto nástroje sa spúšťajú automaticky na serveroch xAI. Grok ich vyvolá, získa výsledok a pokračuje ďalej bez akéhokoľvek zásahu z tvojej strany.
- Nástroje na strane klienta: tvoje vlastné funkcie (volanie funkcií). Keď chce Grok zavolať jednu z tvojich funkcií, API ti vráti požiadavku na volanie funkcie. Tvoj kód ju vykoná a potom odošle výsledok späť do API.
Toto rozlíšenie je kľúčové pre pochopenie správania parametra max_turns.
Parameter max_turns
max_turns riadi počet ťahov asistenta alebo nástroja, ktoré môže Grok vykonať v rámci jednej požiadavky API. Každé použitie nástroja na strane servera spotrebuje jeden ťah.
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
)
Ak potrebuje Grok spustiť vyhľadávanie na webe, následne vykonať kód na analýzu výsledkov a potom spustiť druhé vyhľadávanie na uzavretie témy, spotrebuje to 3 ťahy. Pri nastavení max_turns=5 mu zostávajú ešte 2 ťahy.
Resetovanie cez nástroje klienta
Kľúčové správanie, na ktoré musíš pamätať: volania nástrojov na strane klienta resetujú počítadlo max_turns. Keď tvoj kód spracuje volanie funkcie a vráti výsledok v novej požiadavke API, Grok získa späť plnú alokáciu ťahov.
# 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
)
Tento reset dáva zmysel: každá požiadavka API je nezávislá. Počítadlo max_turns sa vzťahuje len na ťahy vykonané v rámci tej istej požiadavky.
Hybridné pracovné postupy
Kombinácia nástrojov servera a klienta umožňuje vytvárať zložité pracovné postupy. Napríklad Grok môže:
- Spustiť vyhľadávanie na webe (nástroj servera, 1 ťah)
- Vykonať kód na analýzu výsledkov (nástroj servera, 1 ťah)
- Požiadať tvoju vlastnú funkciu o uloženie výsledkov (nástroj klienta, reset)
- Spustiť nové vyhľadávanie na základe uložených výsledkov (nástroj servera, 1 ťah s novým počítadlom)
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
})
Tento vzorec slučky automaticky vybavuje komunikáciu medzi Grokom a tvojimi lokálnymi funkciami. Slučka pokračuje dovtedy, kým Grok potrebuje volať tvoje nástroje. Zastaví sa, keď poskytne konečnú textovú odpoveď.
Nastavenie max_turns
- max_turns=1: Grok môže použiť iba jeden nástroj servera. Postačuje na jednoduché vyhľadávanie na webe.
- max_turns=3-5: dobrý kompromis pre väčšinu prípadov. Grok môže reťaziť vyhľadávanie + analýzu + overenie.
- max_turns=10+: pre zložité úlohy vyžadujúce mnoho iterácií. Dávaj pozor na náklady na tokeny.
Príliš vysoká hodnota max_turns nič nestojí, ak sa nevyužije, ale príliš nízka hodnota max_turns môže prerušiť uvažovanie Groka uprostred úlohy.
Kľúčové poznatky
- Nástroje servera (vyhľadávanie na webe, vykonávanie kódu) spotrebúvajú ťahy z
max_turns - Nástroje klienta (tvoje funkcie) resetujú počítadlo pri každej novej požiadavke
- Vzorec slučky
while Truevybavuje spätnú väzbu až do momentu získania konečnej odpovede - Začni s
max_turns=5a upravuj hodnotu podľa zložitosti tvojej úlohy - Každý ťah servera spotrebúva dodatočné tokeny (kumulatívny kontext)