Chat Completions ndiyo API ya kawaida ya kutumia na miundo mipya zaidi ya OpenAI. Unaweza kujifunza jinsi ya kuanza kuitumia kupitia mwongozo wetu wa wasanidi programu wa uzalishaji wa maandishi.
Kufikia Machi 11, 2025, tumetoa vipengele vya msingi vya jukwaa letu jipya la Mawakala. Kwa maelezo, angalia nyaraka zetu za API za Responses API, Zana ikijumuisha Utafutaji wa Wavuti, Utafutaji wa Faili, na Matumizi ya Kompyuta, na Agents SDK yetu yenye Ufuatiliaji.
Kubadilisha Dokeza kuwa Ujumbe
Ili kuwa na mazungumzo shirikishi na yanayobadilika zaidi na miundo yetu, unaweza kutumia ujumbe katika muundo wa Chat badala ya mtindo wa zamani wa dokeza uliotumiwa na Completions.
Hivi ndivyo inavyofanya kazi:
Badala ya kutuma mfuatano mmoja wa dokeza, unatuma orodha ya vipengee vya ujumbe kama ingizo lako.
Kila ujumbe una role na kwa kawaida content.
Role zinazotumika sana ni pamoja na system, user, assistant, developer na tool. Ujumbe wa tool hutumiwa kwa matokeo ya zana/function na lazima ulingane na miito ya zana ya assistant. Kwa uoanifu na matoleo ya awali, ujumbe wa function bado unaweza kukubaliwa na kubadilishwa kuwa ujumbe wa tool unapochakatwa kwenye seva. Ujumbe wa developer unaweza kupewa role nyingine kulingana na uwezo wa muundo.
Sehemu ya content ina maandishi ya ujumbe kutoka kwa role hiyo.
Maagizo ya system yanaweza kutoa maelekezo ya jumla ya mazungumzo
Ujumbe huchakatwa kwa mpangilio unaoonekana kwenye orodha, kisha assistant hujibu ipasavyo.
Hata maombi ya msingi ya Completions yanaweza kukamilishwa kupitia Chat Completions, kama unavyoona hapa chini:
| Awali | Sasa |
|---|---|
'prompt' : 'tell me a joke' | 'messages': [{'role':'user', 'content':'tell me a joke'}] |
Sasa ni rahisi zaidi kuliko hapo awali kufanya mazungumzo ya kupokezana na muundo kwa kuongeza ujumbe kwenye orodha ya mazungumzo.
'messages': [{'role':'user', 'content':'niambie mzaha'},
{'role':'assistant', 'content':'kwa nini kuku alivuka barabara'},
{'role':'user', 'content':'Sijui, kwa nini kuku alivuka barabara'}]Maagizo ya Mfumo
Unaweza pia kutumia agizo la kiwango cha mfumo kuongoza tabia ya muundo katika mazungumzo yote. Kwa mfano, kutumia agizo la mfumo na ujumbe kama huu
'messages': [{'role':'system', 'content':'Wewe ni msaidizi anayezungumza kama Shakespeare.'},
{'role':'user', 'content':'niambie mzaha'}, itasababisha kitu kama
{...
'message': {'role':'assistant',
'content':'Kwa nini kuku alivuka barabara? Ili afike upande wa pili, lakini kwa hakika, upande wa pili ulikuwa umejaa hatari na mashaka, hivyo akarudi haraka alikotoka, kwa kweli!'}
...}Ikiwa unataka kuchunguza chaguo ambazo hazihitaji udhibiti historia ya mazungumzo ya ujumbe wewe mwenyewe, angalia Assistants API.