Iffiltrar tad-Dominji
F'din il-paġna
Ikkontrolla s-sorsi tat-tfittxija
B’mod predefinit, it-Tfittxija fuq il-Web tesplora l-web kollu. Dan jaħdem tajjeb għal mistoqsijiet ġenerali, iżda spiss jonqos għal każijiet ta’ użu professjonali fejn teħtieġ sorsi affidabbli u kkontrollati. L-iffiltrar tad-dominji jħallik tirrestrinġi jew teskludi siti speċifiċi.
Żewġ parametri esklużivi reċiprokament
It-Tfittxija fuq il-Web toffri żewġ parametri ta’ filtrar:
allowed_domains: jirrestrinġi t-tfittxija għad-dominji speċifikati (allowlist)excluded_domains: jeskludi dominji speċifiċi mir-riżultati (blocklist)
Dawn iż-żewġ parametri huma esklużivi reċiprokament. Ma tistax tużahom it-tnejn fl-istess talba. Jekk tipprova, l-API tirritorna żball.
Kull parametru jaċċetta array ta’ massimu ta’ 5 dominji.
Uża allowed_domains (allowlist)
Uża dan il-parametru meta tkun taf eżattament liema sorsi trid tikkonsulta. Pereżempju, għar-riċerka akkademika:
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"]
}]
)
Il-mudell ifittex biss f’dawn it-tliet dominji. Dan jiżgura li r-riżultati ġejjin minn sorsi xjentifiċi vverifikati.
Każijiet ta’ użu tal-Allowlist
- Riċerka akkademika: illimita għal arxiv.org, scholar.google.com, nature.com
- Dokumentazzjoni teknika: illimita għal siti uffiċjali tat-teknoloġija
- Intelliġenza kompetittiva: illimita għas-siti tal-kompetituri
- Konformità regolatorja: illimita għal sorsi governattivi jew regolatorji
Uża excluded_domains (blocklist)
Uża dan il-parametru meta trid tfittxija wiesgħa iżda teħtieġ teskludi sorsi mhux affidabbli jew mhux rilevanti:
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"]
}]
)
Il-mudell ifittex fil-web kollu ħlief għad-dominji esklużi.
Każijiet ta’ użu tal-Blocklist
- Eskludi forums: evva opinjonijiet mhux ivverifikati
- Eskludi aggregaturi: evva kontenut duplikat
- Eskludi kompetituri: żomm il-kontenut tagħhom barra mir-riżultati tiegħek
- Eskludi paywalls: evva siti b’kontenut inaċċessibbli
Sintassi tas-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"]
})]
Innota l-konvenzjoni camelCase (allowedDomains) fl-SDK ta’ JavaScript.
Limiti u l-aħjar prattiki
Il-limitu ta’ 5 dominji jista’ jidher restrittiv. Fil-prattika, dan jfurzak tkun selettiv dwar is-sorsi, li jtejjeb il-kwalità tar-riżultati. Jekk teħtieġ aktar flessibbiltà, tista’ tmexxi talbiet multipli b’dominji differenti u taggrega r-riżultati fuq in-naħa tal-klijent.
Meta tuża allowed_domains, żgura li d-dominji magħżula jkopru s-suġġett mitlub. Dominju li huwa wisq restrittiv jista’ jipprevjeni lill-mudell milli jsib informazzjoni rilevanti, li jista’ jwasslu biex iwieġeb mingħajr data aġġornata.
Punti Ewlenin
- Żewġ parametri disponibbli:
allowed_domains(allowlist) uexcluded_domains(blocklist) - Esklużivi reċiprokament: ma tistax tgħaqqadhom fl-istess talba
- Massimu ta’ 5 dominji għal kull parametru
- L-allowlist hija ideali għal sorsi kkontrollati u affidabbli
- Il-blocklist taħdem għal tfittxijiet wiesgħa b’ftit esklużjonijiet