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

Scagadh de réir láimhseálacha X

Ceacht 9 as 16 Nuashonraithe 30 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Spriocdhírigh ar chuntais ar leith ar X
  2. An dá pharaiméadar scagtha
  3. allowed_x_handles a úsáid (liosta ceadaithe)
  4. excluded_x_handles a úsáid (liosta bacainne)
  5. Comhréir an SDK
  6. Dea-chleachtais
  7. Príomhphointí

Spriocdhírigh ar chuntais ar leith ar X

Díreach mar a ligeann Cuardach Gréasáin duit scagadh a dhéanamh de réir fearainn, ligeann Cuardach X duit scagadh a dhéanamh de réir cuntas (láimhseálacha). Is féidir leat cuardaigh a theorannú do phoist ó shraith shonraithe cuntas, nó cuntais áirithe a eisiamh ó na torthaí. Tá an scagadh seo ríthábhachtach do chásanna úsáide cosúil le faireachán, rianú branda, nó anailís ar thionchair.

An dá pharaiméadar scagtha

Tá dhá pharaiméadar scagtha láimhseála ar fáil i gCuardach X:

  • allowed_x_handles: teorannaíonn sé an cuardach do phoist ó na cuntais atá liostaithe (liosta ceadaithe)
  • excluded_x_handles: eisiann sé poist ó na cuntais atá liostaithe (liosta bacainne)

Cosúil le Cuardach Gréasáin, tá na paraiméadair seo comheisiach. Ní féidir leat an dá cheann a úsáid sa iarraidh chéanna.

Glacann gach paraiméadar le sraith de ** suas le 10 láimhseáil** (i gcomparáid le 5 fhearann do Chuardach Gréasáin).

allowed_x_handles a úsáid (liosta ceadaithe)

Tá an paraiméadar seo idéalach chun cumarsáid ó chuntais shonracha a fhaire:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What are the latest announcements from xAI?",
    tools=[{
        "type": "x_search",
        "allowed_x_handles": ["xaboratory", "xaboratorydev"]
    }]
)

Ní dhéanfaidh an tsamhail ach cuardach ar phoist a foilsíodh ag na cuntais seo.

Cásanna úsáide don liosta ceadaithe

  • Faisnéis iomaíoch: déan faireachán ar fhógraí ó do chuid iomaitheoirí
  • Faireachán branda: rianaigh do chuntais oifigiúla agus cuntais do chuid ambasadóirí
  • Anailís ar thionchair: bailigh tuairimí ó phainéal saineolaithe
  • Rianú institiúideach: lean cuntais ó rialálaithe nó ó eagraíochtaí oifigiúla

excluded_x_handles a úsáid (liosta bacainne)

Ligeann an paraiméadar seo duit cuntais áirithe a eisiamh, amhail róbat nó cuntais nach mbaineann leat:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What do developers think about the latest version of Python?",
    tools=[{
        "type": "x_search",
        "excluded_x_handles": ["bot_python_news", "spam_account"]
    }]
)

Cásanna úsáide don liosta bacainne

  • Róbat a eisiamh: bain cuntais uathoibrithe as na torthaí
  • Spam a eisiamh: scag amach cuntais atá ar eolas mar fhoinse ábhair ísealchaighdeáin
  • Do chuntais féin a eisiamh: déan anailís ar imoibrithe seachtracha gan do chuid post féin a áireamh

Comhréir an SDK

xAI SDK (Python)

from xai_sdk.tools import x_search

tools=[x_search(
    allowed_x_handles=["elonmusk", "xaboratory"]
)]

OpenAI SDK (Python)

tools=[{
    "type": "x_search",
    "allowed_x_handles": ["elonmusk", "xaboratory"]
}]

Vercel AI SDK (JavaScript)

tools: [xai.tools.xSearch({
  allowedXHandles: ["elonmusk", "xaboratory"]
})]

Tabhair faoi deara an coinbhinsiún camelCase san SDK JavaScript: allowedXHandles in ionad allowed_x_handles.

Dea-chleachtais

Roghnú idir liosta ceadaithe agus liosta bacainne

Úsáid an liosta ceadaithe nuair a bhíonn sraith shainithe cuntas agat agus nach dteastaíonn uait ach a bpoist. Is é seo an modh is cruinne agus is éifeachtaí ó thaobh token de.

Úsáid an liosta bacainne nuair a theastaíonn cuardach leathan uait ach gur gá duit é a ghlanadh trí fhoinsí torainn ar eolas a dhíbirt.

Líon na láimhseálacha a bharrfheabhsú

Le teorainn 10 láimhseáil, bí roghnach. Má tá ort faireachán a dhéanamh ar níos mó ná 10 gcuntas, grúpáil do chuid iarratas de réir topaice nó déan glaonna seicheamhacha iolracha.

Formáid na láimhseála

Ní áirítear an siombail @ i láimhseálacha (mar shampla, xaboratory). Dearbhaigh go bhfuil na láimhseálacha ceart – fillfidh láimhseáil mílitrithe gan aon toradh don chuntas sin.

Príomhphointí

  • Dhá pharaiméadar: allowed_x_handles (liosta ceadaithe) agus excluded_x_handles (liosta bacainne)
  • Comheisiach: ní féidir ach ceann amháin a úsáid in aghaidh na hiarrata
  • Uasmhéid 10 láimhseáil in aghaidh an pharaiméadair
  • Scríobhtar láimhseálacha gan an @: "elonmusk", ní "@elonmusk"
  • Idealach le haghaidh faireacháin, rianú branda, agus anailís ar thionchair