A webes keresés engedélyezése a Grok API-ban
Ezen az oldalon
Frissítve: 2026. november 2. Az xAI dokumentációja alapján: az
xai-sdkesetén a webes keresés aweb_search()függvénnyel aktiválódik, amelyet azxai_sdk.toolsmodulból importálsz, egy olyan beszélgetésen belül, amelyet aclient.chat.createhoz létre; a régi példa aclient.tools.web_search()hívást használta, ami ebben az SDK-ban nem létezik. Forrás: Web Search.
Frissítve: 2026. november 3. Az első példa a
client.responses.create()hívást tartalmazta azxai-sdkkliensen, amelynek nincsresponsesattribútuma: ennél az SDK-nál a keresés aclient.chat.create(..., tools=[web_search()])útvonalon történik, míg aclient.responses.create()azopenaiSDK-hoz tartozik, amely ahttps://api.x.ai/v1címet célozza meg. A Vercel AI SDK példa tömbként adta át az eszközöket, és nem importálta agenerateTextfüggvényt: objektumban deklarálják őket, ahogy az az xAI dokumentációjában is szerepel. A kód ellenőrizve:xai-sdk1.21.0 ésopenai3.42.1 verziókkal. Forrás: Web Search.
Miért érdemes összekapcsolni a Grokot a valós idejű webbel
A klasszikus nyelvi modellek tudása a betanítási dátumukra fagyott. Ha olyan alkalmazást fejlesztesz, amelynek friss adatokra van szüksége (részvényárak, hírek, sporteredmények, időjárás), ez a korlát kizáró ok. A Grok API web_search eszköze megoldja ezt a problémát: lehetővé teszi, hogy a modell valós időben lekérdezze a webet közvetlenül az API-hívásodból.

Míg más szolgáltatók harmadik féltől származó integrációkat vagy külön plugineket igényelnek, az xAI a webes keresést szerveroldali beépített eszközként kínálja. Neked semmilyen infrastruktúrát nem kell kezelned: a modell dönti el, mikor keressen, hajtja végre a lekérdezést, és építi be az eredményeket a válaszába.
A Responses API: az egyetlen támogatott végpont
A webes keresés kizárólag a Responses API-n működik. A régi Chat Completions végpont kínált egy search_parameters paramétert, de ezt mára elavulttá nyilvánították. Ha a régi API-ról migrálsz, módosítanod kell a hívásaidat.
Az aktiválás úgy történik, hogy hozzáadod a web_search eszközt a kérésed tools tömbjéhez:
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="What is the weather like in Paris today?",
tools=[{"type": "web_search"}],
)
print(response.output_text)
Ez a példa az openai SDK-t használja, amely kompatibilis az xAI Responses API-val; a natív xAI SDK, amelyet lentebb mutatunk be, beszélgetésen keresztül működik.
Ennyi az egész. A modell elemzi a promptodat, eldönti, szüksége van-e friss információra, és automatikusan elindítja a keresést. Neked nem kell kezelned hívási ciklust vagy feltételes logikát.
Az öt lépésből álló végrehajtási folyamat
Amikor web_search engedélyezésével küldesz kérést, a folyamat egy specifikus sorrendet követ:
- Elemzés: a modell felméri, hogy a kérdés igényel-e friss adatokat
- Döntés: kiválasztja, hogy keres vagy a belső tudására hagyatkozva válaszol
- Végrehajtás: a webes keresés szerveroldalon fut (neked semmit sem kell kezelned)
- Feldolgozás: az eredményeket elemzi és szintetizálja
- Válasz: a végső szöveg generálása a kapcsolódó hivatkozásokkal
Ez a mechanizmus azt jelenti, hogy a modell dönthet úgy is, hogy nem keres, ha a kérdés nem indokolja. Például a fotoszintézis definíciójának lekérdezése valószínűleg nem indít el webes keresést.
Használat különböző SDK-kkal
Az xAI SDK egy dedikált web_search() függvényt biztosít, amelyet átadhatsz a beszélgetés eszközeinek listájában:
# Natív 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("Latest AI news in Europe"))
response = chat.sample()
print(response.content)
print(response.citations)
Az openai SDK esetén ez a lecke elején látható hívás: client.responses.create() a base_url="https://api.x.ai/v1" és a tools=[{"type": "web_search"}] paraméterekkel.
A Vercel AI SDK használata JavaScriptben:
import { xai } from '@ai-sdk/xai';
import { generateText } from 'ai';
const { text, sources } = await generateText({
model: xai.responses('grok-4.5'),
prompt: "Latest AI news in Europe",
tools: {
web_search: xai.tools.webSearch(),
},
});
console.log(text);
console.log('Citations:', sources);
Gyakorlati feladat
Készíts egy szkriptet, amely lekérdezi a Grokot egy általad választott aktuális eseményről. Ellenőrizd, hogy a válasz friss információkat tartalmaz (dátumok, a modell tudáskorlátja után történt események). Ezután tedd fel ugyanazt a kérdést a web_search eszköz nélkül, hogy lásd a különbséget.
Főbb megállapítások
- A webes keresés a
toolstömbben a{"type": "web_search"}elemmel aktiválódik (openaiSDK, Responses API), vagy aweb_search()függvénnyel aclient.chat.createhívásban (xai-sdk) - Kizárólag a Responses API-n működik (nem a Chat Completions-en)
- A modell autonóm módon dönti el, mikor van szüksége keresésre
- A hivatkozások automatikusan szerepelnek a válaszban
- A költség 5 USD 1000 eszközhívásonként, plusz a felhasznált tokenek