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

Rīki servera pusē un funkciju izsaukšana

Nodarbība 10 no 12 Atjaunota 2026. gada 2. novembris Programmētājs
Šajā lapā
  1. Partiju bagātināšana ar rīkiem
  2. Rīki servera pusē
  3. Funkciju izsaukšana klienta pusē
  4. Rīku kombinēšana
  5. Partijas rīku ierobežojumi
  6. Galvenās atziņas

Kurss atjaunināts 2026. gada 2. novembrī, balstoties uz xAI dokumentāciju: atlaide par partijas (batch) apstrādi ir 20% atbilstošajiem teksta modeļiem (nevis 50%), piemēri seko REST API un oficiālajam xai-sdk (client.batch.*; xAI partijas API neizmanto OpenAI formātu, tāpēc OpenAI SDK nav piemērojams), un Responses API ir prioritārs pār Chat Completions, kas xAI vidē ir novecojis galapunkts. Avoti: Batch API · REST atsauce · Batch cenu politika.

Partiju bagātināšana ar rīkiem

Partijas pieprasījumi neaprobežojas tikai ar neapstrādātu tekstu. Rīki servera pusē un funkciju izsaukšana darbojas arī asinhronā režīmā, taču pastāv būtiska atšķirība: pirmos izpilda xAI apstrādes laikā, bet otrie nodod kontroli tev.

Rīki servera pusē

Rīki servera pusē tiek izpildīti partijas apstrādes laikā tieši tāpat kā reāllaikā: Grok izsauc rīku, saņem rezultātu, integrē to savā spriešanā, un partija atgriež galīgo atbildi. Tie darbojas kopā ar Responses API.

{"custom_id": "news-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "What are the latest developments in quantum computing?"}], "tools": [{"type": "web_search"}]}}

Partijas režīmā meklēšana tīmeklī kalpo datu bagātināšanai: informācijas pārbaudei, jaunāko faktu vākšanai un profilu salīdzināšanai ar tiešsaistes avotiem.

Rīks x_search veic vaicājumus ierakstiem platformā X, kas ir noderīgi, lai izsekotu noskaņojumu par konkrētu tēmu vai zīmolu:

{"custom_id": "x-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "What is the dominant sentiment on X regarding this product launch?"}], "tools": [{"type": "x_search"}]}}

Koda izpilde

Grok spēj rakstīt un izpildīt Python kodu izolētā vidē. Responses API šis rīks tiek dēvēts par code_interpreter (xAI SDK to nosauc par code_execution):

{"custom_id": "calc-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Calculate the 3-point moving average for this data: [12, 15, 18, 14, 22, 19, 25, 28, 30, 27]"}], "tools": [{"type": "code_interpreter"}]}}

Koda izpilde ir aktuāla precīziem aprēķiniem, statistikai un datu transformācijām, kurus modelis, paļaujoties tikai uz atmiņu, apstrādātu mazāk uzticami.

Attālināti MCP serveri

Rīks mcp savieno Grok ar attālinātu MCP serveri, kas tiek aprakstīts pašā pieprasījumā: iepriekšēja konta konfigurācija nav nepieciešama. Lauki server_url un server_label ir obligāti; allowed_tools ierobežo eksponētos rīkus, bet authorization nodod serverim pilnvarojuma tokeni. Tiek pieņemti tikai Streamable HTTP un SSE transporta protokoli.

{"custom_id": "mcp-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "What does the xai-sdk-python repository do?"}], "tools": [{"type": "mcp", "server_label": "deepwiki", "server_url": "https://mcp.deepwiki.com/mcp"}]}}

Bez allowed_tools visas rīku definīcijas no servera tiek ievadītas modeļa kontekstā un katrā partijas pieprasījumā tiek tarifētas kā ievades tokeni: pie 50 000 pieprasījumiem šī saraksta ierobežošana ātri atmaksājas.

Funkciju izsaukšana klienta pusē

Funkciju izsaukšana ir rīks klienta pusē: Grok ģenerē strukturētu funkcijas izsaukumu, bet tavam kodam tas ir jāizpilda. Partijas režīmā modelis šos izsaukumus atgriež savos rezultātos turpmākai apstrādei bezsaistē.

Funkciju definīcijas

Responses API deklarē funkciju plakanā struktūrā, augstākajā līmenī norādot name, description un parameters. Iestatījums tool_choice: "required" piespiež modeli izsaukt vismaz vienu rīku, kas ir piemēroti datu ekstrakcijai:

{"custom_id": "extract-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Extract the contact: Jean Dupont, 01 23 45 67 89, [email protected]"}], "tools": [{"type": "function", "name": "save_contact", "description": "Saves a contact extracted from text", "parameters": {"type": "object", "properties": {"name": {"type": "string"}, "phone": {"type": "string"}, "email": {"type": "string"}}, "required": ["name"]}}], "tool_choice": "required"}}

Rezultātu apstrāde

Izmantojot SDK, nolasiet funkciju izsaukumus katra veiksmīga rezultāta laukā tool_calls:

import json

for r in page.succeeded:
    for call in r.response.tool_calls:
        if call.function.name == "save_contact":
            contact = json.loads(call.function.arguments)
            save_to_database(r.batch_request_id, contact)

Funkciju izsaukšana partijās ir ideāli piemērota strukturētai ekstrakcijai: tu definē datu shēmu, Grok nolasa dokumentus un ģenerē izsaukumus, kurus pēc tam apstrādā masveidā.

Rīku kombinēšana

Vienā pieprasījumā vari kombinēt vairākus servera rīkus:

{"custom_id": "multi-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Find the Bitcoin closing price for the last seven days and calculate its change"}], "tools": [{"type": "web_search"}, {"type": "code_interpreter"}]}}

Grok izmanto rīkus secībā, ko uzskata par visatbilstošāko: šajā gadījumā vispirms meklēšana tīmeklī datu iegūšanai, pēc tam koda izpilde aprēķina veikšanai.

Partijas rīku ierobežojumi

  • Servera rīki pagarina katra pieprasījuma, un līdz ar to arī visas partijas, apstrādes laiku.
  • Pieprasījumi ar meklēšanu ir atkarīgi no tā, ko avoti publicē apstrādes brīdī, nevis iesniegšanas brīdī.
  • Funkciju izsaukšana veic tikai vienu aprites ciklu (round trip) katram pieprasījumam: lai turpinātu, ir jāiesniedz jauns partijas pieprasījums, kas satur sarunu un tavus funkciju rezultātus.
  • nefiltrētas MCP rīku definīcijas pārpilda katru pieprasījumu.

Galvenās atziņas

  • Servera rīki (tīmeklis, X, kods, MCP) tiek izpildīti xAI apstrādes laikā, izmantojot Responses API.
  • MCP serveri apraksti pieprasījumā (server_url, server_label) bez iepriekšējas konfigurācijas.
  • Funkciju izsaukšana atgriež strukturētus izsaukumus, kurus tu izpildi klienta pusē.
  • Daudzpakāpju sarunai ir nepieciešams jauns partijas pieprasījums katram solim.
  • Ierobežo eksponētos rīkus, lai izvairītos no to definīciju apmaksas katrā pieprasījumā.