Omogoči spletno iskanje v API-ju Grok
Na tej strani
Posodobljeno 2. novembra 2026. Na podlagi dokumentacije xAI: pri uporabi
xai-sdkse spletno iskanje aktivira prek funkcijeweb_search(), uvožene izxai_sdk.tools, znotraj pogovora, ustvarjenega zclient.chat.create; stari primer je klicalclient.tools.web_search(), kar v tem SDK-ju ne obstaja. Vir: Web Search.
Posodobljeno 3. novembra 2026. Prvi primer je klical
client.responses.create()na odjemalcuxai-sdk, ki nima atributaresponses: pri tem SDK-ju poteka iskanje prekclient.chat.create(..., tools=[web_search()]), medtem koclient.responses.create()spada v SDKopenai, usmerjen nahttps://api.x.ai/v1. Primer Vercel AI SDK je orodja posredoval kot polje in ni uvozilgenerateText: ta jih deklarira v objektu, kot je zapisano v dokumentaciji xAI. Koda preverjena z različicamaxai-sdk1.21.0 inopenai3.42.1. Vir: Web Search.
Zakaj povezati Grok s spletom v realnem času
Klasični jezikovni modeli delujejo z znanjem, zamrznjenim na datum njihovega usposabljanja. Za razvijalca, ki gradi aplikacije, ki zahtevajo trenutne podatke (cene delnic, novice, športni rezultati, vreme), je ta omejitev nesprejemljiva. Orodje web_search v API-ju Grok rešuje ta problem tako, da modelu omogoča poizvedbe na spletu v realnem času, neposredno iz vašega klica API.

Za razliko od drugih ponudnikov, ki zahtevajo integracije tretjih strani ali ločene vtičnike, xAI ponuja spletno iskanje kot vgrajeno orodje na strani strežnika. Ni vam treba upravljati nobene infrastrukture: model sam odloči, kdaj iskati, izvede poizvedbo in rezultate vključi v svoj odgovor.
API za odgovore: edina podprta končna točka
Spletno iskanje deluje izključno na API-ju za odgovore (Responses API). Stara končna točka Chat Completions je ponujala parameter search_parameters, vendar je zdaj zastarela. Če prehajate s starega API-ja, boste morali prilagoditi svoje klice.
Aktivacija poteka z dodajanjem orodja web_search v polje tools v vaši zahtevi:
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="Kakšno je danes vreme v Parizu?",
tools=[{"type": "web_search"}],
)
print(response.output_text)
Ta primer uporablja SDK openai, združljiv z API-jem xAI Responses; domači SDK xAI, predstavljen spodaj, poteka prek pogovora.
To je vse. Model analizira vaš poziv, ugotovi, ali potrebuje sveže informacije, in samodejno sproži iskanje. Ni vam treba upravljati zanke klicev ali pogojne logike.
Petstopenjski tok izvajanja
Ko pošljete zahtevo z omogočenim web_search, postopek sledi določenemu zaporedju:
- Analiza: model oceni, ali vprašanje zahteva nedavne podatke
- Odločitev: se odloči za iskanje ali odgovor z notranjim znanjem
- Izvajanje: spletno iskanje teče na strani strežnika (vi ne upravljate ničesar)
- Obdelava: rezultati so analizirani in sintetizirani
- Odgovor: končno besedilo je ustvarjeno s pripadajočimi citati
Ta mehanizem pomeni, da se model lahko odloči, da ne bo iskal, če vprašanje tega ne upravičuje. Na primer, vprašanje po definiciji fotosinteze verjetno ne bo sprožilo spletnega iskanja.
Uporaba z različnimi SDK-ji
SDK xAI ponuja namensko funkcijo web_search(), ki jo posredujete v seznam orodij pogovora:
# Domači SDK xAI
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("Najnovejše novice o AI v Evropi"))
response = chat.sample()
print(response.content)
print(response.citations)
Pri SDK-ju openai gre za klic z začetka lekcije: client.responses.create() z base_url="https://api.x.ai/v1" in tools=[{"type": "web_search"}].
Za Vercel AI SDK v JavaScriptu:
import { xai } from '@ai-sdk/xai';
import { generateText } from 'ai';
const { text, sources } = await generateText({
model: xai.responses('grok-4.5'),
prompt: "Najnovejše novice o AI v Evropi",
tools: {
web_search: xai.tools.webSearch(),
},
});
console.log(text);
console.log('Citations:', sources);
Praktična vaja
Ustvari skripto, ki poizveduje pri Groku o trenutnem dogodku po tvoji izbiri. Preveri, ali odgovor vsebuje nedavne informacije (datume, dogodke, ki so se zgodili po datumu zaključka usposabljanja modela). Nato poskusi isto vprašanje brez orodja web_search, da vidiš razliko.
Ključne ugotovitve
- Spletno iskanje se aktivira z
{"type": "web_search"}vtools(SDKopenai, API Responses) aliweb_search()vclient.chat.create(xai-sdk) - Deluje samo na API-ju Responses (ne na Chat Completions)
- Model samostojno odloči, kdaj potrebuje iskanje
- Citati so samodejno vključeni v odgovor
- Strošek znaša 5 $ na 1.000 klicev orodja, plus porabljeni žetoni