Domenų filtravimas
Šiame puslapyje
Paieškos šaltinių valdymas
Pagal numatytuosius nustatymus „Web Search“ naršo visą internetą. Tai puikiai tinka bendriesiems užklausoms, tačiau profesionaliems atvejams, kai reikia patikimų ir kontroliuojamų šaltinių, to dažnai nepakanka. Domenų filtravimas leidžia apriboti arba pašalinti konkrečias svetaines.
Du vienas kitą išskiriantys parametrai
„Web Search“ siūlo du filtravimo parametrus:
allowed_domains: apriboja paiešką nurodytais domenais (leidimų sąrašas)excluded_domains: pašalina konkrečius domenus iš rezultatų (blokavimo sąrašas)
Šie du parametrai yra viena kitą išskiriantys. Toje pačioje užklausoje jų naudoti kartu negalima. Jei bandysi, API grąžins klaidą.
Kiekvienas parametras priima masyvą iš ne daugiau kaip 5 domenų.
allowed_domains naudojimas (leidimų sąrašas)
Šį parametrą naudok tada, kai tiksliai žinai, kuriuos šaltinius nori konsultuoti. Pavyzdžiui, atliekant akademinius tyrimus:
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"]
}]
)
Modelis ieškos tik šiuose trijuose domenuose. Tai užtikrina, kad rezultatai bus gauti iš patikrintų mokslinių šaltinių.
Leidimų sąrašo naudojimo atvejai
- Akademiniai tyrimai: apriboti arxiv.org, scholar.google.com, nature.com
- Techninė dokumentacija: apriboti oficialiomis technologijų svetainėmis
- Konkurencinė žvalgyba: apriboti konkurentų svetainėmis
- Reguliavimo reikalavimų laikymasis: apriboti vyriausybiniais ar reguliavimo šaltiniais
excluded_domains naudojimas (blokavimo sąrašas)
Šį parametrą naudok, kai nori atlikti plačią paiešką, bet reikia pašalinti nepatikimus arba nereikšmingus šaltinius:
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"]
}]
)
Modelis ieškos visame internete, išskyrus nurodytus domenus.
Blokavimo sąrašo naudojimo atvejai
- Forumų išskyrimas: venk nepatvirtintų nuomonių
- Agregatorių išskyrimas: venk pasikartojančio turinio
- Konkurentų išskyrimas: neįtrauk jų turinio į rezultatus
- Mokamų sienų (paywall) išskyrimas: venk svetainių su neprieinamu turiniu
SDK sintaksė
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"]
})]
Atkreipk dėmesį į „camelCase“ konvenciją (allowedDomains) JavaScript SDK.
Ribojimai ir geriausios praktikos
5 domenų riba gali atrodyti ribojanti. Tačiau praktiškai tai verčia būti selektyviu renkantis šaltinius, o tai gerina rezultatų kokybę. Jei reikia daugiau lankstumo, gali vykdyti kelias užklausas su skirtingais domenais ir rezultatus agreguoti kliento pusėje.
Naudojant allowed_domains, įsitikink, kad pasirinkti domenai apima nagrinėjamą temą. Per daug ribojantis domenas gali neleisti modeliui rasti svarbios informacijos, todėl jis gali atsakyti remdamasis pasenusiais duomenimis.
Svarbiausi punktai
- Galimi du parametrai:
allowed_domains(leidimų sąrašas) irexcluded_domains(blokavimo sąrašas) - Viena kitą išskiriantys: jų negalima derinti toje pačioje užklausoje
- Didžiausias limitas – 5 domenai vienam parametrui
- Leidimų sąrašas idealiai tinka kontroliuojamiems ir patikimiems šaltiniams
- Blokavimo sąrašas tinka plačioms paieškoms, kai reikia pašalinti tik kelis šaltinius