Salt la conținutul principal
Română— Alege o limbă
Meniu

Filtrarea după dată

Lecția 10 din 16 Actualizată 30 iulie 2026 Dezvoltator
Pe această pagină
  1. Definirea ferestrei de timp pentru căutare
  2. Parametri de dată
  3. Formatul datei
  4. Sintaxa SDK
  5. Combinarea datelor cu handle-urile
  6. Cazuri de utilizare
  7. Cele mai bune practici
  8. Puncte cheie

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 și to_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ă