Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Iffiltrar tad-Dominji

Lezzjoni 5 / 16 Aġġornat 30 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Ikkontrolla s-sorsi tat-tfittxija
  2. Żewġ parametri esklużivi reċiprokament
  3. Uża allowed_domains (allowlist)
  4. Uża excluded_domains (blocklist)
  5. Sintassi tas-SDK
  6. Limiti u l-aħjar prattiki
  7. Punti Ewlenin

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) u excluded_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