Aktiviraj pretraživanje weba u API-ju
Na ovoj stranici
Ažurirano 2. studenoga 2026. Na temelju dokumentacije xAI: uz
xai-sdk, pretraživanje weba omogućuje se funkcijomweb_search()uvezenom izxai_sdk.tools, unutar razgovora stvorenog pomoćuclient.chat.create; stari primjer koji je pozivaoclient.tools.web_search()iclient.responses.create()ne postoji u ovom SDK-u. Izvor: Web Search.
Omogući Groku pristup webu u stvarnom vremenu
Pretraživanje weba najčešće korišteni integrirani alat u Grok API-ju. Modelu omogućuje traženje ažurnih informacija na webu, čime se prevladava prirodno ograničenje njegovih podataka za obuku. Aktivacija je jednostavna, no postoji nekoliko ključnih točaka koje moraš savladati za učinkovitu uporabu.
Preduvjeti: Responses API
Pretraživanje weba dostupno je isključivo na Responses API-ju. Stari Chat Completions API nudio je sustav „Live Search“ koji je sada zastario. Ako još uvijek koristiš Chat Completions za pretraživanje weba, moraš prijeći na Responses API.
Responses API koristi client.responses.create() umjesto client.chat.completions.create(). Struktura zahtjeva i odgovora razlikuje se, ali i xAI SDK i OpenAI SDK podržavaju oba pristupa.
Osnovna aktivacija
Pretraživanje weba omogućuješ dodavanjem objekta {"type": "web_search"} u polje tools svog zahtjeva:
{
"model": "grok-4.20-0309-reasoning",
"input": "What are the latest advancements in artificial intelligence?",
"tools": [
{"type": "web_search"}
]
}
To je sve što ti treba za osnovno pretraživanje weba. Model automatski određuje treba li izvršiti pretraživanje i formulira optimalni upit za pretraživanje na temelju korisničke poruke.
Aktivacija s xAI SDK-om (Python)
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.20-0309-reasoning",
tools=[web_search()],
)
chat.append(user("What are the latest advancements in AI?"))
response = chat.sample()
print(response.content)
print(response.citations)
SDK pruža funkciju web_search() koja generira objekt konfiguracije alata. Također prihvaća allowed_domains ili excluded_domains—do pet domena, i nikada obje opcije u istom zahtjevu.
Aktivacija s OpenAI SDK-om
from openai import OpenAI
client = OpenAI(
api_key="xai-your-key",
base_url="https://api.x.ai/v1"
)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What are the latest advancements in AI?",
tools=[{"type": "web_search"}]
)
OpenAI SDK radi s Grok API-jem jednostavnom promjenom base_url. Sintaksa alata ostaje identična.
Aktivacija s Vercel AI SDK-om
import { xai } from "@ai-sdk/xai";
const response = await generateText({
model: xai("grok-4.20-0309-reasoning"),
prompt: "What are the latest advancements in AI?",
tools: [xai.tools.webSearch()]
});
Vercel AI SDK koristi xai.tools.webSearch() poštujući konvenciju camelCase u JavaScriptu.
Kombiniraj pretraživanje weba s drugim alatima
Možeš istovremeno omogućiti više alata. Model će odabrati najprikladniji ili će ih koristiti uzastopno:
{
"tools": [
{"type": "web_search"},
{"type": "code_interpreter"}
]
}
U ovom primjeru model može pretraživati podatke na webu, a zatim ih analizirati pomoću izvršavanja koda.
Ključne točke
- Pretraživanje weba dostupno je isključivo na Responses API-ju—Chat Completions je zastario za ovu značajku
- Omogući ga s
{"type": "web_search"}u poljutools - Model automatski odlučuje kada i kako pretraživati
- Svi SDK-ovi (xAI, OpenAI, Vercel AI) podržavaju pretraživanje weba
- U istom zahtjevu možeš istovremeno omogućiti više alata