Web-Suchdomänen filtern
Auf dieser Seite
Quellen steuern für zuverlässige Ergebnisse
Wenn Sie eine Web-Suche in eine geschäftliche Anwendung integrieren, möchten Sie nicht, dass das Modell Informationen von überall zieht. Ein rechtlicher Chatbot muss sich an offizielle Quellen wenden, eine medizinische Assistenzsoftware muss sich auf wissenschaftliche Publikationen beschränken und ein Technologie-Monitoring-Tool sollte sich auf Referenzseiten konzentrieren.
Die Grok-API bietet zwei Filterparameter, um die Quellen zu steuern: allowed_domains und excluded_domains. Diese Parameter geben Ihnen eine granulare Kontrolle über den Suchbereich.
Die zwei Filtermodi
Whitelist: allowed_domains
Dieser Parameter beschränkt die Suche ausschließlich auf die von Ihnen angegebenen Domänen. Das Modell konsultiert keine anderen Websites:
response = client.responses.create(
model="grok-4.5",
input="Was sind die neuesten Fortschritte in der KI?",
tools=[{
"type": "web_search",
"allowed_domains": ["arxiv.org", "nature.com", "science.org"]
}]
)
Ausschlussliste: excluded_domains
Dieser Parameter erlaubt alle Quellen außer denen, die Sie auflisten. Dies ist nützlich, um unzuverlässige Websites oder Wettbewerber auszuschließen:
response = client.responses.create(
model="grok-4.5",
input="Marktanalyse für SaaS in Frankreich",
tools=[{
"type": "web_search",
"excluded_domains": ["reddit.com", "quora.com"]
}]
)
Die Regel der gegenseitigen Ausschließbarkeit
Die Parameter allowed_domains und excluded_domains sind gegenseitig ausschließend. Sie können sie nicht gleichzeitig in einem einzigen Aufruf verwenden. Wenn Sie versuchen, sie zu kombinieren, gibt die API einen Fehler zurück.
Wählen Sie Ihre Strategie basierend auf dem Anwendungsfall:
- Whitelist (
allowed_domains): wenn Sie genau wissen, welche Quellen zuverlässig sind und alles andere verdächtig - Ausschlussliste (
excluded_domains): wenn die meisten Quellen akzeptabel sind, aber einige Probleme bereiten
Fünf-Domänen-Limit
Jeder Parameter akzeptiert maximal 5 Domänen. Diese Einschränkung zwingt Sie, Ihre Quellen zu priorisieren. Wenn Sie mehr Websites abdecken müssen, erwägen Sie mehrere Aufrufe mit unterschiedlichen Listen oder verwenden Sie die Ausschlussliste, um die wenigen problematischen Domänen zu blockieren.
Domänensyntax
Geben Sie Domänen ohne Protokoll oder abschließendes Schrägstrich an:
# Korrekt
"allowed_domains": ["arxiv.org", "nature.com"]
# Falsch
"allowed_domains": ["https://arxiv.org/", "www.nature.com"]
Praktische Anwendungsfälle
Wissenschaftlicher Forschungsassistent
tools=[{
"type": "web_search",
"allowed_domains": [
"arxiv.org",
"pubmed.ncbi.nlm.nih.gov",
"scholar.google.com",
"nature.com",
"science.org"
]
}]
Überwachung der europäischen Regulierung
tools=[{
"type": "web_search",
"allowed_domains": [
"eur-lex.europa.eu",
"legifrance.gouv.fr",
"cnil.fr",
"ec.europa.eu"
]
}]
Unternehmens-Chatbot ohne soziale Medien
tools=[{
"type": "web_search",
"excluded_domains": [
"twitter.com",
"facebook.com",
"reddit.com",
"tiktok.com"
]
}]
Dynamische Filterstrategie
In einer echten Anwendung können Sie das Filtern basierend auf dem Kontext der Benutzeranfrage anpassen:
def get_search_config(category):
configs = {
"legal": {
"allowed_domains": ["legifrance.gouv.fr", "eur-lex.europa.eu"]
},
"tech": {
"excluded_domains": ["pinterest.com", "quora.com"]
},
"general": {}
}
return configs.get(category, {})
search_params = get_search_config(user_category)
tools = [{"type": "web_search", **search_params}]
Praktische Übung
Erstellen Sie einen Assistenten, der sich auf einen Bereich Ihrer Wahl spezialisiert (rechtlich, wissenschaftlich, technologisch). Konfigurieren Sie die entsprechende Domänenfilterung und testen Sie ihn mit mehreren Fragen. Vergleichen Sie die erzielten Ergebnisse mit und ohne Filterung, um den Einfluss auf die Relevanz der Antworten zu messen.
Kernaussagen
allowed_domainsbeschränkt die Suche auf eine Whitelist von Websitesexcluded_domainsschließt bestimmte Websites von der Suche aus- Beide Parameter sind gegenseitig ausschließend: nur einer pro Aufruf
- Maximale 5 Domänen pro Parameter
- Geben Sie Domänen ohne Protokoll an (
arxiv.org, nichthttps://arxiv.org) - Passen Sie die Strategie dem Anwendungsfall an: Whitelist für sensible Domänen, Ausschlussliste für leichte Filterung