Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

max_turns ir serverio/kliento įrankiai

Paskaita 8 iš 12 Atnaujinta 2026 m. liepos 30 d. Pažengusiems
Šiame puslapyje
  1. Serverio ir kliento įrankiai
  2. Parametras max_turns
  3. Skaitiklio nustatymas iš naujo naudojant kliento įrankius
  4. Hibridiniai darbo eigos procesai
  5. max_turns nustatymas
  6. Svarbiausi punktai

Serverio ir kliento įrankiai

xAI platforma išskiria du įrankių, kuriuos Grok gali naudoti pokalbio metu, tipus:

  • Serverio pusės įrankiai: žiniatinklio paieška, kodo vykdymas, X paieška. Šie įrankiai automatiškai vykdomi xAI serveriuose. Grok juos iškviečia, gauna rezultatą ir tęsia darbą be jokio tavo įsikišimo.
  • Kliento pusės įrankiai: tavo sukurtos funkcijos (funkcijų kvietimas). Kai Grok nori iškviesti vieną iš tavo funkcijų, API grąžina tau funkcijos kvietimą. Tavo kodas ją įvykdo, o tada siunčia rezultatą atgal į API.

Šis skirtumas yra raktas suprasti max_turns elgseną.

Parametras max_turns

max_turns valdo asistento ir įrankių ėjimų skaičių, kurį Grok gali atlikti vieno API užklausos metu. Kiekvienas serverio įrankio naudojimas sunaudoja vieną ėjimą.

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
)

Jei Grok turi atlikti žiniatinklio paiešką, tada įvykdyti kodą rezultatams analizuoti ir galiausiai atlikti antrą paiešką apibendrinimui, tai sunaudoja 3 ėjimus. Nustačius max_turns=5, lieka 2 ėjimai.

Skaitiklio nustatymas iš naujo naudojant kliento įrankius

Svarbu prisiminti pagrindinę taisyklę: kliento pusės įrankių kvietimai nustato iš naujo max_turns skaitiklį. Kai tavo kodas apdoroja funkcijos kvietimą ir grąžina rezultatą naujoje API užklausoje, Grok vėl gauna visą savo ėjimų limitą.

# 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
    )

Šis nustatymas iš naujo yra logiškas: kiekviena API užklausa yra nepriklausoma. max_turns skaitiklis taikomas tik tiems ėjimams, kurie atliekami tos pačios užklausos ribose.

Hibridiniai darbo eigos procesai

Derinant serverio ir kliento įrankius, galima kurti sudėtingas darbo eigas. Pavyzdžiui, Grok gali:

  1. Atlikti žiniatinklio paiešką (serverio įrankis, 1 ėjimas)
  2. Įvykdyti kodą rezultatams analizuoti (serverio įrankis, 1 ėjimas)
  3. Paprašyti tavo sukurtos funkcijos išsaugoti rezultatus (kliento įrankis, skaitiklio nustatymas)
  4. Atlikti naują paiešką pagal išsaugotus rezultatus (serverio įrankis, 1 ėjimas su nauju skaitikliu)
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
            })

Šis ciklo šablonas automatiškai valdo sąveiką tarp Grok ir tavo vietinių funkcijų. Ciklas tęsiasi tol, kol Grok reikia kviesti tavo įrankius. Jis sustoja, kai pateikiamas galutinis tekstinis atsakymas.

max_turns nustatymas

  • max_turns=1: Grok gali naudoti tik vieną serverio įrankį. Pakanka paprastai žiniatinklio paieškai.
  • max_turns=3-5: geras balansas daugeliu atvejų. Grok gali grandininėje sekoje atlikti paiešką, analizę ir patikrinimą.
  • max_turns=10+: sudėtingoms užduotims, reikalaujančioms daug kartojimų. Stebėk žetonų kainas.

Per didelė max_turns reikšmė nieko nekainuoja, jei ji nepanaudojama, tačiau per maža reikšmė gali nutraukti Grok samprotavimus viduryje užduoties.

Svarbiausi punktai

  • Serverio įrankiai (žiniatinklio paieška, kodo vykdymas) sunaudoja max_turns ėjimus
  • Kliento įrankiai (tavo funkcijos) nustato skaitiklį iš naujo su kiekviena nauja užklausa
  • while True ciklo šablonas valdo sąveiką iki galutinio atsakymo gavimo
  • Pradėk nuo max_turns=5 ir koreguok pagal užduoties sudėtingumą
  • Kiekvienas serverio ėjimas sunaudoja papildomų žetonų (kaupiamasis kontekstas)