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

Servera un klienta rīku apvienošana

Nodarbība 8 no 14 Atjaunota 2026. gada 29. jūlijs Programmētājs
Šajā lapā
  1. Divas rīku kategorijas vienā platformā
  2. Abu veidu apvienošana vienā pieprasījumā
  3. Hibrīdā plūsma
  4. Reāli piemēri
  5. Servera rīku tarifikācija
  6. Galvenās atziņas

Divas rīku kategorijas vienā platformā

Grok API nošķir divus fundamentāli atšķirīgus rīku veidus, balstoties uz to izpildi. Šīs atšķirības izpratne ir būtiska, lai izstrādātu stabilas arhitektūras.

Iebūvētie rīki (servera pusē)

xAI šos rīkus izpilda automātiski savos serveros. Tev nekas nav jāpārvalda — nav lokālas izpildes, nav rezultātu pārsūtīšanas. Modelis tos izsauc un saņem rezultātus tieši.

Rīks Identifikators Apraksts
Web Search web_search Meklēšana tīmeklī reāllaikā
X Search x_search Meklēšana vietnē X/Twitter
Code Interpreter code_interpreter Python koda izpilde smilškastē
Collections Search collections_search Meklēšana augšupielādētajos dokumentos
Remote MCP mcp Savienojums ar ārējiem MCP serveriem

Pielāgotas funkcijas (klienta pusē)

Tās ir tavas pašas definētās funkcijas, izmantojot funkciju izsaukumus (function calling). Modelis atgriež tool_call, tavs kods izpilda funkciju, un tu nosūti rezultātu atpakaļ. Tas ir mehānisms, ko apguvi iepriekšējās nodarbībās.

Abu veidu apvienošana vienā pieprasījumā

Grok API spēks slēpjas iespējā apvienot servera un klienta rīkus vienā pieprasījumā:

tools = [
    # Servera rīks — xAI izpilda automātiski
    {"type": "web_search"},

    # Klienta rīks — izpilda tavs kods
    {
        "type": "function",
        "function": {
            "name": "save_to_database",
            "description": "Saglabā informāciju datubāzē",
            "parameters": {
                "type": "object",
                "properties": {
                    "key": {"type": "string"},
                    "value": {"type": "string"}
                },
                "required": ["key", "value"]
            }
        }
    }
]

Kad modelis saņem šo pieprasījumu, tas var:

  1. Izmantot web_search, lai atrastu informāciju (automātiska izpilde servera pusē)
  2. Izsaukt save_to_database, lai saglabātu rezultātu (atgriež klientam)

Hibrīdā plūsma

Uzvedība atšķiras atkarībā no rīka veida:

  • Servera rīks: modelis izsauc rīku, xAI to izpilda, rezultāts tiek automātiski integrēts, un modelis turpina darbu.
  • Klienta rīks: modelis atgriež tool_call klientam, izpilde apstājas un atsākas tikai tad, kad tu nosūti rezultātu atpakaļ.

Kad modelis vienā pieprasījumā izmanto abus veidus, servera rīki tiek izpildīti vispirms (bez tavas iejaukšanās). Pēc tam, ja modelim ir nepieciešams arī klienta rīks, tas atgriež tev tool_call, kurā servera rīku rezultāti jau ir integrēti tā kontekstā.

Reāli piemēri

Meklēšana tīmeklī + biznesa loģika

# Lietotājs jautā: "Atrodi Bitcoin cenu un saglabā to"
# Modelis:
# 1. Izsauc web_search, lai atrastu cenu (servera puse, automātiski)
# 2. Izsauc save_price(symbol="BTC", price=68432) (klienta puse)

Meklēšana vietnē X + paziņojums

# "Paziņo man par tvītiem par mūsu produktu kopš vakardienas"
# Modelis:
# 1. Izsauc x_search, lai atrastu tvītus (servera puse)
# 2. Izsauc send_notification(count=12, summary="...") (klienta puse)

Koda interpretators + glabāšana

# "Aprēķini šo datu vidējo vērtību un saglabā rezultātu"
# Modelis:
# 1. Izsauc code_interpreter aprēķina veikšanai (servera puse)
# 2. Izsauc save_result(key="avg", value="42.5") (klienta puse)

Servera rīku tarifikācija

Iebūvētie rīki tiek tarifēti divos veidos:

  • Tokeni: standarta patēriņš (ievade + izvade)
  • Izsaukumi: fiksētas izmaksas par katru rīka izsaukumu

Modelis viena pieprasījuma ietvaros var izsaukt vairākus servera rīkus — izmaksas summējas. Ņem to vērā, kad aktivizē web_search: modelis var veikt vairākas meklēšanas, lai precizētu rezultātus.

Galvenās atziņas

  • Divi rīku veidi: servera (automātiski) un klienta (funkciju izsaukumi)
  • Servera rīki (web_search, x_search, code_interpreter) tiek izpildīti bez tavas iejaukšanās
  • Abus veidus vari apvienot vienā pieprasījumā
  • Servera rīki tiek izpildīti vispirms, pēc tam modelis var izsaukt tavas funkcijas
  • Par katru servera rīka izsaukumu tiek piemērota maksa (tokeni + maksa par izsaukumu)
  • Citāti tiek ģenerēti automātiski datiem, kas iegūti no servera rīkiem