Filtrare i domini di ricerca web
In questa pagina
Controlla le fonti per risultati affidabili
Quando integri la ricerca web in un’applicazione aziendale, non vuoi che il modello estragga informazioni da qualsiasi parte. Un chatbot legale deve consultare fonti ufficiali, un assistente medico deve attenersi alle pubblicazioni scientifiche e uno strumento di monitoraggio tecnologico dovrebbe prendere di mira siti di riferimento.
Le API di Grok offrono due parametri di filtraggio per controllare le fonti: allowed_domains ed excluded_domains. Questi parametri ti danno un controllo granulare sull’ambito della ricerca.
Le due modalità di filtraggio
Allowlist: allowed_domains
Questo parametro limita la ricerca esclusivamente ai domini che specifichi. Il modello non consulterà nessun altro sito:
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"]
}]
)
Exclude List: excluded_domains
Questo parametro consente tutte le fonti tranne quelle che elenchi. Utile per escludere siti inaffidabili o concorrenti:
response = client.responses.create(
model="grok-4.5",
input="SaaS market analysis in France",
tools=[{
"type": "web_search",
"excluded_domains": ["reddit.com", "quora.com"]
}]
)
La regola di esclusività reciproca
I parametri allowed_domains ed excluded_domains sono mutuamente esclusivi. Non puoi usarli entrambi contemporaneamente in una singola chiamata. Se provi a combinarli, l’API restituirà un errore.
Scegli la tua strategia in base al caso d’uso:
- Allowlist (
allowed_domains): quando sai esattamente quali fonti sono affidabili e tutto il resto è sospetto - Exclude list (
excluded_domains): quando la maggior parte delle fonti è accettabile ma alcune pongono problemi
Limite di cinque domini
Ogni parametro accetta un massimo di 5 domini. Questo vincolo ti costringe a dare priorità alle tue fonti. Se devi coprire più siti, considera di effettuare chiamate multiple con elenchi diversi o usa l’elenco di esclusione per bloccare i pochi domini problematici.
Sintassi del dominio
Specifica i domini senza protocollo né barra finale:
# Corretto
"allowed_domains": ["arxiv.org", "nature.com"]
# Errato
"allowed_domains": ["https://arxiv.org/", "www.nature.com"]
Casi d’uso pratici
Assistente per la ricerca scientifica
tools=[{
"type": "web_search",
"allowed_domains": [
"arxiv.org",
"pubmed.ncbi.nlm.nih.gov",
"scholar.google.com",
"nature.com",
"science.org"
]
}]
Monitoraggio normativo europeo
tools=[{
"type": "web_search",
"allowed_domains": [
"eur-lex.europa.eu",
"legifrance.gouv.fr",
"cnil.fr",
"ec.europa.eu"
]
}]
Chatbot aziendale senza social media
tools=[{
"type": "web_search",
"excluded_domains": [
"twitter.com",
"facebook.com",
"reddit.com",
"tiktok.com"
]
}]
Strategia di filtraggio dinamico
In un’applicazione reale, puoi adattare il filtraggio in base al contesto della richiesta dell’utente:
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}]
Esercitazione pratica
Crea un assistente specializzato in un dominio a tua scelta (legale, scientifico, tecnologico). Configura il filtraggio dei domini appropriato e testalo con diverse domande. Confronta i risultati ottenuti con e senza filtraggio per misurare l’impatto sulla pertinenza della risposta.
Punti chiave
allowed_domainslimita la ricerca a un allowlist di sitiexcluded_domainsesclude siti specifici dalla ricerca- Entrambi i parametri sono mutuamente esclusivi: solo uno per chiamata
- Massimo 5 domini per parametro
- Specifica i domini senza protocollo (
arxiv.org, nonhttps://arxiv.org) - Adatta la strategia al caso d’uso: allowlist per domini sensibili, exclude list per un filtraggio leggero