Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Scagadh Dáta

Ceacht 10 as 16 Nuashonraithe 30 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Sainigh an fhuinneog ama cuardaigh
  2. Paraiméadair dáta
  3. Formáid dáta
  4. Comhréir SDK
  5. Comhcheangail dátaí agus láimhseálacha
  6. Cásanna úsáide
  7. Dea-chleachtais
  8. Príomhphointí

Sainigh an fhuinneog ama cuardaigh

Tá gné ag X Search nach bhfuil ag Web Search: scagadh dáta. Is féidir leat tréimhse shainithe a shocrú chun torthaí a theorannú do phoist a foilsíodh laistigh den fhuinneog ama sin. Is uirlis chumhachtach í seo le haghaidh anailíse ar threochtaí, rianú imeachtaí, agus monatóireacht spriocdhírithe.

Paraiméadair dáta

Rialaíonn dhá pharaiméadar an fhuinneog ama:

  • from_date: dáta tosaigh an chuardaigh (cuimsitheach)
  • to_date: dáta deiridh an chuardaigh (cuimsitheach)

Tá an dá cheann roghnach agus neamhspleách. Is féidir leat ceann amháin a úsáid gan an ceann eile:

  • from_date amháin: gach post ón dáta seo i leith
  • to_date amháin: gach post go dtí an dáta seo
  • An dá cheann le chéile: poist laistigh den fhuinneog shainithe

Formáid dáta

Leanann dátaí an fhormáid ISO 8601: YYYY-MM-DD (bliain-mí-lá).

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

Déanann an cheist seo cuardach ar phoist a foilsíodh i mí an Mhárta 2026 amháin.

Comhréir SDK

xAI SDK (Python)

Glacann an Python SDK le teaghráin agus le hoibiachtaí datetime:

from xai_sdk.tools import x_search
import datetime

# Ag úsáid teaghrán
tools=[x_search(
    from_date="2026-01-01",
    to_date="2026-04-01"
)]

# Ag úsáid oibiachtaí datetime
tools=[x_search(
    from_date=datetime.datetime(2026, 1, 1),
    to_date=datetime.datetime(2026, 4, 1)
)]

Is fearr oibiachtaí datetime a úsáid i dtimpeallachtaí táirgeachta toisc go gceadaíonn siad duit dátaí a ríomh go dinimiciúil (mar shampla, “na 7 lá seo caite”).

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

Coinbhinsiún camelCase: fromDate agus toDate.

Comhcheangail dátaí agus láimhseálacha

Tá sé thar a bheith cumhachtach scagadh ama a chomhcheangal le scagadh láimhseálacha:

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

Comhcheanglaíonn an cheist seo trí scagaire: poist ó chuntais oifigiúla xAI amháin, agus i mí Aibreáin 2026 amháin.

Cásanna úsáide

Anailís ar imeachtaí

Rianaigh freagairtí i bhfíor-am le linn imeachta (comhdháil, seoladh táirge, fógra):

# Freagairtí le linn príomhóráide
tools=[{
    "type": "x_search",
    "from_date": "2026-03-25",
    "to_date": "2026-03-26"
}]

Monatóireacht sheachtainiúil uathoibrithe

Cruthaigh tuarascáil mhonatóireachta uathoibrithe don tseachtain seo caite:

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

Anailís ar threochtaí

Déan comparáid idir plé ar ábhar ag tréimhsí éagsúla trí iarratais iolracha a dhéanamh le fuinneoga ama ar leith.

Dea-chleachtais

Léiríonn taithí go n-oibríonn fuinneoga níos giorra níos fearr: tugann tréimhse ó lá amháin go seacht lá torthaí i bhfad níos cruinne ná mí iomlán, áit a gcailltear poist thábhachtacha sa mhéid mór. I dtimpeallachtaí táirgeachta, ná crua-chódaigh na dátaí seo riamh; ríomh iad le datetime ag gach rith. Murach sin, déanfaidh d’fhuinneog “monatóireachta 7 lá” ceist ar an tseachtain chéanna go deo ón imlonnú. Ar deireadh, ní shainíonn an fhuinneog ama ach an tacar torthaí: is é an leid a dhéanann cinneadh ar an méid atá le déanamh leo. Sonraigh cad a bhfuil tú ag súil leis—“achoimre ar threochtaí”, “na poist leis an rannpháirtíocht is airde”, “fógraí móra”—agus scagfaidh an tsamhail na torthaí dá réir sin in ionas gach rud a thabhairt ar ais.

Príomhphointí

  • from_date agus to_date i bhformáid ISO 8601 (YYYY-MM-DD)
  • Tá an dá pharaiméadar roghnach agus neamhspleách
  • Comhcheangail le scagadh láimhseálacha le haghaidh cuardach an-spriocdhírithe
  • Glacann Python SDK le teaghráin agus le hoibiachtaí datetime araon
  • Eisiach ag X Search—ní thairgeann Web Search scagadh ama