Filtrēšana pēc datuma
Šajā lapā
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_dateunto_dateISO 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
datetimeobjektus - Ekskluzīvi X Search – Web Search nepiedāvā laika filtrēšanu