Filtrování domén
Na této stránce
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) aexcluded_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