Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Päivämääräsuodatus

Oppitunti 10 / 16 Päivitetty 30. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Määritä hakuaikaikkuna
  2. Päivämääräparametrit
  3. Päivämäärämuoto
  4. SDK-syntaksi
  5. Yhdistä päivämäärät ja käyttäjätunnukset
  6. Käyttötapaukset
  7. Parhaat käytännöt
  8. Keskeiset asiat

Määritä hakuaikaikkuna

X Search tarjoaa ominaisuuden, jota Web Searchissa ei ole: päivämääräsuodatuksen. Voit määrittää tietyn ajanjakson rajoittaaksesi tulokset kyseisenä aikana julkaistuihin viesteihin. Tämä on tehokas työkalu trendianalyysiin, tapahtumien seurantaan ja kohdennettuun monitorointiin.

Päivämääräparametrit

Kaksi parametria ohjaa aikaikkunaa:

  • from_date: haun alkamispäivä (mukaan lukien)
  • to_date: haun päättymispäivä (mukaan lukien)

Molemmat ovat valinnaisia ja toisistaan riippumattomia. Voit käyttää toista ilman toista:

  • Vain from_date: kaikki viestit tästä päivästä eteenpäin
  • Vain to_date: kaikki viestit tähän päivään saakka
  • Molemmat yhdessä: viestit määritellyn aikaikkunan sisällä

Päivämäärämuoto

Päivämäärät noudattavat ISO 8601 -muotoa: YYYY-MM-DD (vuosi-kuukausi-päivä).

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

Tämä haku etsii vain maaliskuussa 2026 julkaistuja viestejä.

SDK-syntaksi

xAI SDK (Python)

Python SDK hyväksyy sekä merkkijonoja että datetime-olioita:

from xai_sdk.tools import x_search
import datetime

# Käytetään merkkijonoja
tools=[x_search(
    from_date="2026-01-01",
    to_date="2026-04-01"
)]

# Käytetään datetime-olioita
tools=[x_search(
    from_date=datetime.datetime(2026, 1, 1),
    to_date=datetime.datetime(2026, 4, 1)
)]

datetime-olioiden käyttö on suositeltavaa tuotantoympäristöissä, koska se mahdollistaa päivämäärien dynaamisen laskemisen (esimerkiksi “viimeiset 7 päivää”).

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-käytäntö: fromDate ja toDate.

Yhdistä päivämäärät ja käyttäjätunnukset

Aikasuodatuksen yhdistäminen käyttäjätunnussuodatukseen on erityisen tehokasta:

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

Tämä kysely yhdistää kolme suodatinta: vain virallisten xAI-tilien viestit ja vain huhtikuulta 2026.

Käyttötapaukset

Tapahtuma-analyysi

Seuraa reaktioita reaaliajassa tapahtuman aikana (konferenssi, tuotelanseeraus, ilmoitus):

# Reaktiot keynoten aikana
tools=[{
    "type": "x_search",
    "from_date": "2026-03-25",
    "to_date": "2026-03-26"
}]

Automaattinen viikkoseuranta

Luo automaattinen seurantaraportti menneeltä viikolta:

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

Trendianalyysi

Vertaile keskustelua aiheesta eri aikoina tekemällä useita pyyntöjä eri aikaikkunoilla.

Parhaat käytännöt

Kokemus osoittaa, että lyhyemmät aikaikkunat toimivat parhaiten: yhden ja seitsemän päivän jakso tuottaa huomattavasti tarkempia tuloksia kuin koko kuukausi, jossa merkittävät viestit hukkuvat massaan. Älä koskaan kovakoodaa näitä päivämääriä tuotannossa – laske ne datetime-funktiolla jokaisella ajokerralla. Muuten “7 päivän seuranta” -ikkunasi hakee samaa viikkoa ikuisesti käyttöönoton jälkeen. Lopuksi, aikaikkuna määrittää vain tulosjoukon: kehote (prompt) sanelee, mitä sille tehdään. Määritä odotuksesi – “trendiyhteenveto”, “eniten vuorovaikutusta saaneet viestit”, “tärkeimmät ilmoitukset” – jolloin malli suodattaa tulokset sen mukaisesti sen sijaan, että palauttaisi kaiken.

Keskeiset asiat

  • from_date ja to_date ISO 8601 -muodossa (YYYY-MM-DD)
  • Molemmat parametrit ovat valinnaisia ja riippumattomia
  • Yhdistä käyttäjätunnussuodatukseen erittäin kohdennettuja hakuja varten
  • Python SDK hyväksyy sekä merkkijonoja että datetime-olioita
  • Vain X Searchissä – Web Search ei tarjoa aikasuodatusta