Salt la conținutul principal
Română— Alege o limbă
Meniu

Filtrarea domeniilor de căutare pe web

Lecția 2 din 14 Actualizată 30 iulie 2026 Începător
Pe această pagină
  1. Controlul surselor pentru rezultate fiabile
  2. Cele două moduri de filtrare
  3. Regula de exclusivitate reciprocă
  4. Limita de cinci domenii
  5. Cazuri de utilizare practice
  6. Strategie de filtrare dinamică
  7. Exercițiu practic
  8. Puncte cheie

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_domains restricționează căutarea la o listă de site-uri permise
  • excluded_domains exclude 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, nu https://arxiv.org)
  • Adaptați strategia la cazul de utilizare: listă de permisiuni pentru domenii sensibile, listă de excluderi pentru filtrare ușoară