Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Domeenifiltreerimine

Õppetund 5 / 16 Värskendatud 30. juuli 2026 Arendajatele
Sellel lehel
  1. Otsinguallikate juhtimine
  2. Kaks üksteist välistavat parameetrit
  3. Kasuta allowed_domains (lubatud loend)
  4. Kasuta excluded_domains (keelatud loend)
  5. SDK süntaks
  6. Piirangud ja parimad tavad
  7. Peamised punktid

Otsinguallikate juhtimine

Vaikimisi sirbib veebiotsing kogu internetti. See sobib hästi üldpäringute jaoks, kuid kutsealases kontekstis, kus vajad usaldusväärseid ja kontrollitud allikaid, jääb sellest sageli väheks. Domeenifiltreerimine võimaldab sul piirata otsingut kindlate saitidega või jätta teatud saidid tulemustest välja.

Kaks üksteist välistavat parameetrit

Veebiotsing pakub kahte filtreerimisparameetrit:

  • allowed_domains: piirab otsingu määratud domeenidega (lubatud loend)
  • excluded_domains: jätab tulemustest välja konkreetsed domeenid (keelatud loend)

Need kaks parameetrit on üksteist välistavad. Sa ei saa neid samas päringus koos kasutada. Kui proovid, tagastab API veateate.

Mõlemad parameetrid aktsepteerivad kuni 5 domeeni sisaldavat massiivi.

Kasuta allowed_domains (lubatud loend)

Kasuta seda parameetrit, kui tead täpselt, milliseid allikaid soovid konsulteerida. Näiteks akadeemiliste uuringute puhul:

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"]
    }]
)

Mudel otsib ainult neilt kolmelt domeenilt. See tagab, et tulemused pärinevad kontrollitud teadusallikatest.

Lubatud loendi kasutusjuhtumid

  • Akadeemilised uuringud: piira saidiga arxiv.org, scholar.google.com, nature.com
  • Tehniline dokumentatsioon: piira ametlike tehnoloogiasaitidega
  • Konkurentsianalüüs: piira konkurentide saitidega
  • Regulatiivne vastavus: piira valitsuse või regulatiivsete asutuste allikatega

Kasuta excluded_domains (keelatud loend)

Kasuta seda parameetrit, kui soovid laiaulatuslikku otsingut, kuid pead välistama ebausaldusväärsed või ebaolulised allikad:

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"]
    }]
)

Mudel otsib kogu veebist, välja arvatud välistatud domeenid.

Keelatud loendi kasutusjuhtumid

  • Foorumite välistamine: väldi kinnitamata arvamusi
  • Agregaatorite välistamine: väldi dubleeritud sisu
  • Konkurentide välistamine: hoia nende sisu oma tulemustest eemal
  • Makseväravate välistamine: väldi saite, mille sisu pole ligipääsetav

SDK süntaks

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"]
})]

Pane tähele camelCase konventsiooni (allowedDomains) JavaScripti SDK-s.

Piirangud ja parimad tavad

Viie domeeni piirang võib tunduda kitsendavana. Praktikas sunnib see sind allikaid valikuliselt valima, mis parandab tulemuste kvaliteeti. Kui vajad suuremat paindlikkust, saad teha mitu päringut erinevate domeenidega ja koondada tulemused kliendipoolselt.

Kui kasutad allowed_domains, veendu, et valitud domeenid katavad käsitletavat teemat. Liiga kitsendav domeen võib takistada mudelil asjakohase info leidmist, mis võib viia selleni, et mudel vastab ilma ajakohaste andmeteta.

Peamised punktid

  • Saadaval on kaks parameetrit: allowed_domains (lubatud loend) ja excluded_domains (keelatud loend)
  • Üksteist välistavad: neid ei saa samas päringus kombineerida
  • Maksimaalselt 5 domeeni parameetri kohta
  • Lubatud loend sobib ideaalselt kontrollitud ja usaldusväärsete allikate jaoks
  • Keelatud loend toimib hästi laiaulatuslike otsingute puhul, kus tuleb välja jätta vaid mõned üksikud saidid