Päivämääräsuodatus
Tällä sivulla
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_datejato_dateISO 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