Domänenfilterung
Auf dieser Seite
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) undexcluded_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