Aktivácia vyhľadávania na webe v API Grok
Na tejto strane
Aktualizované 2. novembra 2026. Na základe dokumentácie xAI: pri používaní
xai-sdksa vyhľadávanie na webe aktivuje pomocou funkcieweb_search()importovanej zxai_sdk.toolsv rámci konverzácie vytvorenej cezclient.chat.create; starý príklad volalclient.tools.web_search(), čo v tomto SDK neexistuje. Zdroj: Web Search.
Aktualizované 3. novembra 2026. Prvý príklad volal
client.responses.create()na klientovixai-sdk, ktorý nemá atribútresponses: pri tomto SDK prebieha vyhľadávanie cezclient.chat.create(..., tools=[web_search()])aclient.responses.create()patrí do SDKopenaismerujúceho nahttps://api.x.ai/v1. Príklad pre Vercel AI SDK odovzdával nástroje ako pole a neimportovalgenerateText: deklaruje ich v objekte, ako uvádza dokumentácia xAI. Kód overený s verziamixai-sdk1.21.0 aopenai3.42.1. Zdroj: Web Search.
Prečo pripojiť Grok k webu v reálnom čase
Klasické jazykové modely pracujú so znalosťami zmrazenými k dátumu ich trénovania. Pre vývojára, ktorý buduje aplikácie vyžadujúce aktuálne údaje (ceny akcií, správy, športové výsledky, počasie), je toto obmedzenie neprijateľné. Nástroj web_search v API Grok tento problém rieši tým, že umožňuje modelu vyhľadávať na webe v reálnom čase priamo z vášho volania API.

Na rozdiel od iných poskytovateľov, ktorí si vyžadujú integrácie tretích strán alebo samostatné pluginy, ponúka xAI vyhľadávanie na webe ako vstavaný nástroj na strane servera. Nemusíš spravovať žiadnu infraštruktúru: model sa sám rozhodne, kedy vyhľadávať, vykoná dopyt a integruje výsledky do svojej odpovede.
Responses API: Jediný podporovaný koncový bod
Vyhľadávanie na webe funguje výlučne na Responses API. Starý koncový bod Chat Completions ponúkal parameter search_parameters, ktorý je však teraz zastaraný. Ak migruješ zo starého API, budeš musieť upraviť svoje volania.
Aktivácia prebieha pridaním nástroja web_search do poľa tools vo vašej požiadavke:
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="Aké je dnes počasie v Paríži?",
tools=[{"type": "web_search"}],
)
print(response.output_text)
Tento príklad používa SDK openai, ktoré je kompatibilné s xAI Responses API; natívne xAI SDK, predstavené nižšie, pracuje prostredníctvom konverzácie.
To je všetko. Model analyzuje tvoj prompt, určí, či potrebuje čerstvé informácie, a automaticky spustí vyhľadávanie. Nemusíš spravovať žiadnu slučku volaní ani podmienenú logiku.
Päťkrokový priebeh vykonania
Keď odošleš požiadavku s povoleným web_search, proces nasleduje špecifickú postupnosť:
- Analýza: model vyhodnotí, či otázka vyžaduje nedávne údaje
- Rozhodnutie: zvolí si vyhľadávanie alebo odpoveď založenú na interných znalostiach
- Exekúcia: vyhľadávanie na webe prebieha na strane servera (nič neriešiš)
- Spracovanie: výsledky sú analyzované a syntetizované
- Odpoveď: finálny text je vygenerovaný spolu s prislúchajúcimi citáciami
Tento mechanizmus znamená, že sa model môže rozhodnúť nevyhľadávať, ak to otázka neoprávňuje. Napríklad otázka na definíciu fotosyntézy pravdepodobne nespustí vyhľadávanie na webe.
Použitie s rôznymi SDK
xAI SDK poskytuje vyhradenú funkciu web_search(), ktorú odovzdáš do zoznamu nástrojov konverzácie:
# Natívne 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("Najnovšie správy o AI v Európe"))
response = chat.sample()
print(response.content)
print(response.citations)
Pri SDK openai ide o volanie z úvodu lekcie: client.responses.create() s base_url="https://api.x.ai/v1" a tools=[{"type": "web_search"}].
Pre Vercel AI SDK v JavaScripte:
import { xai } from '@ai-sdk/xai';
import { generateText } from 'ai';
const { text, sources } = await generateText({
model: xai.responses('grok-4.5'),
prompt: "Najnovšie správy o AI v Európe",
tools: {
web_search: xai.tools.webSearch(),
},
});
console.log(text);
console.log('Citations:', sources);
Praktické cvičenie
Vytvor skript, ktorý sa opýta Groka na aktuálnu udalosť podľa tvojho výberu. Over, či odpoveď obsahuje nedávne informácie (dátumy, udalosti, ku ktorým došlo po dátume ukončenia trénovania modelu). Potom skús tú istú otázku bez nástroja web_search, aby si videl rozdiel.
Kľúčové poznatky
- Vyhľadávanie na webe sa aktivuje pomocou
{"type": "web_search"}vtools(SDKopenai, Responses API) aleboweb_search()vclient.chat.create(xai-sdk) - Funguje iba na Responses API (nie na Chat Completions)
- Model sa autonómne rozhoduje, kedy potrebuje vyhľadávať
- Citácie sú automaticky zahrnuté v odpovedi
- Cena je 5 USD za 1 000 volaní nástroja plus spotrebované tokeny