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

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

Урок 4 от 16 Обновен 2 ноември 2026 г. Програмист
На тази страница
  1. Осигурете на Grok достъп до уеб в реално време
  2. Предпоставки: Responses API
  3. Основно активиране
  4. Активиране с xAI SDK (Python)
  5. Активиране с OpenAI SDK
  6. Активиране с Vercel AI SDK
  7. Комбиниране на търсене в уеб с други инструменти
  8. Ключови изводи

Обновено на 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. То позволява на модела да търси актуална информация в мрежата, преодолявайки естественото ограничение на данните, с които е обучен. Активирането е просто, но има ключови моменти, които трябва да усвоите, за да го използвате ефективно.

Отговори
Необходимо API
5
Филтрируеми домейни
Автоматично
Включени цитати
$5
/ 1 000 заявки

Предпоставки: 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) поддържат търсене в уеб
  • Можете да активирате няколко инструмента едновременно в една и съща заявка