Aktivēt tīmekļa meklēšanu 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 ar funkcijuweb_search(), kas importēta noxai_sdk.tools, sarunā, ko izveidoclient.chat.create; vecais piemērs, kas izsaucaclient.tools.web_search()unclient.responses.create, šajā SDK neeksistē. Avots: Web Search.
Piešķir Grok piekļuvi tīmeklim reāllaikā
Tīmekļa meklēšana ir visbiežāk izmantotais integrētais rīks Grok API. Tas ļauj modelim meklēt aktuālu informāciju tīmeklī, pārvarot tā apmācības datu dabisko ierobežojumu. Aktivizēšana ir vienkārša, taču ir vairāki būtiski aspekti, kas jāapgūst, lai to izmantotu efektīvi.
Priekšnosacījumi: Responses API
Tīmekļa meklēšana ir pieejama tikai Responses API. Vecais Chat Completions API piedāvāja „Live Search” sistēmu, kas tagad ir novecojusi. Ja joprojām izmanto Chat Completions tīmekļa meklēšanai, tev ir jāpāriet uz Responses API.
Responses API izmanto client.responses.create() client.chat.completions.create() vietā. Pieprasījuma un atbildes struktūra atšķiras, taču gan xAI SDK, gan OpenAI SDK tos atbalsta.
Pamata aktivizēšana
Tu aktivizē tīmekļa meklēšanu, pievienojot objektu {"type": "web_search"} masīvam tools savā pieprasījumā:
{
"model": "grok-4.20-0309-reasoning",
"input": "Kādi ir jaunākie sasniegumi mākslīgajā intelektā?",
"tools": [
{"type": "web_search"}
]
}
Tas ir viss, kas nepieciešams pamata tīmekļa meklēšanai. Modelis automātiski nosaka, vai veikt meklēšanu, un no lietotāja ziņojuma formulē optimālo meklēšanas vaicājumu.
Aktivizēšana, izmantojot xAI SDK (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("Kādi ir jaunākie sasniegumi AI jomā?"))
response = chat.sample()
print(response.content)
print(response.citations)
SDK nodrošina funkciju web_search(), kas ģenerē rīka konfigurācijas objektu. Tā arī pieņem allowed_domains vai excluded_domains — līdz pat pieciem domēniem, un nekad abus vienlaicīgi vienā pieprasījumā.
Aktivizēšana, izmantojot OpenAI SDK
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="Kādi ir jaunākie sasniegumi AI jomā?",
tools=[{"type": "web_search"}]
)
OpenAI SDK strādā ar Grok API, vienkārši mainot base_url. Rīka sintakse paliek identiska.
Aktivizēšana, izmantojot Vercel AI SDK
import { xai } from "@ai-sdk/xai";
const response = await generateText({
model: xai("grok-4.20-0309-reasoning"),
prompt: "Kādi ir jaunākie sasniegumi AI jomā?",
tools: [xai.tools.webSearch()]
});
Vercel AI SDK izmanto xai.tools.webSearch(), ievērojot JavaScript camelCase konvenciju.
Tīmekļa meklēšanas kombinēšana ar citiem rīkiem
Tu vari vienlaicīgi aktivizēt vairākus rīkus. Modelis izvēlēsies vispiemērotāko vai izmantos tos secīgi:
{
"tools": [
{"type": "web_search"},
{"type": "code_interpreter"}
]
}
Šajā piemērā modelis var meklēt datus tīmeklī un pēc tam analizēt tos, izmantojot koda izpildi.
Galvenās atziņas
- Tīmekļa meklēšana ir pieejama tikai Responses API — Chat Completions šai funkcijai ir novecojis
- Aktivizē to ar
{"type": "web_search"}masīvātools - Modelis automātiski izlemj, kad un kā veikt meklēšanu
- Visi SDK (xAI, OpenAI, Vercel AI) atbalsta tīmekļa meklēšanu
- Vienā pieprasījumā vari vienlaicīgi aktivizēt vairākus rīkus