Filtriranje po datumu
Na tej strani
Določitev časovnega okna iskanja
X Search ponuja funkcijo, ki je Web Search nima: filtriranje po datumu. Določiš lahko specifično obdobje in tako omejiš rezultate na objave, objavljene znotraj tega časovnega okna. To je zmogljivo orodje za analizo trendov, sledenje dogodkom in ciljno spremljanje.
Parametra za datum
Časovno okno nadzirata dva parametra:
from_date: začetni datum iskanja (vključno)to_date: končni datum iskanja (vključno)
Oba sta opcijska in neodvisna. Uporabiš lahko enega brez drugega:
- samo
from_date: vse objave od tega datuma naprej - samo
to_date: vse objave do tega datuma - oba skupaj: objave znotraj določenega okna
Oblika datuma
Datumi sledijo formatu ISO 8601: YYYY-MM-DD (leto-mesec-dan).
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"
}]
)
Ta poizvedba išče samo objave, objavljene marca 2026.
Skladnja SDK-ja
xAI SDK (Python)
Python SDK sprejema tako nize kot predmete datetime:
from xai_sdk.tools import x_search
import datetime
# Uporaba nizov
tools=[x_search(
from_date="2026-01-01",
to_date="2026-04-01"
)]
# Uporaba predmetov datetime
tools=[x_search(
from_date=datetime.datetime(2026, 1, 1),
to_date=datetime.datetime(2026, 4, 1)
)]
Uporaba predmetov datetime je v proizvodnem okolju prednostna, saj omogoča dinamično izračunavanje datumov (na primer „zadnjih 7 dni”).
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"
})]
Konvencija camelCase: fromDate in toDate.
Kombiniranje datumov in uporabniških imen
Kombiniranje časovnega filtriranja s filtriranjem po uporabniških imenih (handles) je še posebej zmogljivo:
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"
}]
)
Ta poizvedba združuje tri filtre: samo objave uradnih računov xAI in samo iz aprila 2026.
Primeri uporabe
Analiza dogodkov
Sledi odzivom v realnem času med dogodkom (konferenca, lansiranje izdelka, napoved):
# Odzivi med ključnim govorom
tools=[{
"type": "x_search",
"from_date": "2026-03-25",
"to_date": "2026-03-26"
}]
Avtomatizirano tedensko spremljanje
Ustvari samodejno poročilo o spremljanju za pretekli teden:
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 trendov
Primerjaj razprave o temi v različnih obdobjih z večkratnimi zahtevki z različnimi časovnimi okni.
Najboljše prakse
Izkušnje kažejo, da krajša okna delujejo najbolje: obdobje od enega do sedmih dni prinaša bistveno natančnejše rezultate kot celoten mesec, kjer se pomembne objave izgubijo v množici. V proizvodnem okolju teh datumov nikoli ne vgrajuj trdno (hardcode) – izračunavaj jih s pomočjo datetime ob vsakem zagonu. V nasprotnem primeru bo tvoje okno „7-dnevnega spremljanja” večno poizvedovalo po istem tednu od trenutka namestitve. Nazadnje, časovno okno le določa nabor rezultatov; ukaz (prompt) narekuje, kaj storiti z njim. Natančno določi, kaj pričakuješ – „povzetek trendov”, „najbolj angažirane objave”, „glavna sporočila” – in model bo rezultate ustrezno filtriral, namesto da bi vrnil vse.
Ključne ugotovitve
from_dateinto_datev formatu ISO 8601 (YYYY-MM-DD)- Oba parametra sta opcijska in neodvisna
- Združi s filtriranjem po uporabniških imenih za izjemno ciljna iskanja
- Python SDK sprejema tako nize kot predmete
datetime - Ekskluzivno za X Search – Web Search ne ponuja časovnega filtriranja