Povolení vyhledávání na webu v API Grok
Na této stránce
Aktualizováno 2. listopadu 2026. Na základě dokumentace xAI: u
xai-sdkse vyhledávání na webu aktivuje funkcíweb_search()importovanou zxai_sdk.toolsv rámci konverzace vytvořené pomocíclient.chat.create; starý příklad volalclient.tools.web_search(), což v tomto SDK neexistuje. Zdroj: Web Search.
Aktualizováno 3. listopadu 2026. První příklad volal
client.responses.create()na klientovixai-sdk, který nemá atributresponses: u tohoto SDK probíhá vyhledávání přesclient.chat.create(..., tools=[web_search()])aclient.responses.create()patří do SDKopenaisměřujícího nahttps://api.x.ai/v1. Příklad pro Vercel AI SDK předával nástroje jako pole a neimportovalgenerateText: deklarují se v objektu, jak uvádí dokumentace xAI. Kód ověřen sxai-sdk1.21.0 aopenai3.42.1. Zdroj: Web Search.
Proč připojit Grok k webu v reálném čase
Klasické jazykové modely pracují se znalostmi zmraženými k datu jejich tréninku. Pro vývojáře budující aplikace, které vyžadují aktuální data (ceny akcií, zprávy, sportovní výsledky, počasí), je toto omezení nepřekonatelné. Nástroj web_search v API Grok tento problém řeší tím, že umožňuje modelu dotazovat se na web v reálném čase přímo z vašeho volání API.

Na rozdíl od jiných poskytovatelů, kteří vyžadují integrace třetích stran nebo samostatné pluginy, nabízí xAI vyhledávání na webu jako vestavěný nástroj na straně serveru. Nemusíte spravovat žádnou infrastrukturu: model sám rozhodne, kdy vyhledávat, provede dotaz a integruje výsledky do své odpovědi.
Responses API: Jediný podporovaný koncový bod
Vyhledávání na webu funguje výhradně na Responses API. Starý koncový bod Chat Completions nabízel parametr search_parameters, který je nyní zastaralý. Pokud migrujete ze starého API, budete muset své požadavky upravit.
Aktivace probíhá přidáním nástroje web_search do pole tools ve vašem požadavku:
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="What is the weather like in Paris today?",
tools=[{"type": "web_search"}],
)
print(response.output_text)
Tento příklad používá SDK openai, které je kompatibilní s xAI Responses API; nativní xAI SDK, představené níže, pracuje přes konverzaci.
To je vše. Model analyzuje váš prompt, zjistí, zda potřebuje čerstvé informace, a automaticky spustí vyhledávání. Nemusíte spravovat žádnou smyčku volání ani podmíněnou logiku.
Pětikrokový průběh provádění
Když odešlete požadavek s povoleným web_search, proces následuje specifickou sekvenci:
- Analýza: model vyhodnotí, zda otázka vyžaduje nedávná data
- Rozhodnutí: zvolí, zda vyhledat, nebo odpovědět pomocí svých interních znalostí
- Provedení: vyhledávání na webu běží na straně serveru (nic nespravujete)
- Zpracování: výsledky jsou analyzovány a syntetizovány
- Odpověď: finální text je vygenerován s přidruženými citacemi
Tento mechanismus znamená, že se model může rozhodnout nevyhledávat, pokud to otázka neoprávňuje. Například dotaz na definici fotosyntézy pravděpodobně nespustí vyhledávání na webu.
Použití s různými SDK
xAI SDK poskytuje vyhrazenou funkci web_search(), kterou předáte do seznamu nástrojů konverzace:
# Natívní 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("Latest AI news in Europe"))
response = chat.sample()
print(response.content)
print(response.citations)
U SDK openai jde o volání z úvodu lekce: client.responses.create() s base_url="https://api.x.ai/v1" a tools=[{"type": "web_search"}].
Pro Vercel AI SDK v JavaScriptu:
import { xai } from '@ai-sdk/xai';
import { generateText } from 'ai';
const { text, sources } = await generateText({
model: xai.responses('grok-4.5'),
prompt: "Latest AI news in Europe",
tools: {
web_search: xai.tools.webSearch(),
},
});
console.log(text);
console.log('Citations:', sources);
Praktické cvičení
Vytvoř skript, který se zeptá Groka na aktuální událost dle tvého výběru. Ověř, že odpověď obsahuje nedávné informace (data, události odehrávající se po datu ukončení tréninku modelu). Poté zkus stejnou otázku bez nástroje web_search, abys viděl rozdíl.
Klíčové poznatky
- Vyhledávání na webu se aktivuje pomocí
{"type": "web_search"}vtools(SDKopenai, Responses API) neboweb_search()vclient.chat.create(xai-sdk) - Funguje pouze na Responses API (ne na Chat Completions)
- Model samostatně rozhoduje, kdy potřebuje vyhledávat
- Citace jsou automaticky zahrnuty v odpovědi
- Cena činí 5 $ za 1 000 volání nástroje plus spotřebované tokeny