Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

max_turns a nástroje serveru/klienta

Lekce 8 z 12 Aktualizováno 30. července 2026 Pokročilý
Na této stránce
  1. Nástroje serveru a nástroje klienta
  2. Parametr max_turns
  3. Resetování prostřednictvím nástrojů klienta
  4. Hybridní pracovní postupy
  5. Nastavení max_turns
  6. Klíčové poznatky

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:

  1. Provést vyhledávání na webu (nástroj serveru, 1 tah)
  2. Spustit kód pro analýzu výsledků (nástroj serveru, 1 tah)
  3. Požádat tvou vlastní funkci o uložení výsledků (nástroj klienta, reset)
  4. 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 True zpracovává komunikaci tam a zpět až do finální odpovědi
  • Začni s max_turns=5 a upravuj hodnotu podle složitosti svého úkolu
  • Každý tah serveru spotřebovává další tokeny (kumulativní kontext)