Активиране на търсене в уеб чрез API
На тази страница
Обновено на 2 ноември 2026 г. Въз основа на документацията на xAI: при използване на
xai-sdk, търсенето в уеб се активира чрез функциятаweb_search(), импортирана отxai_sdk.tools, в разговор, създаден чрезclient.chat.create; старият пример, извикващclient.tools.web_search()иclient.responses.create, не съществува в този SDK. Източник: Web Search.
Осигурете на Grok достъп до уеб в реално време
Търсенето в уеб е най-използваният интегриран инструмент в Grok API. То позволява на модела да търси актуална информация в мрежата, преодолявайки естественото ограничение на данните, с които е обучен. Активирането е просто, но има ключови моменти, които трябва да усвоите, за да го използвате ефективно.
Предпоставки: Responses API
Търсенето в уеб е достъпно изключително чрез Responses API. Старото Chat Completions API предлагаше система за „Live Search“, която вече е остаряла. Ако все още използвате Chat Completions за търсене в уеб, трябва да мигрирате към Responses API.
Responses API използва client.responses.create() вместо client.chat.completions.create(). Структурата на заявката и отговора се различава, но както xAI SDK, така и OpenAI SDK ги поддържат.
Основно активиране
Активирате търсенето в уеб, като добавите обект {"type": "web_search"} към масива tools във вашата заявка:
{
"model": "grok-4.20-0309-reasoning",
"input": "What are the latest advancements in artificial intelligence?",
"tools": [
{"type": "web_search"}
]
}
Това е всичко, от което се нуждаете за основно търсене в уеб. Моделът автоматично определя дали да извърши търсене и формулира оптималната заявка за търсене въз основа на съобщението на потребителя.
Активиране с 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("What are the latest advancements in AI?"))
response = chat.sample()
print(response.content)
print(response.citations)
SDK предоставя функцията web_search(), която генерира обекта с конфигурация на инструмента. Тя също така приема allowed_domains или excluded_domains – до пет домейна, и никога и двете в една и съща заявка.
Активиране с 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="What are the latest advancements in AI?",
tools=[{"type": "web_search"}]
)
OpenAI SDK работи с Grok API просто чрез промяна на base_url. Синтаксисът на инструмента остава идентичен.
Активиране с Vercel AI SDK
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()]
});
Vercel AI SDK използва xai.tools.webSearch() със стандартната конвенция camelCase за JavaScript.
Комбиниране на търсене в уеб с други инструменти
Можете да активирате няколко инструмента едновременно. Моделът ще избере най-подходящия или ще ги използва последователно:
{
"tools": [
{"type": "web_search"},
{"type": "code_interpreter"}
]
}
В този пример моделът може да търси данни в уеб и след това да ги анализира чрез изпълнение на код.
Ключови изводи
- Търсенето в уеб е достъпно изключително чрез Responses API – Chat Completions е остаряло за тази функция
- Активирайте го с
{"type": "web_search"}в масиваtools - Моделът автоматично решава кога и как да търси
- Всички SDK (xAI, OpenAI, Vercel AI) поддържат търсене в уеб
- Можете да активирате няколко инструмента едновременно в една и съща заявка