Aktivēt tīmekļa meklēšanu Grok API
Šajā lapā
Atjaunināts 2026. gada 2. novembrī. Pamatojoties uz xAI dokumentāciju: izmantojot
xai-sdk, tīmekļa meklēšana tiek aktivizēta, izsaucot funkcijuweb_search(), kas importēta noxai_sdk.tools, sarunas ietvaros, ko izveidoclient.chat.create; vecais piemērs izsaucaclient.tools.web_search(), kas šajā SDK neeksistē. Avots: Web Search.
Atjaunināts 2026. gada 3. novembrī. Pirmajā piemērā tika izsaukts
client.responses.create()uzxai-sdkklientu, kam navresponsesatribūta: ar šo SDK meklēšana notiek caurclient.chat.create(..., tools=[web_search()]), betclient.responses.create()piederopenaiSDK, kas norādīts uzhttps://api.x.ai/v1. Vercel AI SDK piemērā rīki tika padoti kā masīvs un netika importētsgenerateText: tie tiek deklarēti objektā, kā tas ir xAI dokumentācijā. Kods pārbaudīts arxai-sdk1.21.0 unopenai3.42.1. Avots: Web Search.
Kāpēc savienot Grok ar reāllaika tīmekli
Klasiskie valodu modeļi strādā ar zināšanām, kas iesaldētas to apmācības datumā. Izstrādātājam, kurš veido lietotnes, kurām nepieciešami aktuāli dati (akciju cenas, ziņas, sporta rezultāti, laika apstākļi), šis ierobežojums ir nepieņemams. Rīks web_search Grok API atrisina šo problēmu, ļaujot modelim veikt vaicājumus tīmeklī reāllaikā tieši no tava API izsaukuma.

Atšķirībā no citiem sniedzējiem, kuriem nepieciešami trešo pušu integrācijas vai atsevišķi spraudņi, xAI piedāvā tīmekļa meklēšanu kā servera pusē iebūvētu rīku. Tev nav jāpārvalda nekāda infrastruktūra: modelis pats izlemj, kad meklēt, izpilda vaicājumu un integrē rezultātus savā atbildē.
Responses API: vienīgais atbalstītais galapunkts
Tīmekļa meklēšana darbojas tikai ar Responses API. Vecais Chat Completions galapunkts piedāvāja parametru search_parameters, taču tagad tas ir novecojis. Ja migrē no vecās API, tev būs jāpielāgo savi izsaukumi.
Aktivizēšana notiek, pievienojot rīku web_search masīvam tools savā pieprasījumā:
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="Kāds šodien ir laiks Parīzē?",
tools=[{"type": "web_search"}],
)
print(response.output_text)
Šis piemērs izmanto openai SDK, kas ir saderīgs ar xAI Responses API; natīvais xAI SDK, kas apskatīts tālāk, strādā caur sarunu.
Tas arī viss. Modelis analizē tavu uzdevumu, nosaka, vai tam nepieciešama svaiga informācija, un automātiski ierosina meklēšanu. Tev nav jāpārvalda izsaukumu cikls vai nosacījumu loģika.
Piecu soļu izpildes plūsma
Kad nosūti pieprasījumu ar ieslēgtu web_search, process norit pēc specifiskas secības:
- Analīze: modelis novērtē, vai jautājums prasa jaunākos datus
- Lēmums: tas izvēlas vai nu meklēt, vai atbildēt, izmantojot savas iekšējās zināšanas
- Izpilde: tīmekļa meklēšana notiek servera pusē (tu neko nepārvaldi)
- Apstrāde: rezultāti tiek analizēti un sintezēti
- Atbilde: tiek ģenerēts galīgais teksts ar saistītajām atsaucēm
Šis mehānisms nozīmē, ka modelis var izlemt nemeklēt, ja jautājums to neattaisno. Piemēram, jautājot par fotosintēzes definīciju, tīmekļa meklēšana, visticamāk, netiks ierosināta.
Lietošana ar dažādiem SDK
xAI SDK nodrošina īpašu funkciju web_search(), ko padot sarunas rīku sarakstā:
# Natīvais 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("Jaunākās AI ziņas Eiropā"))
response = chat.sample()
print(response.content)
print(response.citations)
Izmantojot openai SDK, tas ir izsaukums no nodarbības sākuma: client.responses.create() ar base_url="https://api.x.ai/v1" un tools=[{"type": "web_search"}].
Vercel AI SDK JavaScript valodā:
import { xai } from '@ai-sdk/xai';
import { generateText } from 'ai';
const { text, sources } = await generateText({
model: xai.responses('grok-4.5'),
prompt: "Jaunākās AI ziņas Eiropā",
tools: {
web_search: xai.tools.webSearch(),
},
});
console.log(text);
console.log('Citations:', sources);
Praktisks uzdevums
Izveido skriptu, kas uzdod Grok jautājumu par kādu aktuālu notikumu pēc tavas izvēles. Pārliecinies, ka atbilde satur jaunāko informāciju (datumus, notikumus, kas notikuši pēc modeļa zināšanu beigām). Tad uzdod to pašu jautājumu bez rīka web_search, lai redzētu atšķirību.
Galvenās atziņas
- Tīmekļa meklēšana tiek aktivizēta ar
{"type": "web_search"}masīvātools(openaiSDK, Responses API) vaiweb_search()funkcijāclient.chat.create(xai-sdk) - Tā darbojas tikai ar Responses API (nevis Chat Completions)
- Modelis autonomi izlemj, kad tam nepieciešams veikt meklēšanu
- Atsauces tiek automātiski iekļautas atbildē
- Izmaksas ir 5 USD par 1000 rīka izsaukumiem, plus patērētie tokeni