Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

max_turns és szerver/ügyfél eszközök

8. lecke 12 közül Frissítve 2026. július 30. Haladó
Ezen az oldalon
  1. Szerveroldali és ügyféloldali eszközök
  2. A max_turns paraméter
  3. Visszaállítás ügyféloldali eszközökkel
  4. Hibrid munkafolyamatok
  5. A max_turns beállítása
  6. Főbb megállapítások

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:

  1. Webes keresés futtatására (szervereszköz, 1 kör)
  2. Kód végrehajtására az eredmények elemzéséhez (szervereszköz, 1 kör)
  3. Egyedi függvényed meghívására az eredmények mentéséhez (ügyféleszköz, visszaállítás)
  4. Ú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_turns kö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 True ciklusminta 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)