Palvelintyökalut ja funktiokutsut
Tällä sivulla
Kurssi päivitetty 2. marraskuuta 2026 xAI:n dokumentaation perusteella: alennus eräajosta on 20 % kelvollisissa tekstimalleissa (ei 50 %), esimerkit noudattavat REST API:a ja virallista
xai-sdk:ta (client.batch.*; xAI:n Batch API ei käytä OpenAI:n muotoa, joten OpenAI SDK ei sovellu), ja Responses API on ensisijainen verrattuna Chat Completionsiin, joka on xAI:lla vanhentunut päätepiste. Lähteet: Batch API · REST Reference · Batch Pricing.
Eräajojen rikastaminen työkaluilla
Eräpyynnöt eivät rajoitu pelkkään raakatekstiin. Palvelintyökalut ja funktiokutsut toimivat myös asynkronisessa tilassa, mutta niillä on keskeinen ero: edelliset suorittaa xAI käsittelyn aikana, kun taas jälkimmäiset palauttavat hallinnan sinulle.
Palvelinpuolen työkalut
Palvelintyökalut suoritetaan eräajon aikana täsmälleen samalla tavalla kuin reaaliajassa: Grok kutsuu työkalua, vastaanottaa tuloksen, integroi sen päättelyynsä, ja eräajo palauttaa lopullisen vastauksen. Ne toimivat Responses API:n kanssa.
Verkkohaku
{"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"}]}}
Erätilassa verkkohaku palvelee datan rikastamista: tietojen varmentamista, tuoreiden faktojen keräämistä ja profiilien vertailua verkkolähteisiin.
X-haku
x_search-työkalu hakee viestejä X:stä, mikä on hyödyllistä seurattaessa mielialaa tiettyä aihetta tai brändiä kohtaan:
{"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"}]}}
Koodin suoritus
Grok osaa kirjoittaa ja suorittaa Python-koodia eristetyssä ympäristössä. Responses API:ssa työkalun nimi on code_interpreter (xAI SDK kutsuu sitä nimellä 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"}]}}
Koodin suoritus on relevanttia tarkkojen laskelmien, tilastojen ja datamuunnosten tekemiseen, joita malli käsittelisi epäluotettavammin muistinsa varassa.
Etä-MCP-palvelimet
mcp-työkalu yhdistää Grokin etä-MCP-palvelimeen, joka määritellään itse pyynnössä: etukäteistä tilimääritystä ei tarvita. server_url ja server_label ovat pakollisia; allowed_tools rajoittaa käytettäviä työkaluja, ja authorization välittää tunnisteen palvelimelle. Vain Streamable HTTP ja SSE -siirtotavat hyväksytään.
{"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"}]}}
Ilman allowed_tools-parametria kaikki palvelimen työkalumääritykset injektoidaan mallin kontekstiin ja niistä veloitetaan syöttötokeneina jokaisessa eräpyynnössä: 50 000 pyynnön erässä listan rajoittaminen kannattaa nopeasti.
Asiakaspuolen funktiokutsut
Funktiohaku on asiakaspuolen työkalu: Grok tuottaa jäsennellyn funktiokutsun, mutta koodisi suorittaa sen. Eräajossa malli palauttaa nämä kutsut tuloksissaan offline-käsittelyä varten.
Funktiomääritykset
Responses API:ssa määrittele funktio litteästi käyttäen name, description ja parameters -kenttiä ylätasolla. tool_choice: "required" pakottaa mallin kutsumaan vähintään yhtä työkalua, mikä sopii tiedon ekstraktioon:
{"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"}}
Tulosten käsittely
SDK:n avulla voit lukea funktiokutsut kunkin onnistuneen tuloksen tool_calls-kentästä:
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)
Eräajon funktiokutsut ovat ihanteellisia jäsenneltyyn tiedon ekstraktioon: määrittelet dataskaeman, Grok lukee dokumentit ja tuottaa kutsut, jonka jälkeen käsittelet ne eräajona.
Työkalujen yhdistäminen
Voit yhdistää useita palvelintyökaluja samaan pyyntöön:
{"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 käyttää työkaluja järjestyksessä, jonka se katsoo relevantiksi: tässä tapauksessa ensin verkkohaku datan hakemiseksi ja sen jälkeen koodin suoritus laskelman tekemiseksi.
Eräajon työkalurajoitukset
- Palvelintyökalut pidentävät jokaisen pyynnön ja siten koko eräajon käsittelyaikaa.
- Hakua sisältävät pyynnöt riippuvat lähteiden julkaisemasta sisällöstä käsittelyhetkellä, eivät lähetyshetkellä.
- Funktiokutsuissa tehdään vain yksi kierros pyyntöä kohden: jatkaaksesi sinun on lähetettävä uusi eräpyyntö, joka sisältää keskustelun ja funktiotuloksesi.
- Suodattamattomat MCP-työkalumääritykset paisuttavat jokaista pyyntöä.
Keskeiset asiat
- Palvelintyökalut (web, X, koodi, MCP) suorittaa xAI käsittelyn aikana Responses API:n kautta.
- Kuvaile MCP-palvelin pyynnössä (
server_url,server_label) ilman etukäteismäärityksiä. - Funktiokutsut palauttavat jäsenneltyjä kutsuja, jotka suoritat asiakaspuolella.
- Monivaiheinen vuorovaikutus vaatii uuden eräpyynnön jokaista vaihetta kohden.
- Rajoita käytettäviä työkaluja välttääksesi niiden määritysten maksamisen jokaisessa pyynnössä.