Aktiviraj pretraživanje weba u Grok API-ju
Na ovoj stranici
Ažurirano 2. studenoga 2026. Na temelju dokumentacije xAI-ja: uz
xai-sdk, pretraživanje weba aktivira se funkcijomweb_search()uvezenom izxai_sdk.tools, unutar razgovora stvorenog pomoćuclient.chat.create; stari primjer pozivao jeclient.tools.web_search(), što u ovom SDK-u ne postoji. Izvor: Web Search.
Ažurirano 3. studenoga 2026. Prvi je primjer pozivao
client.responses.create()na klijentuxai-sdk, koji nema atributresponses: s ovim SDK-jem pretraživanje ide krozclient.chat.create(..., tools=[web_search()]), aclient.responses.create()pripada SDK-uopenaiusmjerenom nahttps://api.x.ai/v1. Primjer Vercel AI SDK-a prosljeđivao je alate kao polje i nije uvoziogenerateText: oni ih deklariraju u objektu, kao u dokumentaciji xAI-ja. Kod je verificiran sxai-sdk1.21.0 iopenai3.42.1. Izvor: Web Search.
Zašto povezati Grok s webom u stvarnom vremenu
Klasični jezični modeli rade sa znanjem zamrznutim na datum njihove obuke. Za developera koji gradi aplikacije koje zahtijevaju trenutne podatke (cijene dionica, vijesti, sportski rezultati, vremenska prognoza) ovo je ograničenje neprihvatljivo. Alat web_search u Grok API-ju rješava taj problem omogućujući modelu da izravno iz tvog API poziva upiti web u stvarnom vremenu.

Za razliku od drugih pružatelja usluga koji zahtijevaju integracije trećih strana ili zasebne dodatke, xAI nudi pretraživanje weba kao ugrađeni alat na strani poslužitelja. Nemaš nikakvu infrastrukturu za održavanje: model sam odlučuje kada pretraživati, izvršava upit i integrira rezultate u svoj odgovor.
Responses API: jedina podržana krajnja točka
Pretraživanje weba radi isključivo na Responses API-ju. Stara krajnja točka Chat Completions nudila je parametar search_parameters, ali je sada zastarjela. Ako migriraš sa starog API-ja, morat ćeš prilagoditi svoje pozive.
Aktivacija se događa dodavanjem alata web_search u polje tools u tvom zahtjevu:
import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["XAI_API_KEY"], base_url="https://api.x.ai/v1")
response = client.responses.create(
model="grok-4.5",
input="Kakvo je vrijeme danas u Parizu?",
tools=[{"type": "web_search"}],
)
print(response.output_text)
Ovaj primjer koristi SDK openai, kompatibilan s xAI Responses API-jem; izvorni xAI SDK, predstavljen u nastavku, radi kroz razgovor.
To je to. Model analizira tvoj upit, utvrđuje treba li svježe informacije i automatski pokreće pretraživanje. Ne moraš upravljati petljom poziva niti uvjetnom logikom.
Pet koraka tijeka izvršavanja
Kada pošalješ zahtjev s omogućenim web_search, proces slijedi određeni niz:
- Analiza: model procjenjuje zahtijeva li pitanje nedavne podatke
- Odluka: bira hoće li pretraživati ili odgovoriti svojim internim znanjem
- Izvršavanje: pretraživanje weba pokreće se na strani poslužitelja (ti ništa ne upravljaš)
- Obrada: rezultati se analiziraju i sažimaju
- Odgovor: konačni tekst generira se s pripadajućim citatima
Ovaj mehanizam znači da model može odlučiti ne pretraživati ako pitanje to ne opravdava. Na primjer, traženje definicije fotosinteze vjerojatno neće pokrenuti pretraživanje weba.
Korištenje s različitim SDK-jevima
xAI SDK pruža namjensku funkciju, web_search(), koju prosljeđuješ u popis alata razgovora:
# Izvorni xAI SDK
from xai_sdk import Client
from xai_sdk.chat import user
from xai_sdk.tools import web_search
client = Client()
chat = client.chat.create(model="grok-4.5", tools=[web_search()])
chat.append(user("Najnovije vijesti o umjetnoj inteligenciji u Europi"))
response = chat.sample()
print(response.content)
print(response.citations)
Uz SDK openai, radi se o pozivu s početka lekcije: client.responses.create() s base_url="https://api.x.ai/v1" i tools=[{"type": "web_search"}].
Za Vercel AI SDK u JavaScriptu:
import { xai } from '@ai-sdk/xai';
import { generateText } from 'ai';
const { text, sources } = await generateText({
model: xai.responses('grok-4.5'),
prompt: "Najnovije vijesti o umjetnoj inteligenciji u Europi",
tools: {
web_search: xai.tools.webSearch(),
},
});
console.log(text);
console.log('Citations:', sources);
Praktična vježba
Napiši skriptu koja ispituje Groka o trenutnom događaju po tvom izboru. Provjeri sadrži li odgovor nedavne informacije (datume, događaje koji su se dogodili nakon datuma zaključno s kojim je model obučen). Zatim pokušaj isto pitanje bez alata web_search kako bi vidio/la razliku.
Ključne točke
- Pretraživanje weba aktivira se s
{"type": "web_search"}utools(SDKopenai, Responses API) iliweb_search()uclient.chat.create(xai-sdk) - Radi samo na Responses API-ju (ne na Chat Completions)
- Model samostalno odlučuje kada treba pretraživati
- Citacije se automatski uključuju u odgovor
- Trošak iznosi 5 USD po 1.000 poziva alata, plus utrošeni tokeni