OpenAI
Halaman ini diterjemahkan oleh mesin. Lihat artikel asli dalam bahasa Inggris.

Beralih dari Completions ke Chat Completions di OpenAI API

Cara bermigrasi dari OpenAI Completions API lama ke Chat Completions

Diperbarui: 9 days ago

Chat Completions adalah API standar untuk digunakan dengan model terbaru OpenAI. Anda dapat mempelajari cara memulainya menggunakan panduan developer pembuatan teks kami.

Per 11 Maret 2025, kami telah merilis blok penyusun platform Agents baru kami. Untuk detail, lihat dokumentasi API kami untuk Responses API, Tools termasuk Pencarian Web, Pencarian File, dan Penggunaan Komputer, serta Agents SDK kami dengan Pelacakan.

Dari Prompt ke Pesan

Untuk melakukan percakapan yang lebih interaktif dan dinamis dengan model kami, Anda dapat menggunakan pesan dalam format chat alih-alih gaya prompt lama yang digunakan dengan completions.

Begini cara kerjanya:

  • Alih-alih mengirim satu string sebagai prompt, Anda mengirim daftar pesan sebagai input.

  • Setiap pesan memiliki role dan content.

  • Role umum mencakup system, user, assistant, developer, dan tool. Pesan tool digunakan untuk hasil tool/fungsi dan harus sesuai dengan panggilan tool oleh assistant. Untuk kompatibilitas mundur, pesan function mungkin masih diterima dan dikonversi menjadi pesan tool dalam penanganan server. Pesan developer dapat dipetakan ulang bergantung pada dukungan model.

  • content berisi teks pesan dari role tersebut.

  • Instruksi sistem dapat memberikan instruksi tingkat tinggi untuk percakapan

  • Pesan diproses sesuai urutan kemunculannya dalam daftar, dan assistant merespons sesuai urutan tersebut.

Bahkan permintaan Completions dasar dapat diselesaikan melalui Chat Completions, seperti yang dapat Anda lihat di bawah:

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

Kini, lebih mudah dari sebelumnya untuk melakukan percakapan bolak-balik dengan model dengan memperluas daftar pesan dalam percakapan.

'messages': [{'role':'user', 'content':'ceritakan lelucon'}, 
{'role':'assistant', 'content':'mengapa ayam menyeberang jalan'}, 
{'role':'user', 'content':'Saya tidak tahu, mengapa ayam menyeberang jalan'}]

Instruksi Sistem

Anda juga dapat menggunakan instruksi tingkat sistem untuk memandu perilaku model sepanjang percakapan. Misalnya, menggunakan instruksi sistem dan pesan seperti ini

'messages': [{'role':'system', 'content':'Anda adalah asisten yang berbicara seperti Shakespeare.'}, 
{'role':'user', 'content':'ceritakan lelucon'},

akan menghasilkan sesuatu seperti

{...
'message': {'role':'assistant',
              'content':'Mengapa ayam menyeberang jalan? Untuk sampai ke sisi seberang, tetapi sesungguhnya, sisi seberang penuh bahaya dan ancaman, jadi ia segera kembali ke tempat asalnya, sungguh!'}
...}

Jika Anda ingin menjelajahi opsi yang tidak mengharuskan Anda mengelola sendiri riwayat percakapan pesan, lihat Assistants API.

Apakah artikel ini membantu?