Filtrarea după dată
Pe această pagină
Definirea ferestrei de timp pentru căutare
X Search oferă o funcționalitate pe care Web Search nu o are: filtrarea după dată. Puteți defini o perioadă specifică pentru a limita rezultatele la postările publicate în acea fereastră de timp. Acesta este un instrument puternic pentru analiza tendințelor, urmărirea evenimentelor și monitorizarea țintită.
Parametri de dată
Doi parametri controlează fereastra de timp:
from_date: data de început a căutării (inclusiv)to_date: data de sfârșit a căutării (inclusiv)
Ambii sunt opționali și independenți. Puteți utiliza unul fără celălalt:
- Doar
from_date: toate postările începând cu această dată - Doar
to_date: toate postările până la această dată - Ambii împreună: postările din fereastra definită
Formatul datei
Datele respectă formatul ISO 8601: YYYY-MM-DD (an-lună-zi).
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"
}]
)
Această interogare caută doar postările publicate în martie 2026.
Sintaxa SDK
xAI SDK (Python)
SDK-ul Python acceptă atât șiruri de caractere, cât și obiecte datetime:
from xai_sdk.tools import x_search
import datetime
# Utilizarea șirurilor de caractere
tools=[x_search(
from_date="2026-01-01",
to_date="2026-04-01"
)]
# Utilizarea obiectelor datetime
tools=[x_search(
from_date=datetime.datetime(2026, 1, 1),
to_date=datetime.datetime(2026, 4, 1)
)]
Utilizarea obiectelor datetime este preferată în producție, deoarece vă permite să calculați datele dinamic (de exemplu, „ultimele 7 zile“).
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"
})]
Convenție camelCase: fromDate și toDate.
Combinarea datelor cu handle-urile
Combinarea filtrării temporale cu filtrarea după handle este deosebit de puternică:
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"
}]
)
Această interogare combină trei filtre: doar postările de la conturile oficiale xAI, doar din aprilie 2026.
Cazuri de utilizare
Analiza evenimentelor
Urmăriți reacțiile în timp real în timpul unui eveniment (conferință, lansare de produs, anunț):
# Reacții în timpul unei prezentări principale
tools=[{
"type": "x_search",
"from_date": "2026-03-25",
"to_date": "2026-03-26"
}]
Monitorizare săptămânală automatizată
Creați un raport de monitorizare automat pentru săptămâna trecută:
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")
}]
Analiza tendințelor
Comparați discuțiile despre un subiect în diferite perioade făcând mai multe cereri cu ferestre de timp distincte.
Cele mai bune practici
Experiența arată că ferestrele mai scurte funcționează cel mai bine: o perioadă de una până la șapte zile oferă rezultate semnificativ mai precise decât o lună întreagă, unde postările importante se pierd în volum. În producție, nu introduceți niciodată aceste date direct în cod (hardcode); calculați-le cu datetime la fiecare execuție. În caz contrar, fereastra dumneavoastră de „monitorizare pe 7 zile“ va interoga aceeași săptămână la infinit de la momentul implementării. În final, fereastra de timp definește doar setul de rezultate: promptul dictează ce să faceți cu acesta. Specificați ce așteptați – „rezumat al tendințelor“, „postările cu cea mai mare implicare“, „anunțuri majore“ – iar modelul va filtra rezultatele în consecință, în loc să le returneze pe toate.
Puncte cheie
from_dateșito_dateîn format ISO 8601 (YYYY-MM-DD)- Ambii parametri sunt opționali și independenți
- Combinați cu filtrarea după handle pentru căutări extrem de țintite
- SDK-ul Python acceptă atât șiruri de caractere, cât și obiecte
datetime - Exclusiv X Search – Web Search nu oferă filtrare temporală