Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

max_turns un rīki servera/klienta pusē

Nodarbība 8 no 12 Atjaunota 2026. gada 30. jūlijs Augstākais
Šajā lapā
  1. Rīki servera un klienta pusē
  2. Parametrs max_turns
  3. Atiestatīšana, izmantojot klienta rīkus
  4. Hibrīddarba plūsmas
  5. Parametra max_turns iestatīšana
  6. Galvenās atziņas

Rīki servera un klienta pusē

xAI platforma izšķir divus rīku veidus, kurus Grok var izmantot sarunas laikā:

  • Rīki servera pusē: tīmekļa meklēšana, koda izpilde, X meklēšana. Šie rīki darbojas automātiski xAI serveros. Grok tos izsauc, saņem rezultātu un turpina darbu bez tavas iejaukšanās.
  • Rīki klienta pusē: tavas pielāgotās funkcijas (funkciju izsaukumi). Kad Grok vēlas izsaukt kādu no tavām funkcijām, API atgriež tev funkcijas izsaukumu. Tavs kods to izpilda, pēc tam nosūta rezultātu atpakaļ API.

Šī atšķirība ir būtiska, lai saprastu max_turns darbību.

Parametrs max_turns

max_turns kontrolē asistenta/rīka gājienu skaitu, ko Grok var veikt viena API pieprasījuma ietvaros. Katrs servera rīka izmantojums patērē vienu gājienu.

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 var izmantot līdz 5 servera rīkiem
)

Ja Grok ir jāveic tīmekļa meklēšana, pēc tam jāizpilda kods rezultātu analīzei un visbeidzot jāveic otrā meklēšana noslēgumam, tas patērē 3 gājienus. Ar max_turns=5 tam paliek 2 gājieni.

Atiestatīšana, izmantojot klienta rīkus

Atceries galveno darbības principu: klienta puses rīku izsaukumi atiestata max_turns skaitītāju. Kad tavs kods apstrādā funkcijas izsaukumu un atgriež rezultātu jaunā API pieprasījumā, Grok atgūst pilnu savu gājienu limitu.

# Pirmais pieprasījums: max_turns=3
response = await client.chat.completions.create(
    model="grok-4.5",
    messages=messages,
    tools=my_tools,
    max_turns=3
)

# Grok pieprasa klienta funkcijas izsaukumu
if response.choices[0].message.tool_calls:
    # Tu izpildi funkciju lokāli
    tool_result = execute_tool(response.choices[0].message.tool_calls[0])

    # Otrais pieprasījums: max_turns tiek atiestatīts uz 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  # jauns skaitītājs
    )

Šī atiestatīšana ir loģiska: katrs API pieprasījums ir neatkarīgs. max_turns skaitītājs attiecas tikai uz gājieniem, kas veikti viena pieprasījuma ietvaros.

Hibrīddarba plūsmas

Servera un klienta rīku kombinēšana ļauj veidot sarežģītas darba plūsmas. Piemēram, Grok var:

  1. Veikt tīmekļa meklēšanu (servera rīks, 1 gājiens)
  2. Izpildīt kodu rezultātu analīzei (servera rīks, 1 gājiens)
  3. Lūgt tavu pielāgoto funkciju saglabāt rezultātus (klienta rīks, atiestatīšana)
  4. Veikt jaunu meklēšanu, pamatojoties uz saglabātajiem rezultātiem (servera rīks, 1 gājiens ar jaunu skaitītāju)
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

        # Ja nav klienta rīka izsaukuma, mums ir galīgā atbilde
        if not message.tool_calls:
            return message.content

        # Apstrādājam klienta rīku izsaukumus
        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 cilpas raksts automātiski apstrādā mijiedarbību starp Grok un tavām lokālajām funkcijām. Cilpa turpinās, kamēr Grok ir nepieciešams izsaukt tavus rīkus. Tā apstājas, kad tas sniedz galīgo teksta atbildi.

Parametra max_turns iestatīšana

  • max_turns=1: Grok var izmantot tikai vienu servera rīku. Pietiekami vienkāršai tīmekļa meklēšanai.
  • max_turns=3-5: labs līdzsvars vairumam gadījumu. Grok var ķēdēt meklēšanu + analīzi + verificēšanu.
  • max_turns=10+: sarežģītiem uzdevumiem, kuriem nepieciešamas daudzas iterācijas. Uzmanies no tokena izmaksām.

Pārāk augsta max_turns vērtība neko nemaksā, ja tā netiek izmantota, taču pārāk zema vērtība var pārtraukt Grok spriešanu uzdevuma vidū.

Galvenās atziņas

  • Servera rīki (tīmekļa meklēšana, koda izpilde) patērē max_turns gājienus
  • Klienta rīki (tavas funkcijas) atiestata skaitītāju ar katru jaunu pieprasījumu
  • Cilpas raksts while True apstrādā mijiedarbību līdz galīgajai atbildei
  • Sāc ar max_turns=5 un pielāgo to atkarībā no uzdevuma sarežģītības
  • Katrs servera gājiens patērē papildu tokenus (kumulatīvs konteksts)