Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

max_turns a nástroje servera/klienta

Lekcia 8 z 12 Aktualizované 30. júla 2026 Pokročilý
Na tejto strane
  1. Nástroje servera a nástroje klienta
  2. Parameter max_turns
  3. Resetovanie cez nástroje klienta
  4. Hybridné pracovné postupy
  5. Nastavenie max_turns
  6. Kľúčové poznatky

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:

  1. Spustiť vyhľadávanie na webe (nástroj servera, 1 ťah)
  2. Vykonať kód na analýzu výsledkov (nástroj servera, 1 ťah)
  3. Požiadať tvoju vlastnú funkciu o uloženie výsledkov (nástroj klienta, reset)
  4. 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 True vybavuje spätnú väzbu až do momentu získania konečnej odpovede
  • Začni s max_turns=5 a upravuj hodnotu podľa zložitosti tvojej úlohy
  • Každý ťah servera spotrebúva dodatočné tokeny (kumulatívny kontext)