max_turns és szerver/ügyfél eszközök
Ezen az oldalon
Szerveroldali és ügyféloldali eszközök
Az xAI platform két típusú eszközt különböztet meg, amelyeket a Grok beszélgetés során használhat:
- Szerveroldali eszközök: webes keresés, kódvégrehajtás, X-keresés. Ezek az eszközök automatikusan futnak az xAI szerverein. A Grok meghívja őket, megkapja az eredményt, és beavatkozásod nélkül folytatja a munkát.
- Ügyféloldali eszközök: a te egyedi függvényeid (függvényhívás). Amikor a Grok hívni szeretné az egyik függvényedet, az API visszaadja neked a függvényhívást. A kódod végrehajtja azt, majd visszaküldi az eredményt az API-nak.
Ez a megkülönböztetés kulcsfontosságú a max_turns viselkedésének megértéséhez.
A max_turns paraméter
A max_turns szabályozza azon asszisztens/eszköz körök számát, amelyeket a Grok egyetlen API-kérés során végrehajthat. Minden szerveroldali eszköz használata egy kört emészt fel.
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
)
Ha a Groknak le kell futtatnia egy webes keresést, majd kódot kell végrehajtania az eredmények elemzéséhez, végül egy második keresést kell indítania a lezáráshoz, az 3 kört vesz igénybe. max_turns=5 esetén még 2 köre marad.
Visszaállítás ügyféloldali eszközökkel
Fontos viselkedési szabály: az ügyféloldali eszközök meghívása visszaállítja a max_turns számlálót. Amikor a kódod kezel egy függvényhívást, és az eredményt egy új API-kérésben küldi vissza, a Grok megkapja a teljes kör-keretét újra.
# 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
)
Ez a visszaállítás logikus: minden API-kérés független. A max_turns számláló csak ugyanazon a kérésen belül végrehajtott körökre vonatkozik.
Hibrid munkafolyamatok
A szerver- és ügyféloldali eszközök kombinálása összetett munkafolyamatokat tesz lehetővé. Például a Grok képes:
- Webes keresés futtatására (szervereszköz, 1 kör)
- Kód végrehajtására az eredmények elemzéséhez (szervereszköz, 1 kör)
- Egyedi függvényed meghívására az eredmények mentéséhez (ügyféleszköz, visszaállítás)
- Új keresés indítására a mentett eredmények alapján (szervereszköz, 1 kör az új számlálóval)
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
})
Ez a ciklusminta automatikusan kezeli az oda-vissza kommunikációt a Grok és a helyi függvényeid között. A ciklus addig fut, amíg a Groknak szüksége van a te eszközeid hívására. Akkor áll le, amikor végső szöveges választ ad.
A max_turns beállítása
- max_turns=1: A Grok csak egyetlen szervereszközt használhat. Egyszerű webes kereséshez elegendő.
- max_turns=3-5: jó egyensúly a legtöbb esetben. A Grok láncolhat keresést + elemzést + ellenőrzést.
- max_turns=10+: összetett feladatokhoz, amelyek sok iterációt igényelnek. Figyeld a tokenköltségeket!
Egy túl magas max_turns érték semmibe nem kerül, ha nem használják ki, de egy túl alacsony max_turns érték félbeszakíthatja a Grok gondolkodási folyamatát a feladat közepén.
Főbb megállapítások
- A szervereszközök (webes keresés, kódvégrehajtás) fogyasztják a
max_turnsköröket - Az ügyféleszközök (a te függvényeid) minden új kéréssel visszaállítják a számlálót
- A
while Trueciklusminta kezeli az oda-vissza kommunikációt a végső válaszig - Kezdd a
max_turns=5értékkel, és a feladat összetettsége alapján állítsd be - Minden szerverkör további tokeneket fogyaszt (kumulatív kontextus)