Povolení vyhledávání na webu v API
Na této stránce
Aktualizováno 2. listopadu 2026. Na základě dokumentace xAI: u
xai-sdkje vyhledávání na webu povoleno prostřednictvím funkceweb_search()importované zxai_sdk.toolsv konverzaci vytvořené pomocíclient.chat.create; starý příklad volalclient.tools.web_search()aclient.responses.create, které v tomto SDK neexistují. Zdroj: Web Search.
Poskytni Groku přístup k webu v reálném čase
Vyhledávání na webu je nejčastěji používaným integrovaným nástrojem v Grok API. Umožňuje modelu hledat aktuální informace na internetu a překonává tak přirozené omezení jeho tréninkových dat. Aktivace je jednoduchá, ale pro efektivní využití musíš zvládnout několik klíčových bodů.
Předpoklady: Responses API
Vyhledávání na webu je dostupné výhradně v Responses API. Staré Chat Completions API nabízelo systém „Live Search“, který je nyní zastaralý. Pokud pro vyhledávání na webu stále používáš Chat Completions, musíš přejít na Responses API.
Responses API používá client.responses.create() místo client.chat.completions.create(). Struktura požadavku a odpovědi se liší, ale obě podporují jak xAI SDK, tak OpenAI SDK.
Základní aktivace
Vyhledávání na webu povolíš přidáním objektu {"type": "web_search"} do pole tools ve svém požadavku:
{
"model": "grok-4.20-0309-reasoning",
"input": "What are the latest advancements in artificial intelligence?",
"tools": [
{"type": "web_search"}
]
}
To je vše, co potřebuješ pro základní vyhledávání na webu. Model automaticky určí, zda má provést vyhledávání, a na základě uživatelské zprávy formulovat optimální vyhledávací dotaz.
Aktivace pomocí 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 funkci web_search(), která generuje konfigurační objekt nástroje. Přijímá také parametry allowed_domains nebo excluded_domains – až pět domén, nikdy však obě najednou v jednom požadavku.
Aktivace pomocí 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 pouhou změnou base_url. Syntaxe nástroje zůstává totožná.
Aktivace pomocí 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žívá xai.tools.webSearch() s konvencí camelCase pro JavaScript.
Kombinace vyhledávání na webu s dalšími nástroji
Můžeš povolit více nástrojů současně. Model si vybere ten nejvhodnější, nebo je použije sekvenčně:
{
"tools": [
{"type": "web_search"},
{"type": "code_interpreter"}
]
}
V tomto příkladu může model vyhledat data na webu a následně je analyzovat pomocí Code Execution.
Klíčové poznatky
- Vyhledávání na webu je dostupné výhradně v Responses API – Chat Completions je pro tuto funkci zastaralé
- Povolíš jej přidáním
{"type": "web_search"}do poletools - Model automaticky rozhoduje, kdy a jak vyhledávat
- Všechna SDK (xAI, OpenAI, Vercel AI) podporují vyhledávání na webu
- Ve stejném požadavku můžeš povolit více nástrojů současně