Активиране на уеб търсене в Grok API
На тази страница
Обновено на 2 ноември 2026 г. Въз основа на документацията на xAI: при използване на
xai-sdk, уеб търсенето се активира чрез функциятаweb_search(), импортирана отxai_sdk.tools, в рамките на разговор, създаден чрезclient.chat.create; старият пример извиквашеclient.tools.web_search(), което не съществува в този SDK. Източник: Web Search.
Обновено на 3 ноември 2026 г. Първият пример извикваше
client.responses.create()върху клиента наxai-sdk, който няма атрибутresponses: при този SDK търсенето преминава презclient.chat.create(..., tools=[web_search()]), аclient.responses.create()принадлежи наopenaiSDK, насочен къмhttps://api.x.ai/v1. Примерът за Vercel AI SDK предаваше инструментите като масив и не импортирашеgenerateText: те се декларират в обект, както е в документацията на xAI. Кодът е проверен сxai-sdk1.21.0 иopenai3.42.1. Източник: Web Search.
Защо да свържете Grok с уеб в реално време
Класическите езикови модели работят със знания, замразени към датата на тяхното обучение. За разработчик, който създава приложения, изискващи актуални данни (борсови котировки, новини, спортни резултати, метеорологични прогнози), това ограничение е непреодолимо. Инструментът web_search в Grok API решава този проблем, позволявайки на модела да прави заявки към уеб в реално време, директно от вашето API извикване.

За разлика от други доставчици, които изискват интеграции на трети страни или отделни плъгини, xAI предлага уеб търсене като вграден инструмент от страната на сървъра. Вие нямате инфраструктура за управление: моделът решава кога да търси, изпълнява заявката и интегрира резултатите в своя отговор.
Responses API: Единственият поддържан крайна точка
Уеб търсенето работи изключително чрез Responses API. Старият крайна точка Chat Completions предлагаше параметър search_parameters, но той вече е остарял. Ако мигрирате от старото API, ще трябва да адаптирате вашите извиквания.
Активирането става чрез добавяне на инструмента web_search към масива tools във вашата заявка:
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="Какво е времето в Париж днес?",
tools=[{"type": "web_search"}],
)
print(response.output_text)
Този пример използва openai SDK, съвместим с xAI Responses API; нативният xAI SDK, представен по-долу, работи чрез разговор.
Това е всичко. Моделът анализира вашата подкана, определя дали има нужда от нова информация и задейства търсенето автоматично. Вие не трябва да управлявате цикъл на извиквания или условна логика.
Петте стъпки на изпълнение
Когато изпратите заявка с активирано web_search, процесът следва специфична последователност:
- Анализ: моделът оценява дали въпросът изисква скорошни данни
- Решение: той избира дали да търси или да отговори със своите вътрешни знания
- Изпълнение: уеб търсенето се изпълнява от страната на сървъра (вие не управлявате нищо)
- Обработка: резултатите се анализират и синтезират
- Отговор: генерира се окончателен текст със свързаните цитати
Този механизъм означава, че моделът може да реши да не търси, ако въпросът не го оправдава. Например, питането за дефиницията на фотосинтезата вероятно няма да задейства уеб търсене.
Използване с различни SDK
xAI SDK предоставя специализирана функция, web_search(), която се предава в списъка с инструменти за разговора:
# Нативен 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("Най-новите новини за ИИ в Европа"))
response = chat.sample()
print(response.content)
print(response.citations)
С openai SDK, това е извикването от началото на урока: client.responses.create() с base_url="https://api.x.ai/v1" и tools=[{"type": "web_search"}].
За Vercel AI SDK в JavaScript:
import { xai } from '@ai-sdk/xai';
import { generateText } from 'ai';
const { text, sources } = await generateText({
model: xai.responses('grok-4.5'),
prompt: "Най-новите новини за ИИ в Европа",
tools: {
web_search: xai.tools.webSearch(),
},
});
console.log(text);
console.log('Citations:', sources);
Практическо упражнение
Създайте скрипт, който пита Grok за текущо събитие по ваш избор. Уверете се, че отговорът съдържа скорошна информация (дати, събития, случили се след датата на прекъсване на знанията на модела). След това опитайте същия въпрос без инструмента web_search, за да видите разликата.
Ключови изводи
- Уеб търсенето се активира с
{"type": "web_search"}вtools(openaiSDK, Responses API) илиweb_search()вclient.chat.create(xai-sdk) - Работи само на Responses API (не и на Chat Completions)
- Моделът автономно решава кога има нужда да търси
- Цитатите се включват автоматично в отговора
- Цената е $5 на 1000 извиквания на инструмента, плюс консумираните токени