Filtreerimine X-i kontode järgi
Sellel lehel
Sihti konkreetseid kontosid X-is
Nagu veebiotsing võimaldab filtreerida domeenide järgi, võimaldab X-i otsing filtreerida kontode (kasutajanimede) järgi. Saad piirata otsinguid postitustega kindlatest kontodest või jätta teatud kontod tulemustest välja. See filtreerimine on hädavajalik selliste kasutusjuhtude puhul nagu seire, brändi jälgimine või mõjutajate analüüs.
Kaks filtreerimisparameetrit
X-i otsing pakub kahte kasutajanime filtreerimise parameetrit:
allowed_x_handles: piirab otsingu loetletud kontode postitustega (lubatud nimekiri)excluded_x_handles: jätab loetletud kontode postitused tulemustest välja (keelatud nimekiri)
Nagu veebiotsingu puhul, on need parameetrid vastastikku välistavad. Sa ei saa mõlemat samas päringus kasutada.
Iga parameeter aktsepteerib kuni 10 kasutajanime sisaldavat massiivi (võrreldes veebiotsingu 5 domeeniga).
allowed_x_handles kasutamine (lubatud nimekiri)
See parameeter on ideaalne konkreetsete kontode kommunikatsiooni jälgimiseks:
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"]
}]
)
Mudel otsib ainult nende kontode avaldatud postitusi.
Lubatud nimekirja kasutusjuhud
- Konkurendi luure: jälgi oma konkurentide teateid
- Brändi seire: jälgi oma ametlikke kontosid ja oma saadikute kontosid
- Mõjutajate analüüs: kogu arvamused ekspertide paneelilt
- Institutsionaalne jälgimine: jälgi regulaatorite või ametlike organisatsioonide kontosid
excluded_x_handles kasutamine (keelatud nimekiri)
See parameeter võimaldab jätta teatud kontod, nagu botid või ebaolulised kontod, tulemustest välja:
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"]
}]
)
Keelatud nimekirja kasutusjuhud
- Botide välistamine: eemalda automatiseeritud kontod tulemustest
- Rämpsu välistamine: filtreeri välja madala kvaliteediga sisu tuntud kontod
- Oma kontode välistamine: analüüsi väliseid reaktsioone ilma oma postitusteta
SDK süntaks
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"]
})]
Pane tähele JavaScripti SDK camelCase konventsiooni: allowedXHandles asemel allowed_x_handles.
Parimad tavad
Valik lubatud ja keelatud nimekirja vahel
Kasuta lubatud nimekirja, kui sul on määratletud kontode hulk ja soovid ainult nende postitusi. See on kõige täpsem ja tokenite seisukohalt tõhusam meetod.
Kasuta keelatud nimekirja, kui soovid laiaulatuslikku otsingut, kuid pead seda puhastama, eemaldades teadaolevad müraallikad.
Kasutajanimede arvu optimeerimine
Piiranguga 10 kasutajanimele ole valiv. Kui pead jälgima rohkem kui 10 kontot, grupeeri oma päringud teemade kaupa või tee mitu järjestikust väljakutset.
Kasutajanime formaat
Kasutajanimed ei sisalda sümbolit @ (näiteks xaboratory). Veendu, et kasutajanimed on õiged – valesti kirjutatud kasutajanimi lihtsalt ei too selle konto jaoks tulemusi.
Peamised punktid
- Kaks parameetrit:
allowed_x_handles(lubatud nimekiri) jaexcluded_x_handles(keelatud nimekiri) - Vastastikku välistavad: korraga ainult üks päringu kohta
- Maksimaalselt 10 kasutajanime parameetri kohta
- Kasutajanimed kirjutatakse ilma sümbolita
@:”elonmusk”, mitte”@elonmusk”` - Ideaalne seireks, brändi jälgimiseks ja mõjutajate analüüsiks