Премини към основното съдържание
Български— Изберете език
Меню

Активиране на уеб търсене в Grok API

Урок 1 от 14 Обновен 3 ноември 2026 г. Начинаещ
На тази страница
  1. Защо да свържете Grok с уеб в реално време
  2. Responses API: Единственият поддържан крайна точка
  3. Петте стъпки на изпълнение
  4. Използване с различни SDK
  5. Практическо упражнение
  6. Ключови изводи

Обновено на 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() принадлежи на openai SDK, насочен към https://api.x.ai/v1. Примерът за Vercel AI SDK предаваше инструментите като масив и не импортираше generateText: те се декларират в обект, както е в документацията на xAI. Кодът е проверен с xai-sdk 1.21.0 и openai 3.42.1. Източник: Web Search.

Защо да свържете Grok с уеб в реално време

Класическите езикови модели работят със знания, замразени към датата на тяхното обучение. За разработчик, който създава приложения, изискващи актуални данни (борсови котировки, новини, спортни резултати, метеорологични прогнози), това ограничение е непреодолимо. Инструментът web_search в Grok API решава този проблем, позволявайки на модела да прави заявки към уеб в реално време, директно от вашето API извикване.

Уеб търсене с Grok

За разлика от други доставчици, които изискват интеграции на трети страни или отделни плъгини, xAI предлага уеб търсене като вграден инструмент от страната на сървъра. Вие нямате инфраструктура за управление: моделът решава кога да търси, изпълнява заявката и интегрира резултатите в своя отговор.

$5
на 1000 извиквания
5
филтрируеми домейна
0
инфраструктура за управление
Автоматично
включени цитати

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, процесът следва специфична последователност:

  1. Анализ: моделът оценява дали въпросът изисква скорошни данни
  2. Решение: той избира дали да търси или да отговори със своите вътрешни знания
  3. Изпълнение: уеб търсенето се изпълнява от страната на сървъра (вие не управлявате нищо)
  4. Обработка: резултатите се анализират и синтезират
  5. Отговор: генерира се окончателен текст със свързаните цитати

Този механизъм означава, че моделът може да реши да не търси, ако въпросът не го оправдава. Например, питането за дефиницията на фотосинтезата вероятно няма да задейства уеб търсене.

Използване с различни 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 (openai SDK, Responses API) или web_search() в client.chat.create (xai-sdk)
  • Работи само на Responses API (не и на Chat Completions)
  • Моделът автономно решава кога има нужда да търси
  • Цитатите се включват автоматично в отговора
  • Цената е $5 на 1000 извиквания на инструмента, плюс консумираните токени