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

JSON Ráthaithe ag Scéima

Ceacht 1 as 12 Nuashonraithe 28 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Cén fáth a n-athraíonn aschuir struchtúrtha gach rud
  2. Conas a oibríonn sé
  3. Fáilteacht
  4. Gan vs. Le Aschuir Struchtúrtha
  5. Dhá chur chuige ar fáil
  6. Príomhphointí

Cén fáth a n-athraíonn aschuir struchtúrtha gach rud

Nuair a úsáideann tú samhail teanga i dtimpeallacht táirgeachta, teastaíonn freagraí uait is féidir le cód a úsáid. Ní téacs saor, ní JSON neamhchinnte—ach JSON atá ráthaithe comhlíontach le scéima a shainíonn tú. Sin díreach a thairgeann aschuir struchtúrtha Grok API duit.

Tá an prionsabal simplí: soláthraíonn tú scéima JSON don tsamhail, agus ráthaíonn an API go leanfaidh an freagra an struchtúr sin go beacht. Gan parsáil randamach, gan regex leochaileach, gan blocanna try/catch chun cásanna a láimhseáil ina gcruthaíonn an samhail formáid nua.

Conas a oibríonn sé

Braitheann aschuir struchtúrtha ar mheicníocht srianta a chuirtear i bhfeidhm le linn giniúna an téacs. Ag gach token a tháirgtear, cuirtear srian ar an tsamhail gan ach tokens atá comhoiriúnach leis an scéima soláthraithe a ghiniúint. An toradh: JSON atá bailí i gcónaí, comhlíontach i gcónaí.

Breathnaímis ar shampla concreideach. Ba mhaith leat faisnéis teagmhála a bhaint as ríomhphost:

from pydantic import BaseModel

class Contact(BaseModel):
    nom: str
    email: str
    entreprise: str
    telephone: str | None

# Beidh an freagra INA CHÓNÁI ina oibiacht Contact bhailí

Gan aschuir struchtúrtha, d’fhéadfadh an tsamhail an uimhir ghutháin a thabhairt ar ais mar "tel", "phone", nó "numéro". Le scéima, tabharfar telephone i gcónaí ar an réimse, agus beidh a luach ina shreang nó null i gcónaí.

Fáilteacht

Tacaítear le haschuir struchtúrtha ar gach samhail teanga xAI: Grok 4.5, Grok 4.3, leaganacha grok-4.20, agus leaganacha níos déanaí. Cibé samhail a úsáideann tú, tá an ghné ar fáil gan costas breise ná cumraíocht bhreise.

100%
JSON bailí ráthaithe
7
Cineálacha tacaithe
Gach
Samhlacha xAI
2
Modhanna glao

Gan vs. Le Aschuir Struchtúrtha

Seo an méid a gheobhaidh tú gan an ghné seo agus léi:

Gan aschuir struchtúrtha:

  • D’fhéadfadh an tsamhail téacs saor, JSON páirteach, nó formáid gan choinne a thabhairt ar ais
  • Caithfidh tú parsáil de láimh a dhéanamh agus earráidí a láimhseáil
  • D’fhéadfadh ainmneacha réimsí athrú ó iarratas go hiarratas
  • Briseann do phíblíne chomh luath agus a athraíonn an tsamhail formáid

Le haschuir struchtúrtha:

  • Tá an JSON i gcónaí bailí go sintactach
  • Freagraíonn an struchtúr don scéima soláthraithe go beacht
  • Urramaítear na cineálacha (sreang, uimhir, boole, srl.)
  • Is féidir le do chód an freagra a ithe go díreach

Dhá chur chuige ar fáil

Tairgeann Grok API dhá mhodh chun aschuir struchtúrtha a úsáid:

  • parse(): Modh uathoibríoch a thugann oibiacht chlóscríofa ar ais go díreach. Ideálach don chuid is mó de chásanna.
  • response_format: Modh láimhe a thugann sreang JSON ar ais. Níos mó rialaithe, ach is ortsa an pharsáil a dhéanamh.

Faighidh tú amach faoin dá mhodh seo go mion sna ceachtanna atá le teacht.

Príomhphointí

  • Ráthaíonn aschuir struchtúrtha JSON atá comhlíontach le do scéima ar gach glao
  • Cuirtear an srian i bhfeidhm le linn na giniúna, ní ina dhiaidh
  • Tacaíonn gach samhail teanga xAI leis an ngné seo
  • Tá dhá mhodh ar fáil: parse() (uathoibríoch) agus response_format (láimhe)
  • Is é seo bunús aon phíblíne táirgeachta iontaofa le Grok API