Iffiltra skont l-Handles ta' X
F'din il-paġna
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) uexcluded_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