Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Filtrare i domini di ricerca web

Lezione 2 di 14 Aggiornata il 30 luglio 2026 Principiante
In questa pagina
  1. Controlla le fonti per risultati affidabili
  2. Le due modalità di filtraggio
  3. La regola di esclusività reciproca
  4. Limite di cinque domini
  5. Casi d’uso pratici
  6. Strategia di filtraggio dinamico
  7. Esercitazione pratica
  8. Punti chiave

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_domains limita la ricerca a un allowlist di siti
  • excluded_domains esclude 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, non https://arxiv.org)
  • Adatta la strategia al caso d’uso: allowlist per domini sensibili, exclude list per un filtraggio leggero