Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Filtrēšana pēc datuma

Nodarbība 10 no 16 Atjaunota 2026. gada 30. jūlijs Programmētājs
Šajā lapā
  1. Meklēšanas laika loga definēšana
  2. Datuma parametri
  3. Datuma formāts
  4. SDK sintakse
  5. Datumu un lietotājvārdu kombinēšana
  6. Lietošanas gadījumi
  7. Labākā prakse
  8. Galvenās atziņas

Meklēšanas laika loga definēšana

X Search piedāvā funkciju, kas nav pieejama Web Search: filtrēšanu pēc datuma. Tu vari definēt konkrētu periodu, lai ierobežotu rezultātus tikai ar ziņām, kas publicētas šajā laika posmā. Tas ir spēcīgs instruments tendenču analīzei, notikumu izsekošanai un mērķtiecīgai uzraudzībai.

Datuma parametri

Laika logu kontrolē divi parametri:

  • from_date: meklēšanas sākuma datums (ieskaitot)
  • to_date: meklēšanas beigu datums (ieskaitot)

Abi parametri ir opcionāli un neatkarīgi. Tu vari izmantot vienu bez otra:

  • tikai from_date: visas ziņas kopš šī datuma
  • tikai to_date: visas ziņas līdz šim datumam
  • abi kopā: ziņas definētajā laika logā

Datuma formāts

Datumiem jābūt ISO 8601 formātā: YYYY-MM-DD (gads-mēnesis-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"
    }]
)

Šis vaicājums meklē tikai ziņas, kas publicētas 2026. gada martā.

SDK sintakse

xAI SDK (Python)

Python SDK pieņem gan virknes, gan datetime objektus:

from xai_sdk.tools import x_search
import datetime

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

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

datetime objektu izmantošana ir vēlama ražošanas vidē, jo tā ļauj dinamiski aprēķināt datumus (piemēram, „pēdējās 7 dienas”).

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 konvencija: fromDate un toDate.

Datumu un lietotājvārdu kombinēšana

Laika filtrēšanas apvienošana ar lietotājvārdu (handle) filtrēšanu ir īpaši efektīva:

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

Šis vaicājums apvieno trīs filtrus: tikai ziņas no oficiālajiem xAI kontiem un tikai 2026. gada aprīlī.

Lietošanas gadījumi

Notikumu analīze

Izseko reakcijas reāllaikā notikuma laikā (konference, produkta laišana klajā, paziņojums):

# Reakcijas galvenās runas laikā
tools=[{
    "type": "x_search",
    "from_date": "2026-03-25",
    "to_date": "2026-03-26"
}]

Automatizēta iknedēļas uzraudzība

Izveido automātisku uzraudzības pārskatu par pagājušo nedēļu:

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

Tendenču analīze

Salīdzini diskusijas par kādu tēmu dažādos periodos, veicot vairākus vaicājumus ar atšķirīgiem laika logiem.

Labākā prakse

Pieredze rāda, ka īsāki laika logi dod vislabākos rezultātus: periods no vienas līdz septiņām dienām nodrošina ievērojami precīzākus rezultātus nekā viss mēnesis, kurā nozīmīgas ziņas var pazust liela apjoma dēļ. Ražošanas vidē nekad nefiksē šos datumus kodā – aprēķini tos ar datetime katrā izpildes reizē. Pretējā gadījumā tavs „7 dienu uzraudzības” logs vienmēr vaicās to pašu nedēļu kopš izvietošanas brīža. Visbeidzot, laika logs tikai definē rezultātu kopu: prompts nosaka, ko ar to darīt. Precizē, ko sagaidi – „tendenču kopsavilkums”, „visvairāk iesaistītās ziņas”, „galvenie paziņojumi” – un modelis attiecīgi atlasīs rezultātus, nevis atgriezīs visu pēc kārtas.

Galvenās atziņas

  • from_date un to_date ISO 8601 formātā (YYYY-MM-DD)
  • Abi parametri ir opcionāli un neatkarīgi
  • Apvieno ar lietotājvārdu filtrēšanu ļoti mērķtiecīgai meklēšanai
  • Python SDK pieņem gan virknes, gan datetime objektus
  • Ekskluzīvi X Search – Web Search nepiedāvā laika filtrēšanu