Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Filtrering af domæner

Lektion 5 af 16 Opdateret 30. juli 2026 Udvikler
På denne side
  1. Styring af søgekilder
  2. To gensidigt udelukkende parametre
  3. Brug af allowed_domains (allowlist)
  4. Brug af excluded_domains (blocklist)
  5. SDK-syntaks
  6. Begrænsninger og bedste praksis
  7. Vigtige pointer

Styring af søgekilder

Som standard gennemsøger Web Search hele internettet. Det fungerer fint til generelle forespørgsler, men det falder ofte til kort i professionelle scenarier, hvor du har brug for pålidelige og kontrollerede kilder. Filtrering af domæner giver dig mulighed for at begrænse eller udelukke specifikke websteder.

To gensidigt udelukkende parametre

Web Search tilbyder to filtreringsparametre:

  • allowed_domains: Begrænser søgningen til angivne domæner (allowlist)
  • excluded_domains: Udelukker specifikke domæner fra resultaterne (blocklist)

Disse to parametre er gensidigt udelukkende. Du kan ikke bruge begge i den samme anmodning. Hvis du forsøger det, returnerer API’en en fejl.

Hver parameter accepterer en liste med op til 5 domæner.

Brug af allowed_domains (allowlist)

Brug denne parameter, når du præcist ved, hvilke kilder du vil konsultere. F.eks. til 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øger kun på disse tre domæner. Det sikrer, at resultaterne stammer fra verificerede videnskabelige kilder.

Anvendelsestilfælde for allowlist

  • Akademisk forskning: Begræns til arxiv.org, scholar.google.com, nature.com
  • Teknisk dokumentation: Begræns til officielle teknologisider
  • Konkurrentanalyse: Begræns til konkurrenters websteder
  • Overholdelse af regler: Begræns til regerings- eller tilsynskilder

Brug af excluded_domains (blocklist)

Brug denne parameter, når du ønsker en bred søgning, men har brug for at udelukke upålidelige eller irrelevante kilder:

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øger på hele internettet undtagen de udelukkede domæner.

Anvendelsestilfælde for blocklist

  • Udeluk fora: Undgå ubekræftede meninger
  • Udeluk aggregatorer: Undgå duplikeret indhold
  • Udeluk konkurrenter: Hold deres indhold ude af dine resultater
  • Udeluk paywalls: Undgå sider med utilgængeligt indhold

SDK-syntaks

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"]
})]

Bemærk camelCase-konventionen (allowedDomains) i JavaScript-SDK’et.

Begrænsninger og bedste praksis

Grænsen på 5 domæner kan virke restriktiv. I praksis tvinger den dig til at være selektiv med kilderne, hvilket forbedrer kvaliteten af resultaterne. Hvis du har brug for mere fleksibilitet, kan du køre flere anmodninger med forskellige domæner og samle resultaterne på klientsiden.

Når du bruger allowed_domains, skal du sikre dig, at de valgte domæner dækker det ønskede emne. Et domæne, der er for restriktivt, kan forhindre modellen i at finde relevante oplysninger, hvilket kan få den til at svare uden opdaterede data.

Vigtige pointer

  • To tilgængelige parametre: allowed_domains (allowlist) og excluded_domains (blocklist)
  • Gensidigt udelukkende: Du kan ikke kombinere dem i samme anmodning
  • Maksimalt 5 domæner pr. parameter
  • Allowlist er ideel til kontrollerede, pålidelige kilder
  • Blocklist fungerer til brede søgninger med få undtagelser