Filtreeri X-is kasutajatunnuste ja kuupäevade järgi
Sellel lehel
Suuna oma X-i otsinguid täpselt
X-i otsing pakub reaalset väärtust alles siis, kui oled selle filtreerimisparameetrid selgeks õppinud. Toore postituste voogu tõmbamise asemel saad suunata otsingu konkreetsetele kontodele, määrata täpseid ajavahemikke ja välistada müraallikaid. Need filtrid muudavad üldotstarbelise otsingutööriista täpseks seireinstrumendiks.
Filtreerimine kasutajatunnuste järgi: allowed_x_handles ja excluded_x_handles
Jälgi konkreetseid kontosid
Parameeter allowed_x_handles piirab otsingu ainult nende kontode postitustega, mida loetled. Saad sihtida korraga kuni 10 kasutajatunnust:
response = client.responses.create(
model="grok-4.5",
input="Summary of recent announcements from these tech accounts",
tools=[{
"type": "x_search",
"allowed_x_handles": [
"elonmusk",
"sama",
"demishassabis",
"ylecun"
]
}]
)
Välista müra tekitavad kontod
Parameeter excluded_x_handles toimib vastupidiselt. See lubab kõik kontod välja arvatud need, mida määrad. Kasulik bottide või ebaolulise sisuga kontode elimineerimiseks:
response = client.responses.create(
model="grok-4.5",
input="Serious discussions on AI regulation",
tools=[{
"type": "x_search",
"excluded_x_handles": ["bot_spam_1", "compte_parodie"]
}]
)
Vastastikuse välistavuse reegel
Nagu veebidomeenide puhul, on ka allowed_x_handles ja excluded_x_handles vastastikku välistavad. Sa ei saa neid ühes päringus kombineerida. Piirang on 10 kasutajatunnust parameetri kohta, mis on kaks korda suurem kui veebidomeenide puhul.
Filtreerimine kuupäevade järgi: from_date ja to_date
Ajaparameetrid võimaldavad määrata täpse otsinguakna ISO 8601 formaadis (AAAA-KK-PP):
response = client.responses.create(
model="grok-4.5",
input="Reactions to the Grok 4.5 announcement",
tools=[{
"type": "x_search",
"from_date": "2026-03-01",
"to_date": "2026-03-15"
}]
)
Need filtrid on eriti kasulikud:
- Sündmuse mõju analüüsimiseks: määra periood ümber sündmuse
- Enne/järgse meeleolu võrdlemiseks: käivita kaks päringut erinevate akendega
- Vana müra vältimiseks: keskendu hiljutistele aruteludele
Kasutamine koos Pythoni SDK-ga
xAI SDK aktsepteerib lisaks ISO-stringidele ka Pythoni datetime objekte:
from xai_sdk.tools import x_search
from datetime import datetime
response = client.chat.create(
model="grok-4.5",
tools=[x_search(
from_date=datetime(2026, 3, 1),
to_date=datetime(2026, 3, 31)
)]
)
camelCase konventsioon JavaScriptis
Vercel AI SDK kasutab parameetrite nimede jaoks camelCase konventsiooni:
tools: [xai.tools.xSearch({
allowedXHandles: ["elonmusk"],
fromDate: "2026-03-01",
toDate: "2026-03-31"
})]
Filtrite kombineerimine
Saad kombineerida kasutajatunnuseid ja kuupäevi ühes päringus maksimaalse täpsuse saavutamiseks:
response = client.responses.create(
model="grok-4.5",
input="What did Sam Altman say about GPT-5 in March 2026?",
tools=[{
"type": "x_search",
"allowed_x_handles": ["sama"],
"from_date": "2026-03-01",
"to_date": "2026-03-31"
}]
)
Loo dünaamiline seiresüsteem
Kombineerides neid filtreid programmeeritavalt, saad luua konfigureeritava seiretööriista:
def create_x_monitor(handles, days_back=7):
from datetime import datetime, timedelta
today = datetime.now()
start = (today - timedelta(days=days_back)).strftime("%Y-%m-%d")
return {
"type": "x_search",
"allowed_x_handles": handles,
"from_date": start,
"to_date": today.strftime("%Y-%m-%d")
}
# Jälgi AI liidreid nädala jooksul
tool = create_x_monitor(
handles=["sama", "demishassabis", "ylecun"],
days_back=7
)
Harjutus
Seadista sihitatud X-i otsing 3–5 mõjukale kontole oma valdkonnas. Määra ühenädalane ajavahemik ja võrdle tulemusi otsinguga, kus kasutajatunnuste filtreid ei kasutata. Mõõda asjakohasuse erinevust.
Peamised punktid
allowed_x_handlesjaexcluded_x_handlesfiltreerivad konto järgi (maksimaalselt 10 mõlemat)- Mõlemad kasutajatunnuste parameetrid on vastastikku välistavad
from_datejato_datemääratlevad ajavahemiku formaadisAAAA-KK-PP- Kuupäevi saab kombineerida kasutajatunnuste filtritega
- Pythoni SDK aktsepteerib
datetimeobjekte, JavaScripti SDK kasutab camelCase’i - Need filtrid muudavad X-i otsingu üldotstarbelisest tööriistast sihitatud seireinstrumendiks