Filtrování podle data
Na této stránce
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_dateato_dateve 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