Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Filtravimas pagal datą

Paskaita 10 iš 16 Atnaujinta 2026 m. liepos 30 d. Kūrėjas
Šiame puslapyje
  1. Apibrėžk paieškos laiko langą
  2. Datos parametrai
  3. Datos formatas
  4. SDK sintaksė
  5. Derink datas ir paskyras
  6. Naudojimo atvejai
  7. Geriausios praktikos
  8. Svarbiausi punktai

Apibrėžk paieškos laiko langą

„X Search“ siūlo funkciją, kurios neturi „Web Search“: filtravimą pagal datą. Gali apibrėžti konkretų laikotarpį, kad rezultatuose būtų tik tuose laiku paskelbti įrašai. Tai galingas įrankis tendencijų analizei, įvykių stebėjimui ir tiksliniam monitoringui.

Datos parametrai

Laiko langą valdo du parametrai:

  • from_date: paieškos pradžios data (imtinai)
  • to_date: paieškos pabaigos data (imtinai)

Abu yra neprivalomi ir nepriklausomi. Gali naudoti vieną be kito:

  • Tik from_date: visi įrašai nuo šios datos
  • Tik to_date: visi įrašai iki šios datos
  • Abu kartu: įrašai apibrėžtame lange

Datos formatas

Datos turi atitikti ISO 8601 formatą: YYYY-MM-DD (metai-mėnuo-diena).

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

Ši užklausa ieško tik įrašų, paskelbtų 2026 m. kovą.

SDK sintaksė

xAI SDK (Python)

Python SDK priima ir eilutes, ir datetime objektus:

from xai_sdk.tools import x_search
import datetime

# Naudojant eilutes
tools=[x_search(
    from_date="2026-01-01",
    to_date="2026-04-01"
)]

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

Gaminiuose („production“) rekomenduojama naudoti datetime objektus, nes tai leidžia dinamiškai skaičiuoti datas (pavyzdžiui, „paskutinės 7 dienos“).

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

Taikoma camelCase konvencija: fromDate ir toDate.

Derink datas ir paskyras

Laiko filtravimo derinimas su paskyrų filtravimu yra ypač veiksmingas:

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

Ši užklausa sujungia tris filtrus: tik oficialių „xAI“ paskyrų įrašai ir tik 2026 m. balandžio mėnesį.

Naudojimo atvejai

Įvykių analizė

Stebėk reakcijas realiuoju laiku vykstant įvykiui (konferencija, produkto pristatymas, pranešimas):

# Reakcijos pagrindinio pranešimo metu
tools=[{
    "type": "x_search",
    "from_date": "2026-03-25",
    "to_date": "2026-03-26"
}]

Automatinis savaitinis monitoringas

Sukurk automatinę ataskaitą apie praėjusią savaitę:

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

Tendencijų analizė

Palygink diskusijas apie temą skirtingais laikotarpiais, siųsdamas kelias užklausas su skirtingais laiko langais.

Geriausios praktikos

Patirtis rodo, kad trumpesni langai veikia geriau: vienos–septynių dienų laikotarpis duoda žymiai tikslesnių rezultatų nei visas mėnuo, kai svarbūs įrašai pasimeta informacijos gausoje. Gaminiuose niekada nekoduok šių datų „kietai“ – kiekvieno vykdymo metu apskaičiuok jas naudodamas datetime. Priešingu atveju tavo „7 dienų monitoringo“ langas nuo diegimo momento amžinai užklausinės tą pačią savaitę. Galiausiai, laiko langas tik apibrėžia rezultatų aibę: tai, ką su jais daryti, nurodo užklausa („prompt“). Nurodyk, ko tikiesi – „tendencijų santrauka“, „daugiausia įsitraukimo sulaukę įrašai“, „svarbiausi pranešimai“ – ir modelis atitinkamai atrinks rezultatus, užuot grąžinęs viską iš eilės.

Svarbiausi punktai

  • from_date ir to_date ISO 8601 formatu (YYYY-MM-DD)
  • Abu parametrai yra neprivalomi ir nepriklausomi
  • Derink su paskyrų filtravimu, kad gautum itin tikslines paieškas
  • Python SDK priima ir eilutes, ir datetime objektus
  • Tai „X Search“ išskirtinumas – „Web Search“ laiko filtravimo nesiūlo