OpenAI
Halaman ini diterjemah oleh mesin. Lihat artikel asal dalam bahasa Inggeris.

Beralih daripada Completions kepada Chat Completions dalam API OpenAI

Cara berhijrah daripada API Completions OpenAI lama kepada Chat Completions

Dikemas kini: 7 days ago

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 Prompt kepada Mesej

Untuk berinteraksi dengan model kami secara lebih interaktif dan dinamik, anda boleh menggunakan mesej dalam format sembang dan bukannya gaya prompt lama yang digunakan dengan Completions.

Begini cara ia berfungsi:

  • Daripada menghantar satu rentetan prompt, anda menghantar senarai objek mesej sebagai input anda.

  • Setiap mesej mempunyai role dan biasanya content.

  • Peranan biasa termasuk system, user, assistant, developer dan tool. Mesej alat digunakan untuk hasil alat/fungsi dan mesti sepadan dengan panggilan alat oleh pembantu. Untuk keserasian ke belakang, mesej fungsi mungkin masih diterima dan ditukar kepada mesej alat dalam pengendalian pelayan. Mesej pembangun mungkin dipetakan semula bergantung pada sokongan model.

  • content mengandungi teks mesej daripada peranan tersebut.

  • Arahan sistem boleh memberikan arahan peringkat tinggi untuk perbualan

  • Mesej diproses mengikut susunan kemunculannya dalam senarai, dan pembantu membalas sewajarnya.

Permintaan Completions asas pun boleh diselesaikan melalui Chat Completions, seperti yang anda lihat di bawah:

| Dahulu | Kini | | 'prompt' : 'tell me a joke' | 'messages': <br>[{'role':'user', 'content':'tell me a joke'}] |

Kini, lebih mudah daripada sebelumnya untuk berbual secara ulang-alik dengan model dengan menambahkan mesej pada senarai 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.

Adakah artikel ini membantu?