Domeinen voor webzoekopdrachten filteren
Op deze pagina
Bronnen sturen voor betrouwbare resultaten
Wanneer u webzoekopdrachten integreert in een zakelijke applicatie, wilt u niet dat het model informatie van overal haalt. Een juridische chatbot moet officiële bronnen raadplegen, een medische assistent moet zich beperken tot wetenschappelijke publicaties, en een tool voor technologische monitoring moet zich richten op referentiesites.
De Grok API biedt twee filterparameters om bronnen te sturen: allowed_domains en excluded_domains. Deze parameters geven u gedetailleerde controle over de reikwijdte van de zoekopdracht.
De twee filtermodi
Toestemmingslijst: allowed_domains
Deze parameter beperkt de zoekopdracht tot alleen de domeinen die u opgeeft. Het model zal geen andere sites raadplegen:
response = client.responses.create(
model="grok-4.5",
input="What are the latest advancements in AI?",
tools=[{
"type": "web_search",
"allowed_domains": ["arxiv.org", "nature.com", "science.org"]
}]
)
Uitsluitingslijst: excluded_domains
Deze parameter staat alle bronnen toe behalve die u opneemt in de lijst. Handig om onbetrouwbare sites of concurrenten uit te sluiten:
response = client.responses.create(
model="grok-4.5",
input="SaaS market analysis in France",
tools=[{
"type": "web_search",
"excluded_domains": ["reddit.com", "quora.com"]
}]
)
De regel van wederzijdse uitsluiting
De parameters allowed_domains en excluded_domains zijn wederzijds uitsluitend. U kunt ze niet tegelijkertijd gebruiken in één enkele aanroep. Als u probeert ze te combineren, retourneert de API een foutmelding.
Kies uw strategie op basis van de use case:
- Toestemmingslijst (
allowed_domains): wanneer u precies weet welke bronnen betrouwbaar zijn en al het andere verdacht is - Uitsluitingslijst (
excluded_domains): wanneer de meeste bronnen acceptabel zijn, maar een paar problemen opleveren
Limiet van vijf domeinen
Elke parameter accepteert maximaal 5 domeinen. Deze beperking dwingt u om prioriteit te geven aan uw bronnen. Als u meer sites moet dekking, overweeg dan om meerdere aanroepen te doen met verschillende lijsten, of gebruik de uitsluitingslijst om de paar problematische domeinen te blokkeren.
Domeinsyntaxis
Geef domeinen op zonder protocol of afsluitende schuine streep:
# Correct
"allowed_domains": ["arxiv.org", "nature.com"]
# Onjuist
"allowed_domains": ["https://arxiv.org/", "www.nature.com"]
Praktische use cases
Assistent voor wetenschappelijk onderzoek
tools=[{
"type": "web_search",
"allowed_domains": [
"arxiv.org",
"pubmed.ncbi.nlm.nih.gov",
"scholar.google.com",
"nature.com",
"science.org"
]
}]
Monitoring van Europese regelgeving
tools=[{
"type": "web_search",
"allowed_domains": [
"eur-lex.europa.eu",
"legifrance.gouv.fr",
"cnil.fr",
"ec.europa.eu"
]
}]
Enterprise-chatbot zonder sociale media
tools=[{
"type": "web_search",
"excluded_domains": [
"twitter.com",
"facebook.com",
"reddit.com",
"tiktok.com"
]
}]
Dynamische filterstrategie
In een echte applicatie kunt u de filtering aanpassen op basis van de context van het verzoek van de gebruiker:
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}]
Oefening in de praktijk
Maak een assistent die gespecialiseerd is in een domein naar keuze (juridisch, wetenschappelijk, technologisch). Configureer de juiste domeinfiltering en test deze met verschillende vragen. Vergelijk de verkregen resultaten met en zonder filtering om de impact op de relevantie van het antwoord te meten.
Belangrijkste punten
allowed_domainsbeperkt de zoekopdracht tot een toestemmingslijst van sitesexcluded_domainssluit specifieke sites uit van de zoekopdracht- Beide parameters zijn wederzijds uitsluitend: slechts één per aanroep
- Maximaal 5 domeinen per parameter
- Geef domeinen op zonder protocol (
arxiv.org, niethttps://arxiv.org) - Pas de strategie aan op de use case: toestemmingslijst voor gevoelige domeinen, uitsluitingslijst voor lichte filtering