JSON Ráthaithe ag Scéima
Ar an leathanach seo
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.
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) agusresponse_format(láimhe) - Is é seo bunús aon phíblíne táirgeachta iontaofa le Grok API