Serveri tööriistad ja funktsioonide kutsumine
Sellel lehel
Kursust uuendati 2. novembril 2026 vastavalt xAI dokumentatsioonile: soodustus partii töötlemisel on 20% sobivate tekst mudelite puhul (mitte 50%), näited järgivad REST API-t ja ametlikku
xai-sdk-d (client.batch.*; xAI partii API ei kasuta OpenAI vormingut, OpenAI SDK ei kehti) ning Responses API-l on Chat Completionsi ees ülimuslik seis, mis on xAI-s iganenud lõpp-punkt. Allikad: Batch API · REST Reference · Batch Pricing.
Partii rikastamine tööriistadega
Partii päringud ei piirdu ainult toore tekstiga. Serveri tööriistad ja funktsioonide kutsumine toimivad ka asünkroonses režiimis, kusjuures peamine erinevus seisneb selles: esimesi käivitab töötlemise ajal xAI, teised aga annavad kontrolli sulle tagasi.
Serveripoolsed tööriistad
Serveri tööriistad käivituvad partii töötlemise ajal täpselt nagu reaalajas: Grok kutsub tööriista, saab tulemuse, integreerib selle oma arutluskäiku ja partii tagastab lõpliku vastuse. Need töötavad Responses API-ga.
Veebiotsing
{"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"}]}}
Partii režiimis kasutatakse veebiotsingut andmete rikastamiseks: teabe kontrollimine, värskete faktide kogumine, profiilide võrdlemine veebiallikatega.
X-otsing
Tööriist x_search päringutab postitusi platvormil X, mis on kasulik meeleolu jälgimiseks kindla teema või brändi osas:
{"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"}]}}
Koodi täitmine
Grok suudab kirjutada ja käivitada Pythoni koodi isoleeritud keskkonnas. Responses API-s kannab see tööriist nime code_interpreter (xAI SDK nimetab seda 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"}]}}
Koodi täitmine on asjakohane täpsete arvutuste, statistika ja andmete teisendamise jaoks, mida mudel mälu põhjal vähem usaldusväärselt käsitleks.
Kaug-MCP serverid
Tööriist mcp ühendab Groki kaug-MCP serveriga, mida kirjeldatakse otse päringus: eelnevat konto seadistamist pole vaja. Kohustuslikud on server_url ja server_label; allowed_tools piirab avaldatavaid tööriistu ja authorization edastab serverile tokeni. Lubatud on ainult Streamable HTTP ja SSE transpordid.
{"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"}]}}
Ilma allowed_tools-ita süstitakse mudeli konteksti kõik serveri tööriistade definitsioonid ja neid arvestatakse sisendtokenitena iga partii päringu puhul: 50 000 päringu korral tasub nimekirja piiramine end kiiresti ära.
Kliendipoolne funktsioonide kutsumine
Funktsioonide kutsumine on kliendipoolne tööriist: Grok genereerib struktureeritud funktsioonikutse, kuid sinu kood viib selle täide. Partii režiimis tagastab mudel need kutsed oma tulemustes edasiseks offline-töötlemiseks.
Funktsioonide definitsioonid
Responses API-s deklareeri funktsioon lamedalt, kasutades ülemisel tasemel välju name, description ja parameters. Säte tool_choice: "required" sunnib mudelit kutsuma vähemalt üht tööriista, mis sobib hästi andmete ekstraheerimiseks:
{"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"}}
Tulemuste töötlemine
SDK-d kasutades loe funktsioonikutsed iga õnnestunud tulemuse väljalt 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)
Partii põhinev funktsioonide kutsumine on ideaalne struktureeritud ekstraheerimiseks: sa defineerid andmeskeemi, Grok loeb dokumendid ja genereerib kutsed, seejärel töötleb sa need hulgina.
Tööriistade kombineerimine
Saad kombineerida mitut serveri tööriista ühes päringus:
{"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 kasutab tööriistu järjekorras, mida peab asjakohaseks: siin esmalt veebiotsing andmete hankimiseks ja seejärel koodi täitmine arvutuse tegemiseks.
Partii tööriistade piirangud
- Serveri tööriistad pikendavad iga päringu ja seega ka kogu partii töötlemisaega.
- Otsingut sisaldavad päringud sõltuvad allikate poolt avaldatust töötlemise hetkel, mitte esitamise hetkel.
- Funktsioonide kutsumine teeb ühe päringu kohta vaid ühe edasi-tagasi suhtluse ringi: jätkamiseks esita uus partii päring, mis sisaldab vestlust ja sinu funktsioonide tulemusi.
- Filtreerimata MCP tööriistade definitsioonid paisutavad iga päringu mahtu.
Peamised punktid
- Serveri tööriistad (veeb, X, kood, MCP) käivitab xAI töötlemise ajal Responses API kaudu.
- Kirjelda MCP serverit päringus (
server_url,server_label) ilma eelneva seadistamiseta. - Funktsioonide kutsumine tagastab struktureeritud kutsed, mida täidad kliendipoolselt.
- Mitmevooruline vahetus nõuab iga vooru kohta uut partii päringut.
- Piira avaldatavaid tööriistu, et vältida nende definitsioonide eest tasumist iga päringu puhul.