Is é Chat Completions an API caighdeánach le húsáid le samhlacha is déanaí OpenAI. Is féidir leat foghlaim conas tosú leis trí úsáid a bhaint as ár dtreoir fhorbróra um ghiniúint téacs.
Amhail an 11 Márta 2025, tá bloic thógála ár n-ardáin nua Gníomhairí eisithe againn. Le haghaidh sonraí, féach ár ndoiciméid API don API Freagraí, Uirlisí lena n-áirítear Cuardach Gréasáin, Cuardach Comhad, agus Úsáid Ríomhaire, agus ár SDK Gníomhairí le Rianú.
Ó Leideanna go Teachtaireachtaí
Chun comhrá níos idirghníomhaí agus níos dinimiciúla a dhéanamh lenár samhlacha, is féidir leat teachtaireachtaí i bhformáid Chat a úsáid in ionad na seanfhormáide leide a úsáidtear le Completions.
Seo mar a oibríonn sé:
In ionad teaghrán leide amháin a sheoladh, seolann tú liosta d’oibiachtaí teachtaireachta mar ionchur.
Bíonn role ag gach teachtaireacht agus content inti de ghnáth.
I measc na ról coitianta tá system, user, assistant, developer agus tool. Úsáidtear teachtaireachtaí uirlise le haghaidh torthaí ó uirlisí nó feidhmeanna, agus ní mór dóibh a bheith ag freagairt do ghlaonna uirlise ón gcúntóir. Ar mhaithe le comhoiriúnacht siar, féadfar glacadh le teachtaireachtaí feidhme fós agus iad a thiontú ina dteachtaireachtaí uirlise agus iad á láimhseáil ar an bhfreastalaí. Féadfar teachtaireachtaí forbróra a athmhapáil ag brath ar an tacaíocht a thugann an tsamhail dóibh.
Sa content tá téacs na teachtaireachta ón ról.
Is féidir leis an treoir chórais treoracha ardleibhéil a thabhairt don chomhrá
Próiseáiltear na teachtaireachtaí san ord ina bhfuil siad sa liosta, agus freagraíonn an cúntóir dá réir.
Is féidir fiú iarratais bhunúsacha Completions a dhéanamh trí Chat Completions, mar a fheiceann tú thíos:
| Ansin | Anois |
|---|---|
'prompt' : 'tell me a joke' | 'messages': [{'role':'user', 'content':'tell me a joke'}] |
Anois, tá sé níos éasca ná riamh comhrá déthreo a dhéanamh leis an tsamhail ach liosta na dteachtaireachtaí sa chomhrá a leathnú.
'messages': [{'role':'user', 'content':'inis dom magadh'},
{'role':'assistant', 'content':'cén fáth ar thrasnaigh an sicín an bóthar'},
{'role':'user', 'content':'Níl a fhios agam, cén fáth ar thrasnaigh an sicín an bóthar'}]Treoracha Córais
Is féidir leat treoir ar leibhéal an chórais a úsáid freisin chun iompar na samhla a threorú ar feadh an chomhrá. Mar shampla, trí threoir chórais agus teachtaireacht mar seo a úsáid
'messages': [{'role':'system', 'content':'Is cúntóir thú a labhraíonn cosúil le Shakespeare.'},
{'role':'user', 'content':'inis dom magadh'}, beidh toradh cosúil leis seo mar thoradh air
{...
'message': {'role':'assistant',
'content':'Cén fáth ar thrasnaigh an sicín an bóthar? Chun dul go dtí an taobh eile, ach go deimhin, bhí an taobh eile lán de bhaol agus dainséar, mar sin d’fhill sé go tapa as ar tháinig sé, go fírinneach!'}
...}Más mian leat roghanna a fhiosrú nach gá duit stair chomhrá na dteachtaireachtaí a bhainistiú leat féin, féach ar an API Cúntóirí.