Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Filtrování podle data

Lekce 10 z 16 Aktualizováno 30. července 2026 Vývojář
Na této stránce
  1. Definice časového okna vyhledávání
  2. Parametry data
  3. Formát data
  4. Syntaxe SDK
  5. Kombinace dat a handleů
  6. Případy použití
  7. Doporučené postupy
  8. Klíčové poznatky

Definice časového okna vyhledávání

X Search nabízí funkci, kterou Web Search nemá: filtrování podle data. Můžeš definovat konkrétní období, čímž omezíš výsledky pouze na příspěvky zveřejněné v tomto časovém úseku. Je to mocný nástroj pro analýzu trendů, sledování událostí a cílený monitoring.

Parametry data

Časové okno řídí dva parametry:

  • from_date: počáteční datum vyhledávání (včetně)
  • to_date: koncové datum vyhledávání (včetně)

Oba parametry jsou volitelné a nezávislé. Můžeš použít jeden bez druhého:

  • pouze from_date: všechny příspěvky od tohoto data
  • pouze to_date: všechny příspěvky do tohoto data
  • oba dohromady: příspěvky v rámci definovaného okna

Formát data

Data musí být ve formátu ISO 8601: YYYY-MM-DD (rok-měsíc-den).

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 dotaz vyhledá pouze příspěvky zveřejněné v březnu 2026.

Syntaxe SDK

xAI SDK (Python)

Python SDK přijímá řetězce i objekty datetime:

from xai_sdk.tools import x_search
import datetime

# Použití řetězců
tools=[x_search(
    from_date="2026-01-01",
    to_date="2026-04-01"
)]

# Použití objektů datetime
tools=[x_search(
    from_date=datetime.datetime(2026, 1, 1),
    to_date=datetime.datetime(2026, 4, 1)
)]

Používání objektů datetime je v produkčním prostředí preferováno, protože umožňuje dynamický výpočet dat (napří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"
})]

Konvence camelCase: fromDate a toDate.

Kombinace dat a handleů

Kombinace filtrování podle času s filtrováním podle handleů je obzvláště úč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 dotaz kombinuje tři filtry: pouze příspěvky od oficiálních účtů xAI a pouze z dubna 2026.

Případy použití

Analýza událostí

Sleduj reakce v reálném čase během události (konference, uvedení produktu, oznámení):

# Reakce během keynote
tools=[{
    "type": "x_search",
    "from_date": "2026-03-25",
    "to_date": "2026-03-26"
}]

Automatizovaný týdenní monitoring

Vytvoř automatickou zprávu o monitoringu za uplynulý týden:

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 trendů

Porovnej diskuse kolem daného tématu v různých obdobích provedením více požadavků s odlišnými časovými okny.

Doporučené postupy

Zkušenosti ukazují, že kratší okna fungují nejlépe: období jednoho až sedmi dnů přináší výrazně přesnější výsledky než celý měsíc, kde se důležité příspěvky ztratí v množství dat. V produkčním prostředí nikdy tato data nehardcoduj – při každém spuštění je vypočítej pomocí datetime. Jinak bude tvé okno „7denního monitoringu“ od nasazení navždy dotazovat stejný týden. Nakonec pamatuj, že časové okno pouze definuje sadu výsledků: to, co se s nimi má dít, určuje prompt. Upřesni, co očekáváš – „shrnutí trendů“, „příspěvky s největší angažovaností“, „hlavní oznámení“ – a model výsledky odpovídajícím způsobem vyfiltruje, místo aby vracel vše.

Klíčové poznatky

  • from_date a to_date ve formátu ISO 8601 (YYYY-MM-DD)
  • Obě parametry jsou volitelné a nezávislé
  • Kombinuj s filtrováním podle handleů pro vysoce cílená vyhledávání
  • Python SDK přijímá řetězce i objekty datetime
  • Exkluzivita X Search – Web Search nenabízí filtrování podle času