Filtravimas pagal X paskyras
Šiame puslapyje
Tikslinės paskyros X platformoje
Tiek, kiek „Web Search“ leidžia filtruoti pagal domenų vardus, „X Search“ leidžia filtruoti pagal paskyras (naudotojo vardus). Gali apriboti paiešką tik tam tikrų paskyrų įrašais arba pašalinti konkrečias paskyras iš rezultatų. Šis filtravimas yra būtinas tokiems atvejams kaip stebėsena, prekės ženklo sekimas ar įtakos darytojų analizė.
Du filtravimo parametrai
„X Search“ siūlo du naudotojo vardų filtravimo parametrus:
allowed_x_handles: apriboja paiešką tik nurodytų paskyrų įrašais (leidimų sąrašas)excluded_x_handles: pašalina nurodytų paskyrų įrašus (blokavimo sąrašas)
Kaip ir „Web Search“ atveju, šie parametrai yra nesuderinami. Toje pačioje užklausoje negali naudoti abiejų vienu metu.
Kiekvienas parametras priima masyvą iš iki 10 naudotojo vardų (palyginti su 5 domenais „Web Search“ funkcijoje).
allowed_x_handles naudojimas (leidimų sąrašas)
Šis parametras idealiai tinka stebėti konkrečių paskyrų komunikaciją:
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"]
}]
)
Modelis ieškos tik tų įrašų, kuriuos paskelbė šios paskyros.
Leidimų sąrašo naudojimo atvejai
- Konkurentų žvalgyba: stebėk konkurentų pranešimus
- Prekės ženklo stebėsena: sek savo oficialias paskyras ir ambasadorių paskyras
- Įtakos darytojų analizė: apibendrink ekspertų grupės nuomones
- Institucinis stebėjimas: sek reguliavimo institucijų ar oficialių organizacijų paskyras
excluded_x_handles naudojimas (blokavimo sąrašas)
Šis parametras leidžia pašalinti tam tikras paskyras, pavyzdžiui, botus ar nereikšmingas paskyras:
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"]
}]
)
Blokavimo sąrašo naudojimo atvejai
- Botų šalinimas: pašalink automatizuotas paskyras iš rezultatų
- Šlamšto filtravimas: atmest paskyras, žinomas dėl žemos kokybės turinio
- Savo paskyrų šalinimas: analizuok išorines reakcijas neįtraukdamas savo įrašų
SDK sintaksė
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"]
})]
Atkreipk dėmesį į „camelCase“ konvenciją JavaScript SDK: naudojama allowedXHandles, o ne allowed_x_handles.
Geriausios praktikos
Pasirinkimas tarp leidimų ir blokavimo sąrašų
Naudok leidimų sąrašą, kai turi apibrėžtą paskyrų rinkinį ir nori matyti tik jų įrašus. Tai tiksliausias ir žetonų atžvilgiu efektyviausias būdas.
Naudok blokavimo sąrašą, kai nori atlikti plačią paiešką, bet reikia ją išgryninti pašalinant žinomus triukšmo šaltinius.
Naudotojo vardų skaičiaus optimizavimas
Esant 10 vardų limitui, būk atrankus. Jei reikia stebėti daugiau nei 10 paskyrų, sugrupuok užklausas pagal temą arba atlik kelias nuoseklias užklausas.
Naudotojo vardo formatas
Naudotojo varduose nėra simbolio @ (pavyzdžiui, xaboratory). Patikrink, ar naudotojo vardai yra teisingi – neteisingai parašytas vardas tiesiog negrąžins jokių tos paskyros rezultatų.
Svarbiausi punktai
- Du parametrai:
allowed_x_handles(leidimų sąrašas) irexcluded_x_handles(blokavimo sąrašas) - Nesuderinami: vienu metu galima naudoti tik vieną parametras užklausai
- Maksimaliai 10 naudotojo vardų vienam parametrui
- Naudotojo vardai rašomi be simbolio
@:"elonmusk", o ne"@elonmusk" - Idealu stebėsenai, prekės ženklo sekimui ir įtakos darytojų analizei