Filtrera domäner för webbsökning
På denna sida
Styr källorna för tillförlitliga resultat
När du integrerar webbsökning i en affärsapplikation vill du inte att modellen ska hämta information var som helst. En juridisk chattbot måste konsultera officiella källor, en medicinsk assistent måste hålla sig till vetenskapliga publikationer och ett verktyg för teknikbevakning bör rikta in sig på referenssidor.
Grok API erbjuder två filtreringsparametrar för att styra källorna: allowed_domains och excluded_domains. Dessa parametrar ger dig finjusterad kontroll över sökomfånget.
De två filtreringslägena
Tillåt-lista: allowed_domains
Denna parameter begränsar sökningen till endast de domäner du anger. Modellen kommer inte att konsultera några andra webbplatser:
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"]
}]
)
Exkluderingslista: excluded_domains
Denna parameter tillåter alla källor utom de du listar. Användbart för att exkludera opålitliga webbplatser eller konkurrenter:
response = client.responses.create(
model="grok-4.5",
input="SaaS market analysis in France",
tools=[{
"type": "web_search",
"excluded_domains": ["reddit.com", "quora.com"]
}]
)
Regeln om ömsesidig uteslutning
Parametrarna allowed_domains och excluded_domains är ömsesidigt uteslutande. Du kan inte använda båda samtidigt i samma anrop. Om du försöker kombinera dem returnerar API:t ett felmeddelande.
Välj din strategi baserat på användningsfallet:
- Tillåt-lista (
allowed_domains): när du vet exakt vilka källor som är tillförlitliga och allt annat är misstänkt - Exkluderingslista (
excluded_domains): när de flesta källor är acceptabla men några få ställer till problem
Gräns på fem domäner
Varje parameter accepterar maximalt 5 domäner. Denna begränsning tvingar dig att prioritera dina källor. Om du behöver täcka fler webbplatser kan du överväga att göra flera anrop med olika listor, eller använda exkluderingslistan för att blockera de få problematiska domänerna.
Domänsyntax
Ange domäner utan protokoll eller avslutande snedstreck:
# Korrekt
"allowed_domains": ["arxiv.org", "nature.com"]
# Felaktigt
"allowed_domains": ["https://arxiv.org/", "www.nature.com"]
Praktiska användningsfall
Assistent för vetenskaplig forskning
tools=[{
"type": "web_search",
"allowed_domains": [
"arxiv.org",
"pubmed.ncbi.nlm.nih.gov",
"scholar.google.com",
"nature.com",
"science.org"
]
}]
Bevakning av europeisk lagstiftning
tools=[{
"type": "web_search",
"allowed_domains": [
"eur-lex.europa.eu",
"legifrance.gouv.fr",
"cnil.fr",
"ec.europa.eu"
]
}]
Företagschattbot utan sociala medier
tools=[{
"type": "web_search",
"excluded_domains": [
"twitter.com",
"facebook.com",
"reddit.com",
"tiktok.com"
]
}]
Dynamisk filtreringsstrategi
I en riktig applikation kan du anpassa filtreringen baserat på sammanhanget i användarens förfrågan:
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}]
Praktisk övning
Skapa en assistent specialiserad på ett område du väljer (juridik, vetenskap, teknik). Konfigurera lämplig domänfiltrering och testa den med flera frågor. Jämför resultaten du får med och utan filtrering för att mäta effekten på svarens relevans.
Viktiga punkter
allowed_domainsbegränsar sökningen till en tillåt-lista av webbplatserexcluded_domainsexkluderar specifika webbplatser från sökningen- Båda parametrarna är ömsesidigt uteslutande: endast en per anrop
- Maximalt 5 domäner per parameter
- Ange domäner utan protokoll (
arxiv.org, intehttps://arxiv.org) - Anpassa strategin efter användningsfallet: tillåt-lista för känsliga domäner, exkluderingslista för lätt filtrering