Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Dátumalapú szűrés

10. lecke 16 közül Frissítve 2026. július 30. Fejlesztő
Ezen az oldalon
  1. A keresési időablak meghatározása
  2. Dátumparaméterek
  3. Dátumformátum
  4. SDK szintaxis
  5. Dátumok és felhasználónevek kombinálása
  6. Felhasználási esetek
  7. Legjobb gyakorlatok
  8. Főbb megállapítások

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 és to_date paramé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 datetime objektumokat
  • Kizárólag az X Search sajátja – a Web Search nem kínál időalapú szűrést