A webes keresés engedélyezése az API-ban
Ezen az oldalon
Frissítve: 2026. november 2. Az xAI dokumentációja alapján: az
xai-sdkhasználatával a webes keresés aclient.chat.createáltal létrehozott beszélgetésben axai_sdk.toolsmodulból importáltweb_search()függvénnyel engedélyezhető; a régi példa aclient.tools.web_search()és aclient.responses.createhívásokat tartalmazta, amelyek ebben az SDK-ban nem léteznek. Forrás: Web Search.
Valós idejű webes hozzáférés biztosítása Grok számára
A Webes keresés a Grok API leggyakrabban használt integrált eszköze. Lehetővé teszi a modell számára, hogy naprakész információkat keressen a weben, áthidalva ezzel a tanítási adatainak természetes korlátait. Az aktiválás egyszerű, de van néhány kulcsfontosságú szempont, amelyet elsajátítasz a hatékony használathoz.
Előfeltételek: A Responses API
A Webes keresés kizárólag a Responses API-n érhető el. A régi Chat Completions API egy „Live Search“ rendszert kínált, amely mára elavult. Ha még mindig a Chat Completionst használod webes keresésre, át kell térned a Responses API-ra.
A Responses API a client.chat.completions.create() helyett a client.responses.create() metódust használja. A kérés és a válasz szerkezete eltér, de mind az xAI SDK, mind az OpenAI SDK támogatja őket.
Alapvető aktiválás
A Webes keresést úgy engedélyezed, hogy hozzáadsz egy {"type": "web_search"} objektumot a kérésed tools tömbjéhez:
{
"model": "grok-4.20-0309-reasoning",
"input": "What are the latest advancements in artificial intelligence?",
"tools": [
{"type": "web_search"}
]
}
Ennyi szükséges az alapvető webes kereséshez. A modell automatikusan eldönti, hogy végezzen-e keresést, és a felhasználói üzenet alapján megfogalmazza az optimális keresési lekérdezést.
Aktiválás az xAI SDK-val (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)
Az SDK biztosítja a web_search() függvényt, amely generálja az eszköz konfigurációs objektumát. Elfogadja az allowed_domains vagy az excluded_domains paramétereket is – legfeljebb öt domainet, és soha nem mindkettőt ugyanabban a kérésben.
Aktiválás az OpenAI SDK-val
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"}]
)
Az OpenAI SDK a Grok API-val úgy működik, hogy egyszerűen megváltoztatod a base_url értéket. Az eszköz szintaxisa változatlan marad.
Aktiválás a Vercel AI SDK-val
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()]
});
A Vercel AI SDK az xai.tools.webSearch() függvényt használja, követve a JavaScript camelCase konvencióját.
A webes keresés kombinálása egyéb eszközökkel
Több eszközt is engedélyezhetsz egyszerre. A modell kiválasztja a legmegfelelőbbet, vagy sorrendben használja őket:
{
"tools": [
{"type": "web_search"},
{"type": "code_interpreter"}
]
}
Ebben a példában a modell képes adatokat keresni a weben, majd elemezni azokat a Kódfuttatás segítségével.
Főbb megállapítások
- A Webes keresés kizárólag a Responses API-n érhető el – a Chat Completions elavult ehhez a funkcióhoz
- Engedélyezd a
{"type": "web_search"}hozzáadásával atoolstömbhöz - A modell automatikusan eldönti, mikor és hogyan keressen
- Minden SDK (xAI, OpenAI, Vercel AI) támogatja a Webes keresést
- Ugyanabban a kérésben több eszközt is engedélyezhetsz egyszerre