Kuupäevafiltrid
Sellel lehel
Määra otsingu ajavahemik
X Search pakub funktsiooni, mida veebiotsingul pole: kuupäevafiltreid. Saad määrata kindla perioodi, et piirata tulemusi ainult selles ajavahemikus avaldatud postitustega. See on võimas tööriist trendianalüüsiks, sündmuste jälgimiseks ja sihipäraseks monitooringuks.
Kuupäevaparameetrid
Ajavahemikku kontrollivad kaks parameetrit:
from_date: otsingu alguskuupäev (kaasa arvatud)to_date: otsingu lõppkuupäev (kaasa arvatud)
Mõlemad on valikulised ja sõltumatud. Saad kasutada neist kas üht või mõlemat:
- Ainult
from_date: kõik postitused alates sellest kuupäevast - Ainult
to_date: kõik postitused kuni selle kuupäevani - Mõlemad koos: postitused määratud ajavahemikus
Kuupäevaformaat
Kuupäevad järgivad ISO 8601 formaati: YYYY-MM-DD (aasta-kuu-päev).
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What were the reactions to the Grok 4 launch?",
tools=[{
"type": "x_search",
"from_date": "2026-03-01",
"to_date": "2026-03-31"
}]
)
See päring otsib ainult postitusi, mis avaldati märtsis 2026.
SDK süntaks
xAI SDK (Python)
Pythoni SDK aktsepteerib nii sõnesid kui ka datetime objekte:
from xai_sdk.tools import x_search
import datetime
# Kasutades sõnesid
tools=[x_search(
from_date="2026-01-01",
to_date="2026-04-01"
)]
# Kasutades datetime objekte
tools=[x_search(
from_date=datetime.datetime(2026, 1, 1),
to_date=datetime.datetime(2026, 4, 1)
)]
datetime objektide kasutamine on tootmises eelistatud, kuna see võimaldab kuupäevi dünaamiliselt arvutada (näiteks „viimased 7 päeva“).
OpenAI SDK (Python)
tools=[{
"type": "x_search",
"from_date": "2026-01-01",
"to_date": "2026-04-01"
}]
Vercel AI SDK (JavaScript)
tools: [xai.tools.xSearch({
fromDate: "2026-01-01",
toDate: "2026-04-01"
})]
camelCase konventsioon: fromDate ja toDate.
Kombineeri kuupäevi ja kasutajanime
Ajafiltrite kombineerimine kasutajanimede filtritega on eriti võimas:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Summarize xAI's announcements this month",
tools=[{
"type": "x_search",
"allowed_x_handles": ["xaboratory", "xaboratorydev"],
"from_date": "2026-04-01",
"to_date": "2026-04-30"
}]
)
See päring ühendab kolm filtrit: ainult ametlike xAI kontode postitused ja ainult aprillis 2026.
Kasutusjuhud
Sündmuste analüüs
Jälgi reaktsioone reaalajas sündmuse ajal (konverents, tootelansseering, teadaanne):
# Reaktsioonid põhiettekande ajal
tools=[{
"type": "x_search",
"from_date": "2026-03-25",
"to_date": "2026-03-26"
}]
Automatiseeritud nädalane monitooring
Loo automaatne monitooringuaruanne viimase nädala kohta:
from datetime import datetime, timedelta
today = datetime.now()
week_ago = today - timedelta(days=7)
tools=[{
"type": "x_search",
"from_date": week_ago.strftime("%Y-%m-%d"),
"to_date": today.strftime("%Y-%m-%d")
}]
Trendianalüüs
Võrdle arutelusid teema ümber erinevatel perioodidel, tehes mitu päringut erinevate ajavahemikega.
Parimad tavad
Kogemus näitab, et lühemad ajavahemikud toimivad paremini: ühe kuni seitsme päeva pikkune periood annab oluliselt täpsemaid tulemusi kui terve kuu, kus olulised postitused võivad suure hulga info sisse kaduda. Tootmises ära kunagi kodeeri neid kuupäevi kõvasti – arvuta need iga käivituse korral datetime abil. Vastasel juhul pärib sinu „7-päevane monitooring“ alati sama nädalat alates kasutuselevõtust. Lõpuks määrab ajavahemik ainult tulemuste hulga: viip määrab, mida nendega teha. Täpsusta, mida ootad – „trendide kokkuvõte“, „kõige suurema kaasatusega postitused“, „peamised teadaanded“ – ja mudel filtreerib tulemused vastavalt, selle asemel et tagastada kõik.
Peamised punktid
from_datejato_dateISO 8601 formaadis (YYYY-MM-DD)- Mõlemad parameetrid on valikulised ja sõltumatud
- Kombineeri kasutajanimede filtritega väga sihipäraste otsingute jaoks
- Pythoni SDK aktsepteerib nii sõnesid kui ka
datetimeobjekte - Ainult X Search – veebiotsing ei paku ajafiltreid