Filtrarea pe domenii
Pe această pagină
Controlul surselor de căutare
În mod implicit, funcția Web Search explorează întregul web. Acest lucru funcționează bine pentru interogările generale, dar se dovedește adesea insuficient pentru cazurile de utilizare profesionale, unde aveți nevoie de surse fiabile și controlate. Filtrarea pe domenii vă permite să restricționați sau să excludeți site-uri specifice.
Doi parametri mutual exclusivi
Web Search oferă doi parametri de filtrare:
allowed_domains: restricționează căutarea la domeniile specificate (listă de permisiuni)excluded_domains: exclude domenii specifice din rezultate (listă de blocare)
Acești doi parametri sunt mutual exclusivi. Nu îi puteți utiliza pe amândoi în aceeași cerere. Dacă încercați acest lucru, API-ul va returna o eroare.
Fiecare parametru acceptă un tablou de maximum 5 domenii.
Utilizarea allowed_domains (listă de permisiuni)
Utilizați acest parametru atunci când știți exact ce surse doriți să consultați. De exemplu, pentru cercetare academică:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What are the latest publications on transformers?",
tools=[{
"type": "web_search",
"allowed_domains": ["arxiv.org", "nature.com", "science.org"]
}]
)
Modelul va căuta doar în aceste trei domenii. Acest lucru asigură faptul că rezultatele provin din surse științifice verificate.
Cazuri de utilizare pentru lista de permisiuni
- Cercetare academică: limitare la arxiv.org, scholar.google.com, nature.com
- Documentație tehnică: limitare la site-urile oficiale ale tehnologiilor
- Informații competitive: limitare la site-urile concurenților
- Conformitate reglementară: limitare la surse guvernamentale sau de reglementare
Utilizarea excluded_domains (listă de blocare)
Utilizați acest parametru atunci când doriți o căutare largă, dar trebuie să excludeți sursele nesigure sau irelevante:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What are the best JavaScript frameworks in 2026?",
tools=[{
"type": "web_search",
"excluded_domains": ["reddit.com", "quora.com"]
}]
)
Modelul va căuta pe întregul web, cu excepția domeniilor excluse.
Cazuri de utilizare pentru lista de blocare
- Excluderea forumurilor: evitați opiniile neverificate
- Excluderea agregatoarelor: evitați conținutul duplicat
- Excluderea concurenților: mențineți conținutul acestora în afara rezultatelor dumneavoastră
- Excluderea site-urilor cu paywall: evitați site-urile cu conținut inaccesibil
Sintaxa SDK
xAI SDK
tools=[client.tools.web_search(
allowed_domains=["arxiv.org", "nature.com"]
)]
OpenAI SDK
tools=[{
"type": "web_search",
"excluded_domains": ["reddit.com"]
}]
Vercel AI SDK
tools: [xai.tools.webSearch({
allowedDomains: ["arxiv.org", "nature.com"]
})]
Rețineți convenția camelCase (allowedDomains) în SDK-ul JavaScript.
Limite și bune practici
Limita de 5 domenii poate părea restrictivă. În practică, aceasta vă obligă să fiți selectivi în privința surselor, ceea ce îmbunătățește calitatea rezultatelor. Dacă aveți nevoie de mai multă flexibilitate, puteți executa mai multe cereri cu domenii diferite și să agregați rezultatele la nivelul clientului.
Atunci când utilizați allowed_domains, asigurați-vă că domeniile alese acoperă subiectul solicitat. Un domeniu prea restrictiv ar putea împiedica modelul să găsească informații relevante, ceea ce l-ar putea determina să răspundă fără date actualizate.
Puncte cheie
- Doi parametri disponibili:
allowed_domains(listă de permisiuni) șiexcluded_domains(listă de blocare) - Mutual exclusivi: nu îi puteți combina în aceeași cerere
- Maximum 5 domenii per parametru
- Lista de permisiuni este ideală pentru surse controlate și fiabile
- Lista de blocare funcționează pentru căutări largi cu câteva excluderi