Aktiveeri veebiotsing Grok API-s
Sellel lehel
Uuendatud 2. novembril 2026. xAI dokumentatsiooni põhjal:
xai-sdkpuhul aktiveeritakse veebiotsing funktsioonigaweb_search(), mis imporditakse moodulistxai_sdk.tools, vestluses, mille loobclient.chat.create; vana näide kasutas kutsetclient.tools.web_search(), mida selles SDK-s ei eksisteeri. Allikas: Web Search.
Uuendatud 3. novembril 2026. Esimeses näites kutsuti
xai-sdkkliendil meetoditclient.responses.create(), kuid sellel kliendil puudub atribuutresponses: selle SDK puhul toimub otsing läbiclient.chat.create(..., tools=[web_search()]), samas kuiclient.responses.create()kuulubopenaiSDK-le, mis on suunatud aadressilehttps://api.x.ai/v1. Vercel AI SDK näides anti tööriistad edasi massiivina ja ei imporditudgenerateText-i: need deklareeritakse objektis, nagu on kirjeldatud xAI dokumentatsioonis. Kood on kontrollitud versioonidegaxai-sdk1.21.0 jaopenai3.42.1. Allikas: Web Search.
Miks ühendada Grok reaalajas veebiga
Klassikalised keelemudelid töötavad teadmistega, mis on külmutatud nende treeningkuupäeva seisuga. Arendajale, kes ehitab rakendusi, mis vajavad aktuaalseid andmeid (aktsiahinnad, uudised, sporditulemused, ilm), on see piirang saatuslik. Grok API tööriist web_search lahendab selle probleemi, võimaldades mudelil teha päringuid veebi reaalajas otse sinu API-kutse kaudu.

Erinevalt teistest pakkujatest, kes nõuavad kolmandate osapoolte integratsioone või eraldi pistikprogramme, pakub xAI veebiotsingut kui serveripoolset sisseehitatud tööriista. Sul pole taristut, mida hallata: mudel otsustab ise, millal otsingut teha, käivitab päringu ja integreerib tulemused oma vastusesse.
Responses API: ainus toetatud lõpp-punkt
Veebiotsing toimib eranditult Responses API kaudu. Vana Chat Completionsi lõpp-punkt pakkus parameetrit search_parameters, kuid see on nüüd aegunud. Kui migreerud vanalt API-lt, pead oma kutsed kohandama.
Aktiveerimine toimub, lisades tööriista web_search oma päringus olevasse massiivi tools:
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="Milline on täna Pariisis ilm?",
tools=[{"type": "web_search"}],
)
print(response.output_text)
See näide kasutab openai SDK-d, mis ühildub xAI Responses API-ga; allpool esitatud loomulik xAI SDK kasutab vestlusliidest.
See ongi kõik. Mudel analüüsib sinu sisendit, teeb kindlaks, kas ta vajab värsket teavet, ja käivitab otsingu automaatselt. Sul ei ole vaja hallata kutsete tsüklit ega tingimuslikku loogikat.
Viieastmeline täitmise voog
Kui saadad päringu, mille puhul on web_search lubatud, järgib protsess kindlat järjestust:
- Analüüs: mudel hindab, kas küsimus nõuab värskeid andmeid
- Otsus: ta valib, kas teha otsing või vastata oma sisemiste teadmiste põhjal
- Täitmine: veebiotsing käivitub serveripoolselt (sina ei haldagi midagi)
- Töötlemine: tulemused analüüsitakse ja sünteesitakse
- Vastus: lõplik tekst genereeritakse koos vastavate viidetega
See mehhanism tähendab, et mudel võib otsustada mitte otsingut teha, kui küsimus seda ei õigusta. Näiteks fotosünteesi definitsiooni küsimine tõenäoliselt veebiotsingut ei käivita.
Kasutamine erinevate SDK-dega
xAI SDK pakub spetsiaalset funktsiooni web_search(), mille saad edastada vestluse tööriistade loendisse:
# Loomulik 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("Viimased AI uudised Euroopas"))
response = chat.sample()
print(response.content)
print(response.citations)
openai SDK puhul on tegemist tunni alguses näidatud kutsega: client.responses.create() koos base_url="https://api.x.ai/v1" ja tools=[{"type": "web_search"}].
Vercel AI SDK jaoks JavaScriptis:
import { xai } from '@ai-sdk/xai';
import { generateText } from 'ai';
const { text, sources } = await generateText({
model: xai.responses('grok-4.5'),
prompt: "Viimased AI uudised Euroopas",
tools: {
web_search: xai.tools.webSearch(),
},
});
console.log(text);
console.log('Citations:', sources);
Praktiline harjutus
Loo skript, mis küsib Grokilt mõne sinu valitud aktuaalse sündmuse kohta. Veendu, et vastus sisaldab värsket teavet (kuupäevad, sündmused, mis toimusid pärast mudeli teadmiste piirkuupäeva). Seejärel proovi sama küsimust ilma tööriistata web_search, et näha erinevust.
Peamised punktid
- Veebiotsing aktiveeritakse parameetriga
{"type": "web_search"}massiivistools(openaiSDK, Responses API) või funktsioonigaweb_search()meetodisclient.chat.create(xai-sdk) - See toimib ainult Responses API-l (mitte Chat Completionsil)
- Mudel otsustab autonoomselt, millal on vaja otsingut teha
- Viited lisatakse vastusele automaatselt
- Maksumus on 5 dollarit 1000 tööriistakutse kohta, pluss tarbitud tokenid