OpenAI
Aistríodh an leathanach seo le meaisín. Féach ar an t-alt bunaidh i mBéarla.

Glao Feidhme in API OpenAI

Cad is glao feidhme ann agus conas a oibríonn sé in API OpenAI?

Nuashonraithe: last month

Amhail an 11 Márta 2025, tá bunchlocha ár n-ardáin nua Gníomhairí eisithe againn. Le haghaidh sonraí, féach ar ár ndoiciméid API dár API Responses, Uirlisí lena n-áirítear Cuardach Gréasáin, Cuardach Comhad, agus Úsáid Ríomhaire, agus ár SDK Gníomhairí le Lorgú.

Cuireann glao feidhme ar do chumas samhlacha OpenAI a nascadh le huirlisí agus córais sheachtracha. Tá sé seo úsáideach ar go leor bealaí, amhail cumais a thabhairt do chúntóirí intleachta saorga nó comhtháthú domhain a chruthú idir d’fheidhmchláir agus LLManna.

Faigh tuilleadh eolais inár dtreoir d’fhorbróirí maidir le glao feidhme.

I mí an Mheithimh 2024, sheolamar aschur struchtúrtha. I gcás samhlacha agus cumraíochtaí iarratais a dtacaítear leo, nuair a eisíonn an tsamhail glao feidhme, cinntíonn socrú strict: true i do shainmhíniú feidhme go gcloíonn na hargóintí ginte leis an scéimre a soláthraíodh, ar choinníoll go n-úsáideann an scéimre an fo-thacar de JSON Schema a dtacaítear leis agus go gcomhlíonann sí riachtanais an mhóid dhocht. Diúltaítear d’iarratais ina bhfuil scéimrí nach dtacaítear leo nó nach gcomhlíonann na ceanglais, agus tugtar earráid.

I mí Dheireadh Fómhair 2024, sheolamar an ghné 'Gin Rud ar Bith', lenar féidir le forbróirí cur síos a dhéanamh ar fheidhm agus é a ghreamú isteach go díreach, nó a gcód a ghreamú isteach chun scéimre bhailí feidhme a ghiniúint. Faigh tuilleadh eolais faoi 'Gin Rud ar Bith' san alt seo san ionad cabhrach.

Conas is féidir liom glao feidhme a úsáid?

Tá glao feidhme úsáideach i líon mór cásanna úsáide, amhail:

  • Cúntóirí a chumasú chun sonraí a fháil:

  • Cúntóirí a chumasú chun gníomhartha a dhéanamh:

  • Cúntóirí a chumasú chun ríomh a dhéanamh:

  • Sreafaí oibre saibhre a thógáil:

  • píblíne asbhainte sonraí a fhaigheann téacs amh, a thiontaíonn ansin ina shonraí struchtúrtha agus a shábhálann i mbunachar sonraí é.

Tacaítear le glao feidhme san API Responses, a aontaíonn cumais a bhí roimhe seo roinnte idir an API críochnuithe comhráite agus an API Assistants.

Conas is féidir liom mód JSON a úsáid?

Nuair atá mód JSON curtha ar siúl, cinntítear gur JSON bailí é aschur na samhla, seachas i gcásanna imeallacha áirithe ar cheart duit iad a bhrath agus a láimhseáil mar is cuí.

Chun mód JSON a iarraidh leis an API críochnuithe comhráite, socraigh response_format go { "type": "json_object" } ar shamhlacha tacaithe. Leis an API Responses, socraigh text.format go { "type": "json_object" }, mar shampla text: { "format": { "type": "json_object" } }, nuair is infheidhme. I gceachtar API, ní oibríonn mód JSON ach nuair a chomhlíontar réamhriachtanais samhla/teachtaireachta/uirlise (mar shampla, tacaíonn an tsamhail le json_object, tá treoracha sa chomhrá chun JSON a tháirgeadh, agus tá aon srianta uirlise comhoiriúnach). Ní mór do theachtaireacht iarratais amháin ar a laghad nó do theachtaireacht ionchuir amháin sa chomhthéacs ionchuir éifeachtach json a bheith inti i bhfoirm nach bhfuil íogair don chás, amhail JSON, json, nó Json; murach sin, filleann an API earráid. In Responses, ní shásaíonn an réimse treoracha barrleibhéil leis féin an bailíochtú seo. Nuair a úsáidtear glao feidhme ar shamhlacha/conairí comhoiriúnacha, cuirtear srianta JSON i bhfeidhm go huathoibríoch ar argóintí glaonna feidhme; d’fhéadfaí samhlacha neamh-chomhoiriúnacha nó teaglamaí uirlise/formáide freagartha a dhiúltú, nó seans nach n-úsáidfidh siad sampláil atá srianta ag JSON.

Nótaí tábhachtacha:

  • Agus mód JSON á úsáid agat, ní mór duit treoir a thabhairt don tsamhail i gcónaí JSON a tháirgeadh trí theachtaireacht éigin sa chomhrá, mar shampla trí do theachtaireacht chórais. Mura gcuireann tú treoir shainráite san áireamh chun JSON a ghiniúint, féadfaidh an tsamhail sruth gan deireadh de spás bán a ghiniúint agus féadfaidh an t-iarratas rith go leanúnach go dtí go sroicheann sé teorainn na dtéacschomharthaí. Chun cabhrú lena chinntiú nach ndéanann tú dearmad, diúltaíonn mód JSON d’iarratais mura bhfuil an focal json i bhfoirm éigin sna teachtaireachtaí ionchuir nó sna treoracha ábhartha, gan beann ar chás.

  • Ní ráthaíonn mód JSON go mbeidh an t-aschur ag teacht le scéimre ar leith ar bith; ní ráthaíonn sé ach go bhfuil sé bailí agus gur féidir é a pharsáil gan earráidí. Ba cheart duit Aschur Struchtúrtha a úsáid chun a chinntiú go bhfuil sé ag teacht le do scéimre, nó mura féidir é sin a dhéanamh, ba cheart duit leabharlann bhailíochtaithe agus, b’fhéidir, atrialacha a úsáid chun a chinntiú go bhfuil an t-aschur ag teacht leis an scéimre atá uait.

  • Ní mór do d’fheidhmchlár na cásanna imeallacha a d’fhéadfadh a chur faoi deara nach réad JSON iomlán é aschur na samhla a bhrath agus a láimhseáil (féach thíos)

Ar chuidigh an t-alt seo libh?