Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Palvelintyökalut ja funktiokutsut

Oppitunti 10 / 12 Päivitetty 2. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Eräajojen rikastaminen työkaluilla
  2. Palvelinpuolen työkalut
  3. Asiakaspuolen funktiokutsut
  4. Työkalujen yhdistäminen
  5. Eräajon työkalurajoitukset
  6. Keskeiset asiat

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ä.