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

Filtrování domén

Lekce 5 z 16 Aktualizováno 30. července 2026 Vývojář
Na této stránce
  1. Kontrola zdrojů vyhledávání
  2. Dva vzájemně se vylučující parametry
  3. Použití allowed_domains (povolený seznam)
  4. Použití excluded_domains (blokovaný seznam)
  5. Syntaxe SDK
  6. Limity a osvědčené postupy
  7. Klíčové poznatky

Kontrola zdrojů vyhledávání

Ve výchozím nastavení prohledává Web Search celý web. To funguje dobře pro obecné dotazy, ale pro profesionální použití, kde potřebujete spolehlivé a kontrolované zdroje, to často nestačí. Filtrování domén ti umožňuje určitá omezit nebo naopak vyloučit.

Dva vzájemně se vylučující parametry

Web Search nabízí dva filtrační parametry:

  • allowed_domains: omezí vyhledávání pouze na zadané domény (povolený seznam)
  • excluded_domains: vyloučí konkrétní domény z výsledků (blokovaný seznam)

Tyto dva parametry jsou vzájemně se vylučující. Nemůžeš je použít oba ve stejné žádosti. Pokud se o to pokusíš, API vrátí chybu.

Každý parametr přijímá pole obsahující maximálně 5 domén.

Použití allowed_domains (povolený seznam)

Tento parametr použij, když přesně víš, které zdroje chceš konzultovat. Například pro akademický výzkum:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What are the latest publications on transformers?",
    tools=[{
        "type": "web_search",
        "allowed_domains": ["arxiv.org", "nature.com", "science.org"]
    }]
)

Model prohledá pouze tyto tři domény. To zajistí, že výsledky pocházejí z ověřených vědeckých zdrojů.

Případy použití povoleného seznamu

  • Akademický výzkum: omezení na arxiv.org, scholar.google.com, nature.com
  • Technická dokumentace: omezení na oficiální technologické weby
  • Konkurenční zpravodajství: omezení na weby konkurence
  • Regulatorní soulad: omezení na vládní nebo regulační zdroje

Použití excluded_domains (blokovaný seznam)

Tento parametr použij, když chceš široké vyhledávání, ale potřebuješ vyloučit nespolehlivé nebo irelevantní zdroje:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What are the best JavaScript frameworks in 2026?",
    tools=[{
        "type": "web_search",
        "excluded_domains": ["reddit.com", "quora.com"]
    }]
)

Model prohledá celý web kromě vyloučených domén.

Případy použití blokovaného seznamu

  • Vyloučení fór: vyhni se neověřeným názorům
  • Vyloučení agregátorů: vyhni se duplicitnímu obsahu
  • Vyloučení konkurence: udrž jejich obsah mimo své výsledky
  • Vyloučení placených bran (paywalls): vyhni se webům s nepřístupným obsahem

Syntaxe SDK

xAI SDK

tools=[client.tools.web_search(
    allowed_domains=["arxiv.org", "nature.com"]
)]

OpenAI SDK

tools=[{
    "type": "web_search",
    "excluded_domains": ["reddit.com"]
}]

Vercel AI SDK

tools: [xai.tools.webSearch({
  allowedDomains: ["arxiv.org", "nature.com"]
})]

Všimni si konvence camelCase (allowedDomains) v JavaScript SDK.

Limity a osvědčené postupy

Limit 5 domén se může zdát omezující. V praxi tě však nutí být při výběru zdrojů selektivní, což zlepšuje kvalitu výsledků. Pokud potřebuješ větší flexibilitu, můžeš spustit více žádostí s různými doménami a výsledky agregovat na straně klienta.

Při použití allowed_domains se ujisti, že vybrané domény pokrývají požadované téma. Příliš restriktivní doména může modelu zabránit v nalezení relevantních informací, což by ho mohlo vést k odpovědi bez aktuálních dat.

Klíčové poznatky

  • K dispozici jsou dva parametry: allowed_domains (povolený seznam) a excluded_domains (blokovaný seznam)
  • Vzájemně se vylučující: nemůžeš je kombinovat ve stejné žádosti
  • Maximálně 5 domén na parametr
  • Povolený seznam je ideální pro kontrolované a spolehlivé zdroje
  • Blokovaný seznam funguje pro široká vyhledávání s několika výjimkami