Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Kuupäevafiltrid

Õppetund 10 / 16 Värskendatud 30. juuli 2026 Arendajatele
Sellel lehel
  1. Määra otsingu ajavahemik
  2. Kuupäevaparameetrid
  3. Kuupäevaformaat
  4. SDK süntaks
  5. Kombineeri kuupäevi ja kasutajanime
  6. Kasutusjuhud
  7. Parimad tavad
  8. Peamised punktid

Määra otsingu ajavahemik

X Search pakub funktsiooni, mida veebiotsingul pole: kuupäevafiltreid. Saad määrata kindla perioodi, et piirata tulemusi ainult selles ajavahemikus avaldatud postitustega. See on võimas tööriist trendianalüüsiks, sündmuste jälgimiseks ja sihipäraseks monitooringuks.

Kuupäevaparameetrid

Ajavahemikku kontrollivad kaks parameetrit:

  • from_date: otsingu alguskuupäev (kaasa arvatud)
  • to_date: otsingu lõppkuupäev (kaasa arvatud)

Mõlemad on valikulised ja sõltumatud. Saad kasutada neist kas üht või mõlemat:

  • Ainult from_date: kõik postitused alates sellest kuupäevast
  • Ainult to_date: kõik postitused kuni selle kuupäevani
  • Mõlemad koos: postitused määratud ajavahemikus

Kuupäevaformaat

Kuupäevad järgivad ISO 8601 formaati: YYYY-MM-DD (aasta-kuu-päev).

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"
    }]
)

See päring otsib ainult postitusi, mis avaldati märtsis 2026.

SDK süntaks

xAI SDK (Python)

Pythoni SDK aktsepteerib nii sõnesid kui ka datetime objekte:

from xai_sdk.tools import x_search
import datetime

# Kasutades sõnesid
tools=[x_search(
    from_date="2026-01-01",
    to_date="2026-04-01"
)]

# Kasutades datetime objekte
tools=[x_search(
    from_date=datetime.datetime(2026, 1, 1),
    to_date=datetime.datetime(2026, 4, 1)
)]

datetime objektide kasutamine on tootmises eelistatud, kuna see võimaldab kuupäevi dünaamiliselt arvutada (näiteks „viimased 7 päeva“).

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"
})]

camelCase konventsioon: fromDate ja toDate.

Kombineeri kuupäevi ja kasutajanime

Ajafiltrite kombineerimine kasutajanimede filtritega on eriti võimas:

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"
    }]
)

See päring ühendab kolm filtrit: ainult ametlike xAI kontode postitused ja ainult aprillis 2026.

Kasutusjuhud

Sündmuste analüüs

Jälgi reaktsioone reaalajas sündmuse ajal (konverents, tootelansseering, teadaanne):

# Reaktsioonid põhiettekande ajal
tools=[{
    "type": "x_search",
    "from_date": "2026-03-25",
    "to_date": "2026-03-26"
}]

Automatiseeritud nädalane monitooring

Loo automaatne monitooringuaruanne viimase nädala kohta:

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")
}]

Trendianalüüs

Võrdle arutelusid teema ümber erinevatel perioodidel, tehes mitu päringut erinevate ajavahemikega.

Parimad tavad

Kogemus näitab, et lühemad ajavahemikud toimivad paremini: ühe kuni seitsme päeva pikkune periood annab oluliselt täpsemaid tulemusi kui terve kuu, kus olulised postitused võivad suure hulga info sisse kaduda. Tootmises ära kunagi kodeeri neid kuupäevi kõvasti – arvuta need iga käivituse korral datetime abil. Vastasel juhul pärib sinu „7-päevane monitooring“ alati sama nädalat alates kasutuselevõtust. Lõpuks määrab ajavahemik ainult tulemuste hulga: viip määrab, mida nendega teha. Täpsusta, mida ootad – „trendide kokkuvõte“, „kõige suurema kaasatusega postitused“, „peamised teadaanded“ – ja mudel filtreerib tulemused vastavalt, selle asemel et tagastada kõik.

Peamised punktid

  • from_date ja to_date ISO 8601 formaadis (YYYY-MM-DD)
  • Mõlemad parameetrid on valikulised ja sõltumatud
  • Kombineeri kasutajanimede filtritega väga sihipäraste otsingute jaoks
  • Pythoni SDK aktsepteerib nii sõnesid kui ka datetime objekte
  • Ainult X Search – veebiotsing ei paku ajafiltreid