Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Iffiltrar skont id-Data

Lezzjoni 10 / 16 Aġġornat 30 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Iddefinixxi t-tieqa ta’ żmien għat-tfittxija
  2. Parametri tad-data
  3. Format tad-data
  4. Sintassi tas-SDK
  5. Iggħaqqad id-dati mal-handles
  6. Każijiet ta’ użu
  7. L-aħjar prattiki
  8. Punti Ewlenin

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_date biss: il-posts kollha minn din id-data ‘l quddiem
  • to_date biss: 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_date u to_date fil-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