Filtravimas pagal datą
Šiame puslapyje
Apibrėžk paieškos laiko langą
„X Search“ siūlo funkciją, kurios neturi „Web Search“: filtravimą pagal datą. Gali apibrėžti konkretų laikotarpį, kad rezultatuose būtų tik tuose laiku paskelbti įrašai. Tai galingas įrankis tendencijų analizei, įvykių stebėjimui ir tiksliniam monitoringui.
Datos parametrai
Laiko langą valdo du parametrai:
from_date: paieškos pradžios data (imtinai)to_date: paieškos pabaigos data (imtinai)
Abu yra neprivalomi ir nepriklausomi. Gali naudoti vieną be kito:
- Tik
from_date: visi įrašai nuo šios datos - Tik
to_date: visi įrašai iki šios datos - Abu kartu: įrašai apibrėžtame lange
Datos formatas
Datos turi atitikti ISO 8601 formatą: YYYY-MM-DD (metai-mėnuo-diena).
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"
}]
)
Ši užklausa ieško tik įrašų, paskelbtų 2026 m. kovą.
SDK sintaksė
xAI SDK (Python)
Python SDK priima ir eilutes, ir datetime objektus:
from xai_sdk.tools import x_search
import datetime
# Naudojant eilutes
tools=[x_search(
from_date="2026-01-01",
to_date="2026-04-01"
)]
# Naudojant datetime objektus
tools=[x_search(
from_date=datetime.datetime(2026, 1, 1),
to_date=datetime.datetime(2026, 4, 1)
)]
Gaminiuose („production“) rekomenduojama naudoti datetime objektus, nes tai leidžia dinamiškai skaičiuoti datas (pavyzdžiui, „paskutinės 7 dienos“).
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"
})]
Taikoma camelCase konvencija: fromDate ir toDate.
Derink datas ir paskyras
Laiko filtravimo derinimas su paskyrų filtravimu yra ypač veiksmingas:
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"
}]
)
Ši užklausa sujungia tris filtrus: tik oficialių „xAI“ paskyrų įrašai ir tik 2026 m. balandžio mėnesį.
Naudojimo atvejai
Įvykių analizė
Stebėk reakcijas realiuoju laiku vykstant įvykiui (konferencija, produkto pristatymas, pranešimas):
# Reakcijos pagrindinio pranešimo metu
tools=[{
"type": "x_search",
"from_date": "2026-03-25",
"to_date": "2026-03-26"
}]
Automatinis savaitinis monitoringas
Sukurk automatinę ataskaitą apie praėjusią savaitę:
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")
}]
Tendencijų analizė
Palygink diskusijas apie temą skirtingais laikotarpiais, siųsdamas kelias užklausas su skirtingais laiko langais.
Geriausios praktikos
Patirtis rodo, kad trumpesni langai veikia geriau: vienos–septynių dienų laikotarpis duoda žymiai tikslesnių rezultatų nei visas mėnuo, kai svarbūs įrašai pasimeta informacijos gausoje. Gaminiuose niekada nekoduok šių datų „kietai“ – kiekvieno vykdymo metu apskaičiuok jas naudodamas datetime. Priešingu atveju tavo „7 dienų monitoringo“ langas nuo diegimo momento amžinai užklausinės tą pačią savaitę. Galiausiai, laiko langas tik apibrėžia rezultatų aibę: tai, ką su jais daryti, nurodo užklausa („prompt“). Nurodyk, ko tikiesi – „tendencijų santrauka“, „daugiausia įsitraukimo sulaukę įrašai“, „svarbiausi pranešimai“ – ir modelis atitinkamai atrinks rezultatus, užuot grąžinęs viską iš eilės.
Svarbiausi punktai
from_dateirto_dateISO 8601 formatu (YYYY-MM-DD)- Abu parametrai yra neprivalomi ir nepriklausomi
- Derink su paskyrų filtravimu, kad gautum itin tikslines paieškas
- Python SDK priima ir eilutes, ir
datetimeobjektus - Tai „X Search“ išskirtinumas – „Web Search“ laiko filtravimo nesiūlo