Iffiltrar skont id-Data
F'din il-paġna
Iddefinixxi t-tieqa ta’ żmien għat-tfittxija
X Search joffri karatteristika li Web Search m’għandux: l-iffiltrar skont id-data. Tista’ tiddefinixxi perjodu speċifiku biex tillimita r-riżultati għal posts ippubblikati f’dik it-tieqa ta’ żmien. Dan huwa għodda qawwija għall-analiżi tat-tendenzi, it-traċċar tal-avvenimenti u l-monitoraġġ immirat.
Parametri tad-data
Żewġ parametri jikkontrollaw it-tieqa ta’ żmien:
from_date: id-data tal-bidu tat-tfittxija (inklużiva)to_date: id-data tat-tmiem tat-tfittxija (inklużiva)
It-tnejn huma fakultattivi u indipendenti. Tista’ tuża wieħed mingħajr l-ieħor:
from_datebiss: il-posts kollha minn din id-data ‘l quddiemto_datebiss: il-posts kollha sa din id-data- It-tnejn flimkien: posts fit-tieqa ta’ żmien iddefinita
Format tad-data
Id-dati jsegwu l-format ISO 8601: YYYY-MM-DD (sena-xahar-jum).
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"
}]
)
Din il-mistoqsija tfittex biss posts ippubblikati f’Marzu 2026.
Sintassi tas-SDK
xAI SDK (Python)
L-SDK tal-Python jaċċetta kemm strings kif ukoll oġġetti datetime:
from xai_sdk.tools import x_search
import datetime
# Bl-użu ta' strings
tools=[x_search(
from_date="2026-01-01",
to_date="2026-04-01"
)]
# Bl-użu ta' oġġetti datetime
tools=[x_search(
from_date=datetime.datetime(2026, 1, 1),
to_date=datetime.datetime(2026, 4, 1)
)]
L-użu ta’ oġġetti datetime huwa ppreferut fil-produzzjoni għax jippermettilek tikkalkula d-dati b’mod dinamiku (pereżempju, “l-aħħar 7 ijiem”).
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"
})]
Konvenzjoni camelCase: fromDate u toDate.
Iggħaqqad id-dati mal-handles
Il-kombinazzjoni tal-iffiltrar skont iż-żmien mal-iffiltrar skont il-handles hija partikolarment qawwija:
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"
}]
)
Din il-mistoqsija tgħaqqad tliet filtri: biss posts minn konts uffiċjali ta’ xAI, u biss f’April 2026.
Każijiet ta’ użu
Analiżi tal-avvenimenti
Segwi r-reazzjonijiet f’ħin reali waqt avveniment (konferenza, tnedija ta’ prodott, annunzju):
# Reazzjonijiet waqt keynote
tools=[{
"type": "x_search",
"from_date": "2026-03-25",
"to_date": "2026-03-26"
}]
Monitoraġġ awtomatiku ġimgħani
Oħloq rapport ta’ monitoraġġ awtomatiku għall-ġimgħa li għaddiet:
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")
}]
Analiżi tat-tendenzi
Qabbel id-diskussjonijiet dwar suġġett f’perjodi differenti billi tagħmel talbiet multipli b’tieqiet ta’ żmien distinti.
L-aħjar prattiki
L-esperjenza turi li tieqiet iqsar jaħdmu aħjar: perjodu ta’ jum sa sebat ijiem jagħti riżultati ferm aktar preċiżi minn xahar sħiħ, fejn posts sinifikanti jintilfu fil-volum. Fil-produzzjoni, qatt ma tħalli d-dati miktuba b’mod fiss (hardcoded)—ikkalkulahom b’datetime f’kull eżekuzzjoni. Inkella, it-tieqa ta’ monitoraġġ ta’ “7 ijiem” tiegħek se tistaqsi dejjem l-istess ġimgħa mid-deploy. Fl-aħħar nett, it-tieqa ta’ żmien tiddefinixxi biss is-sett tar-riżultati: il-prompt jiddetta x’għandu jsir bih. Speċifika x’tistenna—“sommarju tat-tendenza”, “posts bl-aktar interazzjoni”, “annunzji ewlenin”—u l-mudell se jiffiltra r-riżultati skont dan minflok ma jirritorna kollox.
Punti Ewlenin
from_dateuto_datefil-format ISO 8601 (YYYY-MM-DD)- Iż-żewġ parametri huma fakultattivi u indipendenti
- Iggħaqqadhom mal-iffiltrar tal-handles għal tfittxijiet immirati ħafna
- L-SDK tal-Python jaċċetta kemm strings kif ukoll oġġetti
datetime - Esklussiv għal X Search—Web Search ma joffrix iffiltrar skont iż-żmien