Filtrovanie domén
Na tejto strane
Kontrola zdrojov vyhľadávania
Predvolene prehľadávač Web Search preskúmava celý web. To funguje dobre pri všeobecných dotazoch, no pri profesionálnych prípadoch použitia, kde potrebuješ spoľahlivé a kontrolované zdroje, to často nestačí. Filtrovanie domén ti umožňuje obmedziť alebo vylúčiť konkrétne stránky.
Dva vzájomne sa vylučujúce parametre
Web Search ponúka dva filtre:
allowed_domains: obmedzí vyhľadávanie na zadané domény (povolený zoznam)excluded_domains: vylúči konkrétne domény z výsledkov (blokovaný zoznam)
Tieto dva parametre sú vzájomne sa vylučujúce. Nemôžeš ich použiť obe v jednej požiadavke. Ak sa o to pokúsiš, API vráti chybu.
Každý parameter prijíma pole maximálne 5 domén.
Použitie allowed_domains (povolený zoznam)
Tento parameter použij, keď presne vieš, ktoré zdroje chceš konzultovať. Napríklad pri akademickom výskume:
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 vyhľadáva iba v týchto troch doménach. To zabezpečuje, že výsledky pochádzajú z overených vedeckých zdrojov.
Prípady použitia povoleného zoznamu
- Akademický výskum: obmedzenie na arxiv.org, scholar.google.com, nature.com
- Technická dokumentácia: obmedzenie na oficiálne technologické stránky
- Konkurenčná inteligencia: obmedzenie na stránky konkurentov
- Regulačný súlad: obmedzenie na vládne alebo regulačné zdroje
Použitie excluded_domains (blokovaný zoznam)
Tento parameter použij, keď chceš široké vyhľadávanie, ale potrebuješ vylúčiť nespoľahlivé alebo 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 vyhľadáva na celom webe okrem vylúčených domén.
Prípady použitia blokovaného zoznamu
- Vylúčenie fór: vyhni sa neovereným názorom
- Vylúčenie agregátorov: vyhni sa duplicitnému obsahu
- Vylúčenie konkurentov: udrž ich obsah mimo tvoje výsledky
- Vylúčenie platených brán (paywalls): vyhni sa stránkam s neprístupným obsahom
Syntax 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 konvenciu camelCase (allowedDomains) v JavaScript SDK.
Obmedzenia a osvedčené postupy
Obmedzenie na 5 domén sa môže zdať prísne. V praxi ťa to núti byť pri výbere zdrojov selektívny, čo zlepšuje kvalitu výsledkov. Ak potrebuješ väčšiu flexibilitu, môžeš spustiť viacero požiadaviek s rôznymi doménami a výsledky agregovať na strane klienta.
Pri používaní allowed_domains sa uisti, že vybrané domény pokrývajú požadovanú tému. Príliš obmedzujúca doména môže modelu zabrániť nájsť relevantné informácie, čo by ho mohlo viesť k odpovedi bez aktuálnych dát.
Kľúčové poznatky
- K dispozícii sú dva parametre:
allowed_domains(povolený zoznam) aexcluded_domains(blokovaný zoznam) - Vzájomne sa vylučujúce: nemôžeš ich kombinovať v jednej požiadavke
- Maximálne 5 domén na parameter
- Povolený zoznam je ideálny pre kontrolované a spoľahlivé zdroje
- Blokovaný zoznam funguje pri širokom vyhľadávaní s niekoľkými výnimkami