Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Domänenfilterung

Lektion 5 von 16 Aktualisiert am 30. Juli 2026 Entwickler
Auf dieser Seite
  1. Suchquellen steuern
  2. Zwei sich gegenseitig ausschließende Parameter
  3. Verwendung von allowed_domains (Whitelist)
  4. Verwendung von excluded_domains (Blacklist)
  5. SDK-Syntax
  6. Grenzen und bewährte Verfahren
  7. Kernaussagen

Suchquellen steuern

Standardmäßig durchsucht die Web-Suche das gesamte Internet. Dies funktioniert gut für allgemeine Abfragen, reicht jedoch oft nicht für professionelle Anwendungsfälle aus, bei denen Sie verlässliche, kontrollierte Quellen benötigen. Mit der Domänenfilterung können Sie bestimmte Websites einschränken oder ausschließen.

Zwei sich gegenseitig ausschließende Parameter

Die Web-Suche bietet zwei Filterparameter an:

  • allowed_domains: Beschränkt die Suche auf festgelegte Domänen (Whitelist)
  • excluded_domains: Schließt bestimmte Domänen aus den Ergebnissen aus (Blacklist)

Diese beiden Parameter sind sich gegenseitig ausschließend. Sie können sie nicht in derselben Anfrage verwenden. Versuchen Sie es, und die API gibt einen Fehler zurück.

Jeder Parameter akzeptiert ein Array von höchstens 5 Domänen.

Verwendung von allowed_domains (Whitelist)

Verwenden Sie diesen Parameter, wenn Sie genau wissen, welche Quellen Sie konsultieren möchten. Zum Beispiel für akademische Forschung:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Was sind die neuesten Veröffentlichungen zu Transformern?",
    tools=[{
        "type": "web_search",
        "allowed_domains": ["arxiv.org", "nature.com", "science.org"]
    }]
)

Das Modell durchsucht nur diese drei Domänen. Dies stellt sicher, dass die Ergebnisse aus verifizierten wissenschaftlichen Quellen stammen.

Anwendungsfälle für Whitelists

  • Akademische Forschung: Beschränkung auf arxiv.org, scholar.google.com, nature.com
  • Technische Dokumentation: Beschränkung auf offizielle Technologie-Websites
  • Wettbewerbsanalyse: Beschränkung auf Wettbewerber-Websites
  • Regulatorische Compliance: Beschränkung auf Regierungs- oder regulatorische Quellen

Verwendung von excluded_domains (Blacklist)

Verwenden Sie diesen Parameter, wenn Sie eine breite Suche durchführen, aber bestimmte unzuverlässige oder irrelevante Quellen ausschließen möchten:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Welche JavaScript-Frameworks sind 2026 am besten?",
    tools=[{
        "type": "web_search",
        "excluded_domains": ["reddit.com", "quora.com"]
    }]
)

Das Modell durchsucht das gesamte Internet, mit Ausnahme der ausgeschlossenen Domänen.

Anwendungsfälle für Blacklists

  • Ausschluss von Foren: Vermeidung unüberprüfter Meinungen
  • Ausschluss von Aggregatoren: Vermeidung von doppeltem Inhalt
  • Ausschluss von Wettbewerbern: Halten Sie deren Inhalte aus Ihren Ergebnissen fern
  • Ausschluss von Paywalls: Vermeidung von Websites mit nicht zugänglichen Inhalten

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

Beachten Sie die camelCase-Konvention (allowedDomains) im JavaScript-SDK.

Grenzen und bewährte Verfahren

Die Begrenzung auf 5 Domänen mag einschränkend wirken. In der Praxis zwingt sie Sie jedoch, sich bei den Quellen selektiv zu zeigen, was die Ergebnisqualität verbessert. Wenn Sie mehr Flexibilität benötigen, können Sie mehrere Anfragen mit unterschiedlichen Domänen ausführen und die Ergebnisse auf der Client-Seite aggregieren.

Bei der Verwendung von allowed_domains stellen Sie sicher, dass die gewählten Domänen das angeforderte Thema abdecken. Eine zu restriktive Domäne könnte verhindern, dass das Modell relevante Informationen findet, was dazu führen könnte, dass es ohne aktuelle Daten antwortet.

Kernaussagen

  • Zwei Parameter verfügbar: allowed_domains (Whitelist) und excluded_domains (Blacklist)
  • Sich gegenseitig ausschließend: Sie können sie nicht in derselben Anfrage kombinieren
  • Maximum 5 Domänen pro Parameter
  • Whitelists sind ideal für kontrollierte, verlässliche Quellen
  • Blacklists funktionieren gut für breite Suchen mit wenigen Ausnahmen