Povolenie vyhľadávania na webe v API
Na tejto strane
Aktualizované 2. novembra 2026. Na základe dokumentácie xAI: pri používaní
xai-sdksa vyhľadávanie na webe povoľuje pomocou funkcieweb_search()importovanej zxai_sdk.toolsv konverzácii vytvorenej cezclient.chat.create; starý príklad volalclient.tools.web_search()aclient.responses.create, ktoré v tomto SDK neexistujú. Zdroj: Web Search.
Poskytni Groku prístup k webu v reálnom čase
Vyhľadávanie na webe je najpoužívanejším integrovaným nástrojom v Grok API. Umožňuje modelu vyhľadávať aktuálne informácie na webe a preklenúť tak prirodzený limit jeho trénovacích dát. Aktivácia je jednoduchá, no existuje niekoľko kľúčových bodov, ktoré musíš ovládať, aby si ho využíval efektívne.
Predpoklady: Responses API
Vyhľadávanie na webe je dostupné výlučne prostredníctvom Responses API. Staršie Chat Completions API ponúkalo systém „Live Search“, ktorý je teraz zastaraný. Ak stále používaš Chat Completions na vyhľadávanie na webe, musíš migrovať na Responses API.
Responses API používa client.responses.create() namiesto client.chat.completions.create(). Štruktúra požiadavky a odpovede sa líši, no obe podporujú SDK od xAI aj OpenAI.
Základná aktivácia
Vyhľadávanie na webe povolíš pridaním objektu {"type": "web_search"} do poľa tools vo svojej požiadavke:
{
"model": "grok-4.20-0309-reasoning",
"input": "What are the latest advancements in artificial intelligence?",
"tools": [
{"type": "web_search"}
]
}
To je všetko, čo potrebuješ pre základné vyhľadávanie na webe. Model automaticky určí, či má vyhľadávanie vykonať, a sformuluje optimálny vyhľadávací dotaz na základe správy používateľa.
Aktivácia pomocou 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 poskytuje funkciu web_search(), ktorá generuje konfiguračný objekt nástroja. Prijíma aj parametre allowed_domains alebo excluded_domains – maximálne päť domén a nikdy nie obe naraz v tej istej požiadavke.
Aktivácia pomocou 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 funguje s Grok API jednoduchou zmenou base_url. Syntax nástroja zostáva identická.
Aktivácia pomocou 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 používa xai.tools.webSearch() podľa konvencie camelCase v JavaScripte.
Kombinácia vyhľadávania na webe s inými nástrojmi
Môžeš povoliť viacero nástrojov súčasne. Model si vyberie ten najvhodnejší alebo ich použije postupne za sebou:
{
"tools": [
{"type": "web_search"},
{"type": "code_interpreter"}
]
}
V tomto príklade môže model vyhľadať údaje na webe a následne ich analyzovať pomocou Code Execution.
Kľúčové poznatky
- Vyhľadávanie na webe je dostupné výlučne prostredníctvom Responses API – Chat Completions je pre túto funkciu zastarané
- Povolíš ho pridaním
{"type": "web_search"}do poľatools - Model automaticky rozhoduje, kedy a ako vyhľadávať
- Všetky SDK (xAI, OpenAI, Vercel AI) podporujú vyhľadávanie na webe
- V tej istej požiadavke môžeš povoliť viacero nástrojov súčasne