Dátumalapú szűrés
Ezen az oldalon
A keresési időablak meghatározása
Az X Search rendelkezik egy olyan funkcióval, amely a Web Searchből hiányzik: ez a dátumalapú szűrés. Megadhatsz egy konkrét időszakot, hogy az eredményeket csak az abban az időablakban közzétett bejegyzésekre korlátozd. Ez egy erőteljes eszköz trendelemzéshez, események nyomon követéséhez és célzott monitorozáshoz.
Dátumparaméterek
Két paraméter szabályozza az időablakot:
from_date: a keresés kezdődátuma (beleértve)to_date: a keresés záródátuma (beleértve)
Mindkettő opcionális és független egymástól. Használhatod őket külön-külön is:
- Csak
from_date: minden bejegyzés ettől a dátumtól kezdve - Csak
to_date: minden bejegyzés eddig a dátumig - Mindkettő együtt: a meghatározott időablakon belüli bejegyzések
Dátumformátum
A dátumok az ISO 8601 formátumot követik: YYYY-MM-DD (év-hónap-nap).
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"
}]
)
Ez a lekérdezés kizárólag a 2026. márciusban közzétett bejegyzéseket keresi.
SDK szintaxis
xAI SDK (Python)
A Python SDK elfogad sowohl karakterláncokat, mint datetime objektumokat:
from xai_sdk.tools import x_search
import datetime
# Karakterláncok használata
tools=[x_search(
from_date="2026-01-01",
to_date="2026-04-01"
)]
# datetime objektumok használata
tools=[x_search(
from_date=datetime.datetime(2026, 1, 1),
to_date=datetime.datetime(2026, 4, 1)
)]
A datetime objektumok használata éles környezetben előnyösebb, mert lehetővé teszi a dátumok dinamikus kiszámítását (például „az elmúlt 7 nap“).
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 konvenció: fromDate és toDate.
Dátumok és felhasználónevek kombinálása
Az időalapú szűrés felhasználónév-szűréssel való kombinálása különösen erőteljes:
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"
}]
)
Ez a lekérdezés három szűrőt kombinál: kizárólag a hivatalos xAI fiókok bejegyzései, és kizárólag 2026. áprilisból.
Felhasználási esetek
Eseményelemzés
Kövesd nyomon a reakciókat valós időben egy esemény során (konferencia, termékbevezetés, bejelentés):
# Reakciók egy keynote előadás alatt
tools=[{
"type": "x_search",
"from_date": "2026-03-25",
"to_date": "2026-03-26"
}]
Automatizált heti monitorozás
Készíts automatikus monitorozási jelentést az elmúlt hétről:
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")
}]
Trendelemzés
Hasonlítsd össze egy téma körüli beszélgetéseket különböző időszakokban több, eltérő időablakokkal rendelkező kérés elküldésével.
Legjobb gyakorlatok
A tapasztalatok azt mutatják, hogy a rövidebb időablakok működnek a legjobban: egy egy-hét napos időszak jelentősen pontosabb eredményeket ad, mint egy teljes hónap, ahol a fontos bejegyzések elvesznek a tömegben. Éles környezetben soha ne kódold be ezeket a dátumokat „keményen“ – minden futtatáskor számítsd ki őket a datetime segítségével. Ellenkező esetben a „7 napos monitorozásod“ ablaka a telepítés óta örökké ugyanazt a hetet kérdezi le. Végül pedig: az időablak csak az eredményhalmazt határozza meg; a prompt dönti el, hogy mi történjen vele. Add meg pontosan, mit vársz – „trendösszefoglaló“, „legtöbb interakciót kiváltó bejegyzések“, „főbb bejelentések“ –, és a modell ennek megfelelően szűri az eredményeket ahelyett, hogy mindent visszaadna.
Főbb megállapítások
- A
from_dateésto_dateparaméterek ISO 8601 formátumúak (YYYY-MM-DD) - Mindkét paraméter opcionális és független
- Kombináld felhasználónév-szűréssel a rendkívül célzott keresésekhez
- A Python SDK elfogad sowohl karakterláncokat, mint
datetimeobjektumokat - Kizárólag az X Search sajátja – a Web Search nem kínál időalapú szűrést