Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Filtrering av domäner

Lektion 5 av 16 Uppdaterad 30 juli 2026 Utvecklare
På denna sida
  1. Styr sökkällorna
  2. Två ömsesidigt uteslutande parametrar
  3. Använd allowed_domains (godkänd lista)
  4. Använd excluded_domains (blockeringslista)
  5. SDK-syntax
  6. Begränsningar och bästa praxis
  7. Viktiga punkter

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) och excluded_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