Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Filtrovanie podľa dátumu

Lekcia 10 z 16 Aktualizované 30. júla 2026 Vývojár
Na tejto strane
  1. Definovanie časového okna vyhľadávania
  2. Parametre dátumu
  3. Formát dátumu
  4. Syntax SDK
  5. Kombinovanie dátumov a používateľských mien
  6. Prípady použitia
  7. Osvedčené postupy
  8. Kľúčové poznatky

Definovanie časového okna vyhľadávania

X Search ponúka funkciu, ktorú Web Search nemá: filtrovanie podľa dátumu. Môžeš definovať konkrétne obdobie, aby si obmedzil výsledky len na príspevky uverejnené v tomto časovom okne. Je to výkonný nástroj na analýzu trendov, sledovanie udalostí a cielený monitoring.

Parametre dátumu

Časové okno riadia dva parametre:

  • from_date: počiatočný dátum vyhľadávania (vrátane)
  • to_date: koncový dátum vyhľadávania (vrátane)

Oba parametre sú voliteľné a nezávislé. Môžeš použiť jeden bez druhého:

  • len from_date: všetky príspevky od tohto dátumu
  • len to_date: všetky príspevky až do tohto dátumu
  • oba spolu: príspevky v rámci definovaného okna

Formát dátumu

Dátumy musia byť vo formáte ISO 8601: YYYY-MM-DD (rok-mesiac-deň).

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"
    }]
)

Tento dopyt vyhľadáva iba príspevky uverejnené v marci 2026.

Syntax SDK

xAI SDK (Python)

Python SDK akceptuje reťazce aj objekty datetime:

from xai_sdk.tools import x_search
import datetime

# Použitie reťazcov
tools=[x_search(
    from_date="2026-01-01",
    to_date="2026-04-01"
)]

# Použitie objektov datetime
tools=[x_search(
    from_date=datetime.datetime(2026, 1, 1),
    to_date=datetime.datetime(2026, 4, 1)
)]

Používanie objektov datetime sa v produkčnom prostredí odporúča, pretože umožňuje dynamický výpočet dátumov (napríklad „posledných 7 dní“).

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"
})]

Konvencia camelCase: fromDate a toDate.

Kombinovanie dátumov a používateľských mien

Kombinácia časového filtrovania s filtrovaním podľa používateľských mien (handles) je mimoriadne účinná:

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"
    }]
)

Tento dopyt kombinuje tri filtre: iba príspevky od oficiálnych účtov xAI a iba z apríla 2026.

Prípady použitia

Analýza udalostí

Sleduj reakcie v reálnom čase počas udalosti (konferencia, uvedenie produktu, oznámenie):

# Reakcie počas keynote prezentácie
tools=[{
    "type": "x_search",
    "from_date": "2026-03-25",
    "to_date": "2026-03-26"
}]

Automatizovaný týždenný monitoring

Vytvor automatickú správu o monitoringu za uplynulý týždeň:

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")
}]

Analýza trendov

Porovnávaj diskusie okolo témy v rôznych obdobiach vytvorením viacerých požiadaviek s odlišnými časovými oknami.

Osvedčené postupy

Skúsenosti ukazujú, že kratšie okná fungujú najlepšie: obdobie jedného až siedmich dní prináša výrazne presnejšie výsledky ako celý mesiac, kde sa dôležité príspevky stratia v množstve údajov. V produkčnom prostredí nikdy tieto dátumy nepoužívaj natvrdo (hardcode) – pri každom spustení ich vypočítaj pomocou datetime. Inak bude tvoje okno „7-dňového monitoringu“ navždy dotazovať ten istý týždeň od momentu nasadenia. Nakoniec, časové okno iba definuje množinu výsledkov: to, čo sa s nimi má robiť, určuje prompt. Špecifikuj, čo očakávaš – „zhrnutie trendov“, „príspevky s najväčšou odozvou“, „hlavné oznámenia“ – a model výsledky podľa toho prefiltruje, namiesto toho, aby vrátil všetko.

Kľúčové poznatky

  • from_date a to_date vo formáte ISO 8601 (YYYY-MM-DD)
  • Obidva parametre sú voliteľné a nezávislé
  • Kombinuj s filtrovaním podľa používateľských mien pre vysoko cielené vyhľadávania
  • Python SDK akceptuje reťazce aj objekty datetime
  • Exkluzivita X Search – Web Search neponúka časové filtrovanie