max_turns a nástroje serveru/klienta
Na této stránce
Nástroje serveru a nástroje klienta
Platforma xAI rozlišuje dva typy nástrojů, které může Grok v konverzaci používat:
- Nástroje na straně serveru: vyhledávání na webu, spouštění kódu, hledání na X. Tyto nástroje běží automaticky na serverech xAI. Grok je vyvolá, získá výsledek a pokračuje dál bez tvého zásahu.
- Nástroje na straně klienta: tvé vlastní funkce (volání funkcí). Když chce Grok zavolat jednu z tvých funkcí, API ti vrátí požadavek na volání funkce. Tvůj kód ji provede a poté odešle výsledek zpět do API.
Toto rozlišení je klíčové pro pochopení chování parametru max_turns.
Parametr max_turns
max_turns řídí počet tahů asistenta/nástroje, které může Grok provést v rámci jediného požadavku API. Každé použití nástroje na straně serveru spotřebuje jeden tah.
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
)
Pokud Grok potřebuje provést vyhledávání na webu, poté spustit kód pro analýzu výsledků a nakonec provést druhé vyhledávání pro shrnutí, spotřebuje to 3 tahy. Při nastavení max_turns=5 mu zbývají 2 tahy.
Resetování prostřednictvím nástrojů klienta
Důležité chování, které si musíš pamatovat: volání nástrojů na straně klienta resetuje čítač max_turns. Když tvůj kód zpracuje volání funkce a vrátí výsledek v novém požadavku API, Grok získá zpět svou plnou alokaci tahů.
# 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ává smysl: každý požadavek API je nezávislý. Čítač max_turns se vztahuje pouze na tahy provedené v rámci stejného požadavku.
Hybridní pracovní postupy
Kombinace nástrojů serveru a klienta umožňuje složité pracovní postupy. Grok může například:
- Provést vyhledávání na webu (nástroj serveru, 1 tah)
- Spustit kód pro analýzu výsledků (nástroj serveru, 1 tah)
- Požádat tvou vlastní funkci o uložení výsledků (nástroj klienta, reset)
- Provést nové vyhledávání na základě uložených výsledků (nástroj serveru, 1 tah s novým čítač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
})
Tento vzor smyčky automaticky zpracovává komunikaci tam a zpět mezi Grokem a tvými lokálními funkcemi. Smyčka pokračuje, dokud Grok potřebuje volat tvé nástroje. Zastaví se, jakmile poskytne konečnou textovou odpověď.
Nastavení max_turns
- max_turns=1: Grok může použít pouze jeden nástroj serveru. Stačí pro jednoduché vyhledávání na webu.
- max_turns=3–5: dobrý kompromis pro většinu případů. Grok může řetězit vyhledávání + analýzu + ověření.
- max_turns=10+: pro složité úkoly vyžadující mnoho iterací. Pozor na náklady na tokeny.
Příliš vysoká hodnota max_turns nic nestojí, pokud není využita, ale příliš nízká hodnota max_turns může přerušit Grokovo uvažování uprostřed úkolu.
Klíčové poznatky
- Nástroje serveru (vyhledávání na webu, spouštění kódu) spotřebovávají tahy z
max_turns - Nástroje klienta (tvé funkce) resetují čítač při každém novém požadavku
- Vzorec smyčky
while Truezpracovává komunikaci tam a zpět až do finální odpovědi - Začni s
max_turns=5a upravuj hodnotu podle složitosti svého úkolu - Každý tah serveru spotřebovává další tokeny (kumulativní kontext)