Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Povolení vyhledávání na webu v API Grok

Lekce 1 z 14 Aktualizováno 3. listopadu 2026 Začátečník
Na této stránce
  1. Proč připojit Grok k webu v reálném čase
  2. Responses API: Jediný podporovaný koncový bod
  3. Pětikrokový průběh provádění
  4. Použití s různými SDK
  5. Praktické cvičení
  6. Klíčové poznatky

Aktualizováno 2. listopadu 2026. Na základě dokumentace xAI: u xai-sdk se vyhledávání na webu aktivuje funkcí web_search() importovanou z xai_sdk.tools v rámci konverzace vytvořené pomocí client.chat.create; starý příklad volal client.tools.web_search(), což v tomto SDK neexistuje. Zdroj: Web Search.

Aktualizováno 3. listopadu 2026. První příklad volal client.responses.create() na klientovi xai-sdk, který nemá atribut responses: u tohoto SDK probíhá vyhledávání přes client.chat.create(..., tools=[web_search()]) a client.responses.create() patří do SDK openai směřujícího na https://api.x.ai/v1. Příklad pro Vercel AI SDK předával nástroje jako pole a neimportoval generateText: deklarují se v objektu, jak uvádí dokumentace xAI. Kód ověřen s xai-sdk 1.21.0 a openai 3.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.

Vyhledávání na webu s Grok

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.

$5
za 1 000 volání
5
domén s možností filtrování
0
infrastruktury ke správě
Automaticky
citace zahrnuty

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:

  1. Analýza: model vyhodnotí, zda otázka vyžaduje nedávná data
  2. Rozhodnutí: zvolí, zda vyhledat, nebo odpovědět pomocí svých interních znalostí
  3. Provedení: vyhledávání na webu běží na straně serveru (nic nespravujete)
  4. Zpracování: výsledky jsou analyzovány a syntetizovány
  5. 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"} v tools (SDK openai, Responses API) nebo web_search() v client.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