Veebiotsingu lubamine API-s
Sellel lehel
Uuendatud 2. novembril 2026. xAI dokumentatsiooni põhjal:
xai-sdkpuhul lubatakse veebiotsing funktsioonigaweb_search(), mis imporditakse moodulistxai_sdk.tools, vestluses, mille loobclient.chat.create; vana näide kasutasclient.tools.web_search()jaclient.responses.create(), mida selles SDK-s ei eksisteeri. Allikas: Web Search.
Anna Grokile reaalajas juurdepääs veebile
Veebiotsing on Grok API kõige enam kasutatav integreeritud tööriist. See võimaldab mudelil otsida ajakohast teavet veebist, ületades nii selle treeningandmete loomuliku piirangu. Aktiveerimine on lihtne, kuid tõhusaks kasutamiseks tuleb valdada mõned võtmepunktid.
Eeldused: Responses API
Veebiotsing on saadaval ainult Responses API kaudu. Vana Chat Completions API pakkus „Live Search“ süsteemi, mis on nüüd aegunud. Kui kasutad veebiotsinguks endiselt Chat Completionsi, pead migreeruma Responses API-le.
Responses API kasutab meetodit client.responses.create() meetodi client.chat.completions.create() asemel. Päringu ja vastuse struktuur erineb, kuid nii xAI SDK kui ka OpenAI SDK toetavad mõlemat.
Põhiline aktiveerimine
Lubad veebiotsingu, lisades oma päringus massiivi tools objekti {"type": "web_search"}:
{
"model": "grok-4.20-0309-reasoning",
"input": "What are the latest advancements in artificial intelligence?",
"tools": [
{"type": "web_search"}
]
}
See on kõik, mida vajad põhitasemel veebiotsinguks. Mudel määrab automaatselt, kas otsingut teha, ja formuleerib kasutaja sõnumi põhjal optimaalse otsingupäringu.
Aktiveerimine xAI SDK-ga (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 pakub funktsiooni web_search(), mis genereerib tööriista konfiguratsiooni objekti. See aktsepteerib ka parameetreid allowed_domains või excluded_domains – kuni viis domeeni, kuid mitte kunagi mõlemat samas päringus.
Aktiveerimine OpenAI SDK-ga
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 töötab Grok API-ga, muutes lihtalt base_url-i. Tööriista süntaks jääb identseks.
Aktiveerimine Vercel AI SDK-ga
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 kasutab JavaScripti camelCase konventsiooni järgi funktsiooni xai.tools.webSearch().
Kombineeri veebiotsing teiste tööriistadega
Saad korraga lubada mitu tööriista. Mudel valib kõige sobivama või kasutab neid järjestikku:
{
"tools": [
{"type": "web_search"},
{"type": "code_interpreter"}
]
}
Selles näites saab mudel otsida andmeid veebist ja seejärel analüüsida neid koodi käivitamise (Code Execution) abil.
Peamised punktid
- Veebiotsing on saadaval ainult Responses API kaudu – Chat Completions on selle funktsiooni jaoks aegunud
- Luba see, lisades massiivi
toolsobjekti{"type": "web_search"} - Mudel otsustab automaatselt, millal ja kuidas otsingut teha
- Kõik SDK-d (xAI, OpenAI, Vercel AI) toetavad veebiotsingut
- Saad samas päringus korraga lubada mitu tööriista