Webes keresési tartományok szűrése
Ezen az oldalon
Források szabályozása a megbízható eredmények érdekében
Amikor webes keresést integrálsz egy üzleti alkalmazásba, nem szeretnéd, ha a modell bárhonnan húzna be információkat. Egy jogi chatbotnak hivatalos forrásokat kell megkérdeznie, egy orvosi asszisztensnek tudományos publikációkra kell szorítkoznia, egy technológiai figyelő eszköznek pedig referenciákra kell összpontosítania.
A Grok API két szűrőparamétert kínál a források szabályozására: az allowed_domains és az excluded_domains paramétereket. Ezek a paraméterek finomhangolt irányítást biztosítanak a keresési kör felett.
A két szűrési mód
Engedélyezési lista: allowed_domains
Ez a paraméter a keresést kizárólag a megadott tartományokra korlátozza. A modell nem fog más oldalakat lekérdezni:
response = client.responses.create(
model="grok-4.5",
input="What are the latest advancements in AI?",
tools=[{
"type": "web_search",
"allowed_domains": ["arxiv.org", "nature.com", "science.org"]
}]
)
Kizárási lista: excluded_domains
Ez a paraméter minden forrást engedélyez kivéve azokat, amelyeket felsorolsz. Hasznos megbízhatatlan oldalak vagy versenytársak kizárására:
response = client.responses.create(
model="grok-4.5",
input="SaaS market analysis in France",
tools=[{
"type": "web_search",
"excluded_domains": ["reddit.com", "quora.com"]
}]
)
A kölcsönös kizárás szabálya
Az allowed_domains és az excluded_domains paraméterek kölcsönösen kizárják egymást. Nem használhatod mindkettőt egyszerre egyetlen hívásban. Ha megpróbálod kombinálni őket, az API hibát fog visszaadni.
Válaszd ki a stratégiádat a használati eset alapján:
- Engedélyezési lista (
allowed_domains): amikor pontosan tudod, mely források megbízhatók, és minden más gyanús - Kizárási lista (
excluded_domains): amikor a legtöbb forrás elfogadható, de néhány problémát okoz
Öttartományos korlát
Minden paraméter legfeljebb 5 tartományt fogad el. Ez a korlátozás arra kényszerít, hogy prioritást állíts fel a forrásaid között. Ha több oldalt kell lefedned, fontold meg több hívás indítását különböző listákkal, vagy használd a kizárási listát a néhány problémás tartomány blokkolására.
Tartomány szintaxisa
A tartományokat protokoll vagy záró perjel nélkül add meg:
# Helyes
"allowed_domains": ["arxiv.org", "nature.com"]
# Helytelen
"allowed_domains": ["https://arxiv.org/", "www.nature.com"]
Gyakorlati használati esetek
Tudományos kutatási asszisztens
tools=[{
"type": "web_search",
"allowed_domains": [
"arxiv.org",
"pubmed.ncbi.nlm.nih.gov",
"scholar.google.com",
"nature.com",
"science.org"
]
}]
Európai szabályozási figyelés
tools=[{
"type": "web_search",
"allowed_domains": [
"eur-lex.europa.eu",
"legifrance.gouv.fr",
"cnil.fr",
"ec.europa.eu"
]
}]
Vállalati chatbot közösségi média nélkül
tools=[{
"type": "web_search",
"excluded_domains": [
"twitter.com",
"facebook.com",
"reddit.com",
"tiktok.com"
]
}]
Dinamikus szűrési stratégia
Egy valós alkalmazásban a szűrést a felhasználó kérésének kontextusa alapján igazíthatod:
def get_search_config(category):
configs = {
"legal": {
"allowed_domains": ["legifrance.gouv.fr", "eur-lex.europa.eu"]
},
"tech": {
"excluded_domains": ["pinterest.com", "quora.com"]
},
"general": {}
}
return configs.get(category, {})
search_params = get_search_config(user_category)
tools = [{"type": "web_search", **search_params}]
Gyakorlati feladat
Készíts egy asszisztenst, amely egy általad választott területre (jogi, tudományos, technológiai) specializálódott. Konfiguráld a megfelelő tartományszűrést, és teszteld több kérdéssel. Hasonlítsd össze a szűréssel és szűrés nélkül kapott eredményeket, hogy mérd a válaszok relevanciájára gyakorolt hatást.
Főbb megállapítások
- Az
allowed_domainsa keresést egy engedélyezett oldalak listájára korlátozza - Az
excluded_domainskizár konkrét oldalakat a keresésből - Mindkét paraméter kölcsönösen kizárja egymást: hívásonként csak az egyik használható
- Paraméterenként maximum 5 tartomány engedélyezett
- A tartományokat protokoll nélkül add meg (
arxiv.org, nemhttps://arxiv.org) - Igazítsd a stratégiát a használati esethez: engedélyezési lista érzékeny tartományokhoz, kizárási lista a könnyű szűréshez