Domeenifiltreerimine
Sellel lehel
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) jaexcluded_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