Filtriranje domen pri spletnem iskanju
Na tej strani
Nadzor virov za zanesljive rezultate
Ko v poslovno aplikacijo integriraš spletno iskanje, ne želiš, da model črpa informacije od koder koli. Pravni klepetalni bot se mora posvetovati z uradnimi viri, medicinski pomočnik se mora držati znanstvenih publikacij, orodje za spremljanje tehnologije pa naj cilja na referenčna spletna mesta.
API Grok ponuja dva filtra za nadzor virov: allowed_domains in excluded_domains. Ta parametra ti omogočata natančen nadzor nad obsegom iskanja.
Dva načina filtriranja
Seznam dovoljenih: allowed_domains
Ta parameter omeji iskanje izključno na domene, ki jih določiš. Model ne bo pregledal nobenih drugih strani:
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"]
}]
)
Seznam izključenih: excluded_domains
Ta parameter dovoli vse vire razen tistih, ki jih navedeš. Uporaben je za izključitev nezanesljivih strani ali konkurentov:
response = client.responses.create(
model="grok-4.5",
input="SaaS market analysis in France",
tools=[{
"type": "web_search",
"excluded_domains": ["reddit.com", "quora.com"]
}]
)
Pravilo medsebojne izključnosti
Parametra allowed_domains in excluded_domains sta medsebojno izključujoča. V enem klicu ne moreš uporabiti obeh hkrati. Če ju poskušaš združiti, bo API vrnil napako.
Svojo strategijo izberi glede na primer uporabe:
- Seznam dovoljenih (
allowed_domains): ko natančno veš, kateri viri so zanesljivi in je vse drugo sumljivo. - Seznam izključenih (
excluded_domains): ko je večina virov sprejemljivih, le nekaj pa povzroča težave.
Omejitev na pet domen
Vsak parameter sprejme največ 5 domen. Ta omejitev te prisili, da svoje vire prioritetno razvrstiš. Če moraš zajeti več strani, razmisli o več klicih z različnimi seznami ali uporabi seznam izključenih za blokiranje nekaj problematičnih domen.
Sintaksa domen
Domene navedi brez protokola ali končne poševnice:
# Pravilno
"allowed_domains": ["arxiv.org", "nature.com"]
# Nepravilno
"allowed_domains": ["https://arxiv.org/", "www.nature.com"]
Praktični primeri uporabe
Pomočnik za znanstvene raziskave
tools=[{
"type": "web_search",
"allowed_domains": [
"arxiv.org",
"pubmed.ncbi.nlm.nih.gov",
"scholar.google.com",
"nature.com",
"science.org"
]
}]
Spremljanje evropske regulative
tools=[{
"type": "web_search",
"allowed_domains": [
"eur-lex.europa.eu",
"legifrance.gouv.fr",
"cnil.fr",
"ec.europa.eu"
]
}]
Podjetniški klepetalni bot brez družbenih medijev
tools=[{
"type": "web_search",
"excluded_domains": [
"twitter.com",
"facebook.com",
"reddit.com",
"tiktok.com"
]
}]
Dinamična strategija filtriranja
V realni aplikaciji lahko filtriranje prilagajaš glede na kontekst uporabnikove zahteve:
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}]
Praktična vaja
Ustvari pomočnika, specializiranega za področje po tvoji izbiri (pravno, znanstveno, tehnološko). Konfiguriraj ustrezno filtriranje domen in ga preizkusi z več vprašanji. Primerjaj rezultate, pridobljene s filtriranjem in brez njega, da izmeriš vpliv na ustreznost odgovorov.
Ključne ugotovitve
allowed_domainsomeji iskanje na seznam dovoljenih strani.excluded_domainsiz iskanja izključi določene strani.- Oba parametra sta medsebojno izključujoča: na klic lahko uporabiš le enega.
- Največ 5 domen na parameter.
- Domene navedi brez protokola (
arxiv.org, nehttps://arxiv.org). - Strategijo prilagodi primeru uporabe: seznam dovoljenih za občutljive domene, seznam izključenih za lažje filtriranje.