Chat Completions ialah API standard untuk digunakan dengan model terkini OpenAI. Anda boleh mengetahui cara bermula dengannya menggunakan panduan pembangun penjanaan teks kami.
Mulai 11 Mac 2025, kami telah mengeluarkan komponen asas platform Agents baharu kami. Untuk butiran, lihat dokumentasi API kami bagi Responses API, alat termasuk Web Search, File Search dan Computer Use, serta Agents SDK kami dengan Tracing.
Daripada Prom kepada Mesej
Untuk berbual dengan model kami secara lebih interaktif dan dinamik, anda boleh menggunakan mesej dalam format sembang dan bukannya gaya prom lama yang digunakan dengan Completions.
Begini caranya:
Daripada menghantar satu rentetan prom, anda menghantar senarai objek mesej sebagai input.
Setiap mesej mempunyai role dan biasanya content.
Role yang lazim termasuk system, user, assistant, developer dan tool. Mesej tool digunakan untuk hasil alat/fungsi dan mesti sepadan dengan panggilan alat oleh assistant. Untuk keserasian ke belakang, mesej function mungkin masih diterima dan ditukar kepada mesej tool semasa diproses oleh pelayan. Mesej developer mungkin dipetakan semula bergantung pada sokongan model.
content mengandungi teks mesej daripada role tersebut.
Arahan system boleh memberikan arahan umum untuk perbualan
Mesej diproses mengikut susunan kemunculannya dalam senarai, lalu assistant memberikan respons yang sewajarnya.
Malah, permintaan asas Completions boleh diselesaikan melalui Chat Completions, seperti yang ditunjukkan di bawah:
| Dahulu | Kini |
|---|---|
'prompt' : 'tell me a joke' | 'messages': [{'role':'user', 'content':'tell me a joke'}] |
Kini, perbualan dua hala dengan model menjadi lebih mudah dengan menambahkan mesej pada senarai mesej dalam perbualan.
'messages': [{'role':'user', 'content':'ceritakan jenaka kepada saya'},
{'role':'assistant', 'content':'mengapa ayam itu melintas jalan'},
{'role':'user', 'content':'Saya tidak tahu, mengapa ayam itu melintas jalan'}]Arahan Sistem
Anda juga boleh menggunakan arahan peringkat sistem untuk memandu tingkah laku model sepanjang perbualan. Contohnya, menggunakan arahan sistem dan mesej seperti ini
'messages': [{'role':'system', 'content':'Anda ialah pembantu yang bercakap seperti Shakespeare.'},
{'role':'user', 'content':'ceritakan jenaka kepada saya'}, akan menghasilkan sesuatu seperti
{...
'message': {'role':'assistant',
'content':'Mengapa ayam itu melintas jalan? Untuk sampai ke seberang, tetapi sesungguhnya, seberang itu penuh bahaya dan ancaman, lalu ia segera kembali ke tempat asalnya, benarlah!'}
...}Jika anda mahu meneroka pilihan yang tidak memerlukan anda mengurus sendiri sejarah perbualan mesej, lihat Assistants API.