Verkkotunnussuodatus
Tällä sivulla
Hakulähteiden hallinta
Oletusarvoisesti Web Search etsii koko verkosta. Tämä toimii hyvin yleisissä hauissa, mutta ammattikäytössä se jää usein riittämättömäksi, kun tarvitset luotettavia ja valvottuja lähteitä. Verkkotunnussuodatuksen avulla voit rajoittaa hakua tiettyihin sivustoihin tai sulkea niitä pois.
Kaksi toisensa poissulkevaa parametria
Web Search tarjoaa kaksi suodatusparametria:
allowed_domains: rajoittaa haun määritettyihin verkkotunnuksiin (sallittujen lista)excluded_domains: sulkee tietyt verkkotunnukset tuloksista pois (estolista)
Nämä kaksi parametria ovat toisensa poissulkevia. Et voi käyttää molempia samassa pyynnössä. Jos yrität, API palauttaa virheen.
Kumpikin parametri hyväksyy taulukon, jossa on enintään 5 verkkotunnusta.
allowed_domains-parametrin käyttö (sallittujen lista)
Käytä tätä parametria, kun tiedät tarkasti, mistä lähteistä haluat hakea tietoa. Esimerkiksi akateemisessa tutkimuksessa:
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"]
}]
)
Malli etsii vain näiltä kolmelta verkkotunnukselta. Tämä varmistaa, että tulokset tulevat varmennetuista tieteellisistä lähteistä.
Sallittujen listan käyttökohteet
- Akateeminen tutkimus: rajoita sivustoihin arxiv.org, scholar.google.com, nature.com
- Tekninen dokumentaatio: rajoita virallisiin teknologiasivustoihin
- Kilpailija-analyysi: rajoita kilpailijoiden sivustoihin
- Sääntelyvaatimusten noudattaminen: rajoita hallituksen tai viranomaisten lähteisiin
excluded_domains-parametrin käyttö (estolista)
Käytä tätä parametria, kun haluat tehdä laajan haun, mutta sinun on suljettava pois epäluotettavia tai epäoleellisia lähteitä:
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"]
}]
)
Malli etsii koko verkosta lukuun ottamatta suljettuja verkkotunnuksia.
Estolistan käyttökohteet
- Foorumien sulkeminen pois: vältä varmentamattomia mielipiteitä
- Aggregaattorien sulkeminen pois: vältä kaksoiskappaleita
- Kilpailijoiden sulkeminen pois: pidä heidän sisältönsä poissa tuloksistasi
- Maksullisten sisältöjen sulkeminen pois: vältä sivustoja, joiden sisältöön ei ole pääsyä
SDK-syntaksi
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"]
})]
Huomaa camelCase-käytäntö (allowedDomains) JavaScript SDK:ssa.
Rajat ja parhaat käytännöt
Viiden verkkotunnuksen raja saattaa vaikuttaa rajoittavalta. Käytännössä se pakottaa sinut valitsemaan lähteet huolella, mikä parantaa tulosten laatua. Jos tarvitset enemmän joustavuutta, voit suorittaa useita pyyntöjä eri verkkotunnuksilla ja yhdistää tulokset asiakaspuolella.
Kun käytät allowed_domains-parametria, varmista, että valitut verkkotunnukset kattavat kysytyn aiheen. Liian rajoittava verkkotunnus voi estää mallia löytämästä asiaankuuluvaa tietoa, mikä voi johtaa siihen, että se vastaa ilman ajantasaisia tietoja.
Keskeiset asiat
- Kaksi parametria saatavilla:
allowed_domains(sallittujen lista) jaexcluded_domains(estolista) - Toisensa poissulkevat: et voi yhdistää niitä samaan pyyntöön
- Enintään 5 verkkotunnusta parametria kohden
- Sallittujen lista sopii ihanteellisesti valvottuihin ja luotettaviin lähteisiin
- Estolista toimii hyvin laajoissa hauissa, joista suljetaan pois muutama lähde