Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Alati poslužitelja i pozivanje funkcija

Lekcija 10 od 12 Ažurirano 2. studenoga 2026. Programer
Na ovoj stranici
  1. Obogaćivanje skupnih zahtjeva alatima
  2. Alati na strani poslužitelja
  3. Pozivanje funkcija na strani klijenta
  4. Kombiniranje alata
  5. Ograničenja alata u skupnom načinu
  6. Ključne točke

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