Filtrovanie podľa dátumu
Na tejto strane
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_dateato_datevo 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