Filtrarea domeniilor de căutare pe web
Pe această pagină
Controlul surselor pentru rezultate fiabile
Atunci când integrați căutarea pe web într-o aplicație de afaceri, nu doriți ca modelul să preia informații de oriunde. Un chatbot juridic trebuie să consulte surse oficiale, un asistent medical trebuie să se limiteze la publicații științifice, iar un instrument de monitorizare tehnologică ar trebui să vizeze site-uri de referință.
API-ul Grok oferă doi parametri de filtrare pentru a controla sursele: allowed_domains și excluded_domains. Acești parametri vă oferă un control granular asupra domeniului de căutare.
Cele două moduri de filtrare
Listă de permisiuni: allowed_domains
Acest parametru restricționează căutarea exclusiv la domeniile pe care le specificați. Modelul nu va consulta niciun alt site:
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"]
}]
)
Listă de excluderi: excluded_domains
Acest parametru permite toate sursele cu excepția celor pe care le listați. Este util pentru excluderea site-urilor nesigure sau a concurenților:
response = client.responses.create(
model="grok-4.5",
input="SaaS market analysis in France",
tools=[{
"type": "web_search",
"excluded_domains": ["reddit.com", "quora.com"]
}]
)
Regula de exclusivitate reciprocă
Parametrii allowed_domains și excluded_domains sunt reciproc exclusivi. Nu puteți utiliza ambii parametri simultan într-un singur apel. Dacă încercați să îi combinați, API-ul va returna o eroare.
Alegeți strategia în funcție de cazul de utilizare:
- Listă de permisiuni (
allowed_domains): atunci când știți exact care surse sunt fiabile și orice altceva este suspect - Listă de excluderi (
excluded_domains): atunci când majoritatea surselor sunt acceptabile, dar câteva pun probleme
Limita de cinci domenii
Fiecare parametru acceptă un maxim de 5 domenii. Această constrângere vă obligă să vă prioritizați sursele. Dacă trebuie să acoperiți mai multe site-uri, luați în considerare efectuarea mai multor apeluri cu liste diferite sau utilizați lista de excluderi pentru a bloca puținele domenii problematice.
Sintaxa domeniului
Specificați domeniile fără protocol și fără bară oblică finală:
# Corect
"allowed_domains": ["arxiv.org", "nature.com"]
# Incorect
"allowed_domains": ["https://arxiv.org/", "www.nature.com"]
Cazuri de utilizare practice
Asistent pentru cercetare științifică
tools=[{
"type": "web_search",
"allowed_domains": [
"arxiv.org",
"pubmed.ncbi.nlm.nih.gov",
"scholar.google.com",
"nature.com",
"science.org"
]
}]
Monitorizare reglementară europeană
tools=[{
"type": "web_search",
"allowed_domains": [
"eur-lex.europa.eu",
"legifrance.gouv.fr",
"cnil.fr",
"ec.europa.eu"
]
}]
Chatbot enterprise fără rețele sociale
tools=[{
"type": "web_search",
"excluded_domains": [
"twitter.com",
"facebook.com",
"reddit.com",
"tiktok.com"
]
}]
Strategie de filtrare dinamică
Într-o aplicație reală, puteți adapta filtrarea în funcție de contextul cererii utilizatorului:
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}]
Exercițiu practic
Creați un asistent specializat într-un domeniu la alegerea dumneavoastră (juridic, științific, tehnologic). Configurați filtrarea adecvată a domeniilor și testați-l cu mai multe întrebări. Comparați rezultatele obținute cu și fără filtrare pentru a măsura impactul asupra relevanței răspunsurilor.
Puncte cheie
allowed_domainsrestricționează căutarea la o listă de site-uri permiseexcluded_domainsexclude site-uri specifice din căutare- Ambii parametri sunt reciproc exclusivi: doar unul per apel
- Maxim 5 domenii per parametru
- Specificați domeniile fără protocol (
arxiv.org, nuhttps://arxiv.org) - Adaptați strategia la cazul de utilizare: listă de permisiuni pentru domenii sensibile, listă de excluderi pentru filtrare ușoară