Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Serveri tööriistad ja funktsioonide kutsumine

Õppetund 10 / 12 Värskendatud 2. november 2026 Arendajatele
Sellel lehel
  1. Partii rikastamine tööriistadega
  2. Serveripoolsed tööriistad
  3. Kliendipoolne funktsioonide kutsumine
  4. Tööriistade kombineerimine
  5. Partii tööriistade piirangud
  6. Peamised punktid

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.