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

Iffiltra skont l-Handles ta' X

Lezzjoni 9 / 16 Aġġornat 30 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Immira kontijiet speċifiċi fuq X
  2. Iż-żewġ parametri tal-iffiltrar
  3. L-użu ta’ allowed_x_handles (allowlist)
  4. L-użu ta’ excluded_x_handles (blocklist)
  5. Sintassi tas-SDK
  6. L-aħjar prattiki
  7. Punti Ewlenin

Immira kontijiet speċifiċi fuq X

Eżattament kif it-Tiftix fil-Web (Web Search) jippermettilek tiffltra skont id-dominji, it-Tiftix fuq X (X Search) jippermettilek tiffltra skont il-kontijiet (handles). Tista’ tirrestrinġi t-tfittxijiet għal posts minn sett speċifiku ta’ kontijiet, jew teskludi ċerti kontijiet mir-riżultati. Dan il-filtrar huwa essenzjali għal każijiet ta’ użu bħall-monitoraġġ, it-traċċar tal-marka, jew l-analiżi tal-influwencers.

Iż-żewġ parametri tal-iffiltrar

It-Tiftix fuq X joffri żewġ parametri għall-iffiltrar tal-handles:

  • allowed_x_handles: jillimita t-tiftix għal posts mill-kontijiet elenkati (allowlist)
  • excluded_x_handles: jeskludi posts mill-kontijiet elenkati (blocklist)

Bħat-Tiftix fil-Web, dawn il-parametri huma esklussivi reċiprokament. Ma tistax tużahom it-tnejn fl-istess talba.

Kull parametru jaċċetta array ta’ sa 10 handles (meta mqabbla ma’ 5 dominji għat-Tiftix fil-Web).

L-użu ta’ allowed_x_handles (allowlist)

Dan il-parametru huwa ideali għall-monitoraġġ tal-komunikazzjonijiet minn kontijiet speċifiċi:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What are the latest announcements from xAI?",
    tools=[{
        "type": "x_search",
        "allowed_x_handles": ["xaboratory", "xaboratorydev"]
    }]
)

Il-mudell ifittex biss posts ippubblikati minn dawn il-kontijiet.

Każijiet ta’ użu tal-Allowlist

  • Intelligence kompetittiva: immonitorja l-annunċji tal-kompetituri tiegħek
  • Monitoraġġ tal-marka: traċċa l-kontijiet uffiċjali tiegħek u dawk tal-ambaxxaturi tiegħek
  • Analiżi tal-influwencers: aggrega l-opinjonijiet minn panel ta’ esperti
  • Traċċar istituzzjonali: segwi kontijiet ta’ regolaturi jew organizzazzjonijiet uffiċjali

L-użu ta’ excluded_x_handles (blocklist)

Dan il-parametru jippermettilek teskludi ċerti kontijiet, bħal bots jew kontijiet mhux rilevanti:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What do developers think about the latest version of Python?",
    tools=[{
        "type": "x_search",
        "excluded_x_handles": ["bot_python_news", "spam_account"]
    }]
)

Każijiet ta’ użu tal-Blocklist

  • Eskludi l-bots: neħħi l-kontijiet awtomatizzati mir-riżultati
  • Eskludi l-ispam: iffiltra kontijiet magħrufa għal kontenut ta’ kwalità baxxa
  • Eskludi l-kontijiet tiegħek stess: analizza r-reazzjonijiet esterni mingħajr il-posts tiegħek stess

Sintassi tas-SDK

xAI SDK (Python)

from xai_sdk.tools import x_search

tools=[x_search(
    allowed_x_handles=["elonmusk", "xaboratory"]
)]

OpenAI SDK (Python)

tools=[{
    "type": "x_search",
    "allowed_x_handles": ["elonmusk", "xaboratory"]
}]

Vercel AI SDK (JavaScript)

tools: [xai.tools.xSearch({
  allowedXHandles: ["elonmusk", "xaboratory"]
})]

Innota l-konvenzjoni camelCase fl-SDK ta’ JavaScript: allowedXHandles minflok allowed_x_handles.

L-aħjar prattiki

L-għażla bejn allowlist u blocklist

Uża l-allowlist meta jkollok sett definit ta’ kontijiet u trid biss il-posts tagħhom. Din hija l-aktar metodu preċiż u effiċjenti fit-token.

Uża l-blocklist meta trid tfittxija wiesgħa iżda teħtieġ tnaddfa billi telimina sorsi magħrufa ta’ storbju.

Ottimizzazzjoni tan-numru ta’ handles

B’limitu ta’ 10 handles, kun selettiv. Jekk teħtieġ timmonitorja aktar minn 10-il kont, iggroupja t-talbiet tiegħek skont is-suġġett jew agħmel sejħiet multipli sekwenzzjali.

Format tal-handle

L-handles ma jinkludux is-simbolu @ (pereżempju, xaboratory). Ivvverifika li l-handles huma korretti—handle miktub ħażin sempliċiment ma jirritorna l-ebda riżultat għal dak il-kont.

Punti Ewlenin

  • Żewġ parametri: allowed_x_handles (allowlist) u excluded_x_handles (blocklist)
  • Esklużivi reċiprokament: wieħed biss kull darba għal kull talba
  • Massimu ta’ 10 handles għal kull parametru
  • L-handles jinkitbu mingħajr l-@: "elonmusk", mhux "@elonmusk"
  • Ideali għall-monitoraġġ, it-traċċar tal-marka, u l-analiżi tal-influwencers