Domain szűrés
Ezen az oldalon
Keresési források szabályozása
Alapértelmezés szerint a Webes keresés a teljes internetet átvizsgálja. Ez általános lekérdezések esetén jól működik, de gyakran elégtelen olyan professzionális felhasználási eseteknél, ahol megbízható, ellenőrzött forrásokra van szükséged. A domain szűrés lehetővé teszi, hogy korlátozd vagy kizárd a konkrét weboldalakat.
Két egymást kizáró paraméter
A Webes keresés két szűrőparamétert kínál:
allowed_domains: a keresést a megadott domainekre korlátozza (engedélyezési lista)excluded_domains: kizár konkrét domaineket az eredményekből (tiltólista)
Ez a két paraméter egymást kizárja. Nem használhatod mindkettőt ugyanabban a kérésben. Ha mégis megpróbálod, az API hibát ad vissza.
Mindkét paraméter legfeljebb 5 domainből álló tömböt fogad el.
Az allowed_domains (engedélyezési lista) használata
Akkor használd ezt a paramétert, ha pontosan tudod, mely forrásokat szeretnéd lekérdezni. Például tudományos kutatás esetén:
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"]
}]
)
A modell csak ezen a három domainen belül keres. Ez biztosítja, hogy az eredmények ellenőrzött tudományos forrásokból származzanak.
Az engedélyezési lista felhasználási esetei
- Tudományos kutatás: korlátozás az arxiv.org, scholar.google.com, nature.com oldalakra
- Technikai dokumentáció: korlátozás a hivatalos technológiai oldalakra
- Versenytárs-elemzés: korlátozás a versenytársak oldalaira
- Szabályozási megfelelés: korlátozás kormányzati vagy szabályozó szervek forrásaira
Az excluded_domains (tiltólista) használata
Akkor használd ezt a paramétert, ha széles körű keresést szeretnél végezni, de ki kell zárnod a megbízhatatlan vagy irreleváns forrásokat:
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"]
}]
)
A modell a teljes interneten keres, kivéve a kizárt domaineket.
A tiltólista felhasználási esetei
- Fórumok kizárása: az ellenőrizetlen vélemények elkerülése
- Gyűjtőoldalak kizárása: az ismétlődő tartalmak elkerülése
- Versenytársak kizárása: a versenytársak tartalmának távol tartása az eredményektől
- Fizetős falak kizárása: a hozzáférhetetlen tartalmú oldalak elkerülése
SDK szintaxis
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"]
})]
Figyeld meg a camelCase konvenciót (allowedDomains) a JavaScript SDK-ban.
Korlátok és legjobb gyakorlatok
Az 5 domaines korlát elsőre szigorúnak tűnhet. A gyakorlatban azonban arra kényszerít, hogy szelektíven válassz forrásokat, ami javítja az eredmények minőségét. Ha nagyobb rugalmasságra van szükséged, futtathatsz több kérést különböző domainekkel, majd az eredményeket kliens oldalon aggregálhatod.
Az allowed_domains használatakor győződj meg róla, hogy a választott domainek lefedik a kért témát. A túlságosan szigorú domain korlátozás megakadályozhatja a modellt abban, hogy releváns információkat találjon, ami oda vezethet, hogy a modell naprakész adatok nélkül válaszol.
Főbb megállapítások
- Két paraméter áll rendelkezésre:
allowed_domains(engedélyezési lista) ésexcluded_domains(tiltólista) - Egymást kizáróak: nem kombinálhatod őket ugyanabban a kérésben
- Paraméterenként maximum 5 domain használható
- Az engedélyezési lista ideális ellenőrzött, megbízható forrásokhoz
- A tiltólista széles körű kereséseknél hasznos, amikor csak néhány forrást kell kizárni