Įgalinti žiniatinklio paiešką Grok API
Šiame puslapyje
Atnaujinta 2026 m. lapkričio 2 d. Remiantis xAI dokumentacija: naudojant
xai-sdk, žiniatinklio paieška aktyvuojama perweb_search()funkciją, importuojamą išxai_sdk.tools, pokalbio, sukurtoclient.chat.create, kontekste; senajame pavyzdyje buvo kviečiamaclient.tools.web_search(), ko šiame SDK nėra. Šaltinis: Web Search.
Atnaujinta 2026 m. lapkričio 3 d. Pirmajame pavyzdyje
xai-sdkklientui buvo kviečiamaclient.responses.create(), tačiau šis objektas neturiresponsesatributo: naudojant šį SDK, paieška vykdoma perclient.chat.create(..., tools=[web_search()]), oclient.responses.create()priklausoopenaiSDK, nukreiptam įhttps://api.x.ai/v1. Vercel AI SDK pavyzdyje įrankiai buvo perduodami kaip masyvas ir nebuvo importuojamagenerateText: jie deklaruojami objekte, kaip nurodyta xAI dokumentacijoje. Kodas patikrintas suxai-sdk1.21.0 iropenai3.42.1 versijomis. Šaltinis: Web Search.
Kodėl verta sujungti Grok su realiuoju laiku veikiančiu internetu
Klasikiniai kalbos modeliai dirba su žiniomis, kurios buvo „užšaldytos“ jų mokymo datos momentu. Kūrėjui, kuriančiam programėles, kurioms reikia naujausių duomenų (akcijų kainų, naujienų, sporto rezultatų, oro prognozių), šis apribojimas yra nepriimtinas. Grok API įrankis web_search išsprendžia šią problemą leisdamas modeliui realiuoju laiku ieškoti informacijos internete tiesiai iš tavo API užklausos.

Skirtingai nei kiti tiekėjai, reikalaujantys trečiųjų šalių integracijų arba atskirų papildinių, xAI siūlo žiniatinklio paiešką kaip serverio pusėje integruotą įrankį. Tau nereikia valdyti jokios infrastruktūros: modelis pats nusprendžia, kada ieškoti, įvykdo užklausą ir integruoja rezultatus į savo atsakymą.
„Responses“ API: vienintelis palaikomas galinis taškas
Žiniatinklio paieška veikia tik per Responses API. Senasis „Chat Completions“ galinis taškas turėjo search_parameters parametrą, tačiau dabar jis yra pasenęs. Jei migruoji nuo senosios API, turėsi pritaikyti savo kvietimus.
Aktyvavimas vyksta pridėjus web_search įrankį į tools masyvą savo užklausoje:
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="Koks šiandien oras Paryžiuje?",
tools=[{"type": "web_search"}],
)
print(response.output_text)
Šiame pavyzdyje naudojamas openai SDK, suderinamas su xAI Responses API; toliau pateiktas vietinis xAI SDK veikia per pokalbį.
Tai viskas. Modelis išanalizuoja tavo užuominą, nustato, ar jam reikia naujausios informacijos, ir automatiškai inicijuoja paiešką. Tau nereikia valdyti kvietimų ciklo ar sąlyginės logikos.
Penkių žingsnių vykdymo eiga
Kai siunči užklausą su įjungta web_search, procesas vyksta pagal specifinę seką:
- Analizė: modelis įvertina, ar klausimui reikia naujausių duomenų
- Sprendimas: jis pasirenka – ieškoti ar atsakyti remdamasis vidinėmis žiniomis
- Vykdymas: žiniatinklio paieška vykdoma serverio pusėje (tu nieko nevaldai)
- Apdorojimas: rezultatai analizuojami ir sintezuojami
- Atsakymas: galutinis tekstas sugeneruojamas kartu su susijusiomis citatomis
Šis mechanizmas reiškia, kad modelis gali nuspręsti neieškoti, jei klausimas to nepateisina. Pavyzdžiui, klausimas apie fotosintezės apibrėžimą greičiausiai nesukels žiniatinklio paieškos.
Naudojimas su skirtingais SDK
xAI SDK suteikia specialią funkciją web_search(), kurią perduodi į pokalbio įrankių sąrašą:
# Vietinis 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("Naujausios DI naujienos Europoje"))
response = chat.sample()
print(response.content)
print(response.citations)
Naudojant openai SDK, tai yra pamokos pradžioje matytas kvietimas: client.responses.create() su base_url="https://api.x.ai/v1" ir tools=[{"type": "web_search"}].
JavaScript kalbai skirtam Vercel AI SDK:
import { xai } from '@ai-sdk/xai';
import { generateText } from 'ai';
const { text, sources } = await generateText({
model: xai.responses('grok-4.5'),
prompt: "Naujausios DI naujienos Europoje",
tools: {
web_search: xai.tools.webSearch(),
},
});
console.log(text);
console.log('Citatos:', sources);
Praktinė užduotis
Sukurk scenarijų, kuriuo užklausi Grok apie tau pasirinktą aktualų įvykį. Patikrink, ar atsakyme yra naujausios informacijos (datos, įvykiai, nutikę po modelio žinių ribos datos). Tada užduok tą patį klausimą be web_search įrankio, kad pamatytum skirtumą.
Svarbiausi punktai
- Žiniatinklio paieška aktyvuojama naudojant
{"type": "web_search"}masyvetools(openaiSDK, Responses API) arbaweb_search()funkcijojeclient.chat.create(xai-sdk) - Ji veikia tik per Responses API (ne per Chat Completions)
- Modelis savarankiškai nusprendžia, kada reikia ieškoti
- Citatos automatiškai įtraukiamos į atsakymą
- Kaina yra 5 USD už 1 000 įrankio kvietimų, plius sunaudoti tokenai