Filtrering av domäner
På denna sida
Styr sökkällorna
Som standard söker Web Search igenom hela webben. Det fungerar bra för generella frågor, men det räcker ofta inte till för professionella användningsområden där du behöver tillförlitliga och kontrollerade källor. Med filtrering av domäner kan du begränsa eller exkludera specifika webbplatser.
Två ömsesidigt uteslutande parametrar
Web Search erbjuder två filtreringsparametrar:
allowed_domains: begränsar sökningen till angivna domäner (godkänd lista)excluded_domains: exkluderar specifika domäner från resultaten (blockeringslista)
Dessa två parametrar är ömsesidigt uteslutande. Du kan inte använda båda i samma begäran. Om du försöker returnerar API:t ett felmeddelande.
Varje parameter accepterar en array med högst 5 domäner.
Använd allowed_domains (godkänd lista)
Använd denna parameter när du vet exakt vilka källor du vill konsultera. Till exempel för akademisk forskning:
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"]
}]
)
Modellen söker endast igenom dessa tre domäner. Detta säkerställer att resultaten kommer från verifierade vetenskapliga källor.
Användningsområden för godkänd lista
- Akademisk forskning: begränsa till arxiv.org, scholar.google.com, nature.com
- Teknisk dokumentation: begränsa till officiella teknikwebbplatser
- Konkurrensbevakning: begränsa till konkurrenters webbplatser
- Efterlevnad av regelverk: begränsa till statliga eller reglerande källor
Använd excluded_domains (blockeringslista)
Använd denna parameter när du vill göra en bred sökning men behöver exkludera opålitliga eller irrelevanta källor:
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"]
}]
)
Modellen söker igenom hela webben utom de exkluderade domänerna.
Användningsområden för blockeringslista
- Exkludera forum: undvik overifierade åsikter
- Exkludera aggregatorer: undvik duplicerat innehåll
- Exkludera konkurrenter: håll deras innehåll borta från dina resultat
- Exkludera betalväggar: undvik webbplatser med otillgängligt innehåll
SDK-syntax
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"]
})]
Observera konventionen med camelCase (allowedDomains) i JavaScript-SDK:t.
Begränsningar och bästa praxis
Gränsen på 5 domäner kan verka restriktiv. I praktiken tvingar den dig att vara selektiv med källorna, vilket förbättrar resultatens kvalitet. Om du behöver mer flexibilitet kan du köra flera begäranden med olika domäner och sammanställa resultaten på klientsidan.
När du använder allowed_domains måste du se till att de valda domänerna täcker det begärda ämnet. En alltför restriktiv domän kan hindra modellen från att hitta relevant information, vilket kan leda till att den svarar utan aktuella data.
Viktiga punkter
- Två parametrar finns tillgängliga:
allowed_domains(godkänd lista) ochexcluded_domains(blockeringslista) - Ömsesidigt uteslutande: du kan inte kombinera dem i samma begäran
- Högst 5 domäner per parameter
- Godkänd lista är idealisk för kontrollerade och tillförlitliga källor
- Blockeringslista fungerar bra för breda sökningar med några få undantag