Alati poslužitelja i pozivanje funkcija
Na ovoj stranici
Tečaj ažuriran 2. studenoga 2026. na temelju dokumentacije xAI-ja: popust za skupne zahtjeve iznosi 20 % na kvalificirane tekstualne modele (ne 50 %), primjeri slijede REST API i službeni
xai-sdk(client.batch.*; xAI-jev Batch API ne koristi format OpenAI-ja, stoga se OpenAI SDK ne primjenjuje), a Responses API ima prednost nad Chat Completions, koji je kod xAI-ja zastarjela krajnja točka. Izvori: Batch API · REST Reference · Batch Pricing.
Obogaćivanje skupnih zahtjeva alatima
Skupni zahtjevi nisu ograničeni samo na sirovi tekst. Alati poslužitelja i pozivanje funkcija rade i u asinkronom načinu, uz ključnu razliku: prve pokreće xAI tijekom obrade, dok druge vraćaju kontrolu tebi.
Alati na strani poslužitelja
Alati poslužitelja izvršavaju se tijekom obrade skupnog zahtjeva, točno kao u stvarnom vremenu: Grok poziva alat, prima rezultat, integrira ga u svoje zaključivanje, a skupni zahtjev vraća konačni odgovor. Rade s Responses API-jem.
Web pretraživanje
{"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"}]}}
U skupnom načinu web pretraživanje služi za obogaćivanje podataka: provjeru informacija, prikupljanje nedavnih činjenica i usporedbu profila s internetskim izvorima.
Pretraživanje X-a
Alat x_search upituje objave na X-u, što je korisno za praćenje sentimenta o određenoj temi ili brendu:
{"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"}]}}
Izvršavanje koda
Grok može pisati i izvršavati Python kod u izoliranom okruženju. U Responses API-ju alat se zove code_interpreter (xAI SDK ga naziva 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"}]}}
Izvršavanje koda relevantno je za precizne izračune, statistiku i transformacije podataka koje bi model manje pouzdano obrađivao iz memorije.
Udaljeni MCP poslužitelji
Alat mcp povezuje Groka s udaljenim MCP poslužiteljem opisanim izravno u zahtjevu: nije potrebna prethodna konfiguracija računa. Polja server_url i server_label su obavezna; allowed_tools ograničava izložene alate, a authorization prosljeđuje token poslužitelju. Prihvaćeni su samo transporti Streamable HTTP i SSE.
{"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"}]}}
Bez parametra allowed_tools, sve definicije alata s poslužitelja ubacuju se u kontekst modela i naplaćuju kao ulazni tokeni u svakom skupnom zahtjevu: kod 50 000 zahtjeva, ograničavanje popisa brzo se isplati.
Pozivanje funkcija na strani klijenta
Pozivanje funkcija alat je na strani klijenta: Grok proizvodi strukturirani poziv funkcije, ali tvoj kod ga izvršava. U skupnom načinu model vraća te pozive u svojim rezultatima radi naknadne obrade.
Definicije funkcija
U Responses API-ju funkciju deklariraš ravno, s poljima name, description i parameters na najvišoj razini. Postavka tool_choice: "required" prisiljava model da pozove barem jedan alat, što odgovara ekstrakciji podataka:
{"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"}}
Obrada rezultata
Pomoću SDK-a čitaj pozive funkcija u tool_calls svakog uspješnog rezultata:
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)
Skupno pozivanje funkcija idealno je za strukturiranu ekstrakciju: definiraš shemu podataka, Grok čita dokumente i proizvodi pozive, a ti ih zatim obrađuješ u seriji.
Kombiniranje alata
Možeš kombinirati više alata poslužitelja u jednom zahtjevu:
{"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 koristi alate redoslijedom koji smatra relevantnim: ovdje prvo web pretraživanje za dobivanje podataka, zatim izvršavanje koda za izračun.
Ograničenja alata u skupnom načinu
- Alati poslužitelja produžuju vrijeme obrade svakog zahtjeva, a time i cijelog skupa
- Zahtjevi s pretraživanjem ovise o tome što izvori objave u trenutku obrade, a ne u trenutku slanja
- Pozivanje funkcija omogućuje samo jedan krug razmjene po zahtjevu: za nastavak moraš poslati novi skupni zahtjev koji sadrži razgovor i tvoje rezultate funkcija
- Nefiltrirane definicije MCP alata nepotrebno povećavaju svaki zahtjev
Ključne točke
- Alati poslužitelja (web, X, kod, MCP) koje xAI pokreće tijekom obrade putem Responses API-ja
- MCP poslužitelj opiši u zahtjevu (
server_url,server_label) bez prethodne konfiguracije - Pozivanje funkcija vraća strukturirane pozive koje izvršavaš na strani klijenta
- Razmjena u više koraka zahtijeva novi skupni zahtjev po svakom koraku
- Ograniči izložene alate kako ne bi plaćao njihove definicije u svakom zahtjevu