Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Serverio įrankiai ir funkcijų kvietimas

Paskaita 10 iš 12 Atnaujinta 2026 m. lapkričio 2 d. Kūrėjas
Šiame puslapyje
  1. Partijų praturtinimas įrankiais
  2. Serverio pusės įrankiai
  3. Kliento pusės funkcijų kvietimas
  4. Įrankių derinimas
  5. Partijų įrankių apribojimai
  6. Svarbiausi punktai

Kursas atnaujintas 2026 m. lapkričio 2 d. pagal xAI dokumentaciją: nuolaida partijoms (batch) yra 20 % tinkamiems teksto modeliams (ne 50 %), pavyzdžiai naudoja REST API ir oficialųjį xai-sdk (client.batch.*; xAI partijų API nenaudoja OpenAI formato, todėl OpenAI SDK netinka), o Responses API turi pirmenybę prieš Chat Completions, kuris xAI sistemoje yra pasenusi galutinė sąsaja. Šaltiniai: Batch API · REST nuoroda · Partijų kainodara.

Partijų praturtinimas įrankiais

Partijų užklausos neapsiriboja vien žaliu tekstu. Serverio įrankiai ir funkcijų kvietimas veikia ir asinchroniniu režimu, tačiau yra esminis skirtumas: pirmieji vykdomi apdorojimo metu xAI sistemoje, o antrieji grąžina valdymą tau.

Serverio pusės įrankiai

Serverio įrankiai vykdomi partijų apdorojimo metu tiksliai taip pat, kaip ir realiuoju laiku: Grok iškviečia įrankį, gauna rezultatą, integruoja jį į savo samprotavimą, o partija grąžina galutinį atsakymą. Jie veikia su Responses API.

Web paieška

{"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"}]}}

Partijų režimu web paieška naudojama duomenų praturtinimui: informacijos tikrinimui, naujausių faktų rinkimui, profilių palyginimui su internetiniais šaltiniais.

X paieška

Įrankis x_search ieško įrašų X platformoje, kas naudinga stebint nuotaikas tam tikra tema ar prekės ženklo atžvilgiu:

{"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"}]}}

Kodo vykdymas

Grok gali rašyti ir vykdyti Python kodą izoliuotoje aplinkoje. Responses API šis įrankis vadinamas code_interpreter (xAI SDK jį vadina 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"}]}}

Kodo vykdymas aktualus tiksliems skaičiavimams, statistikai ir duomenų transformacijoms, kurias modelis iš atminties atliktų mažiau patikimai.

Nuotoliniai MCP serveriai

Įrankis mcp sujungia Grok su nuotoliniu MCP serveriu, aprašytu pačioje užklausoje: jokių išankstinių paskyros konfigūracijų nereikia. Būtini parametrai yra server_url ir server_label; allowed_tools apriboja eksponuojamus įrankius, o authorization perduoda prieigos raktą serveriui. Priimami tik Streamable HTTP ir SSE transporto protokolai.

{"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"}]}}

Be allowed_tools, visi serverio įrankių apibrėžimai įterpiami į modelio kontekstą ir apmokestinami kaip įvesties tokenai kiekvienoje partijų užklausoje: esant 50 000 užklausų, sąrašo apribojimas greitai atsiperka.

Kliento pusės funkcijų kvietimas

Funkcijų kvietimas yra kliento pusės įrankis: Grok sugeneruoja struktūrizuotą funkcijos kvietimą, bet jį vykdo tavo kodas. Partijų režimu modelis šiuos kvietimus grąžina savo rezultatuose tolesniam apdorojimui ne realiuoju laiku.

Funkcijų apibrėžimai

Responses API deklaruok funkciją plokščiai, viršutiniame lygmenyje naudodamas name, description ir parameters. tool_choice: "required" priverčia modelį iškviesti bent vieną įrankį, kas tinka duomenų gavybai:

{"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"}}

Rezultatų apdorojimas

Naudodamas SDK, nuskaityk funkcijų kvietimus iš kiekvieno sėkmingo rezultato 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)

Partijų funkcijų kvietimas idealiai tinka struktūrizuotai gavybai: tu apibrėži duomenų schemą, Grok nuskaity dokumentus ir sugeneruos kvietimus, o tu juos apdorosi masiniu būdu.

Įrankių derinimas

Vienoje užklausoje gali derinti kelis serverio įrankius:

{"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 naudoja įrankius tokia tvarka, kokia mano esant tinkama: čia pirmiausia web paieška duomenims gauti, o tada kodo vykdymas skaičiavimui atlikti.

Partijų įrankių apribojimai

  • Serverio įrankiai pailgina kiekvienos užklausos, taigi ir visos partijos, apdorojimo laiką.
  • Užklausos su paieška priklauso nuo to, ką šaltiniai publikuoja apdorojimo metu, o ne pateikimo metu.
  • Funkcijų kvietimas atlieka tik vieną užklausos ciklą vienai užklausai: norint tęsti, turi pateikti naują partijų užklausą, kurioje būtų pokalbis ir tavo funkcijų rezultatai.
  • nefiltruoti MCP įrankių apibrėžimai perpildo kiekvieną užklausą.

Svarbiausi punktai

  • Serverio įrankiai (web, X, kodas, MCP) vykdomi xAI apdorojimo metu per Responses API.
  • MCP serverį aprašyk užklausoje (server_url, server_label) be jokių išankstinių konfigūracijų.
  • Funkcijų kvietimas grąžina struktūrizotus kvietimus, kuriuos vykdi kliento pusėje.
  • Daugiau nei vieno žingsnio pokalbiui reikia naujos partijų užklausos kiekvienam žingsniui.
  • Apribok eksponuojamus įrankius, kad nemokėtum už jų apibrėžimus kiekvienoje užklausoje.