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

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

Lekce 4 z 16 Aktualizováno 2. listopadu 2026 Vývojář
Na této stránce
  1. Poskytni Groku přístup k webu v reálném čase
  2. Předpoklady: Responses API
  3. Základní aktivace
  4. Aktivace pomocí xAI SDK (Python)
  5. Aktivace pomocí OpenAI SDK
  6. Aktivace pomocí Vercel AI SDK
  7. Kombinace vyhledávání na webu s dalšími nástroji
  8. Klíčové poznatky

Aktualizováno 2. listopadu 2026. Na základě dokumentace xAI: u xai-sdk je vyhledávání na webu povoleno prostřednictvím funkce web_search() importované z xai_sdk.tools v konverzaci vytvořené pomocí client.chat.create; starý příklad volal client.tools.web_search() a client.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ů.

Odpovědi
Požadované API
5
Filtrovatelné domény
Automaticky
Citace zahrnuty
$5
/ 1 000 volání

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 pole tools
  • 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ě