Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Filtrovanie domén

Lekcia 5 z 16 Aktualizované 30. júla 2026 Vývojár
Na tejto strane
  1. Kontrola zdrojov vyhľadávania
  2. Dva vzájomne sa vylučujúce parametre
  3. Použitie allowed_domains (povolený zoznam)
  4. Použitie excluded_domains (blokovaný zoznam)
  5. Syntax SDK
  6. Obmedzenia a osvedčené postupy
  7. Kľúčové poznatky

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) a excluded_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