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: 3 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.

Prompt ke Pesan

Untuk melakukan percakapan yang lebih interaktif dan dinamis dengan model kami, Anda dapat menggunakan pesan dalam format obrolan, bukan gaya prompt lama yang digunakan dengan Completions.

Begini cara kerjanya:

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

  • Setiap pesan memiliki role dan biasanya content.

  • Peran yang umum meliputi system, user, assistant, developer, dan tool. Pesan tool digunakan untuk hasil tool/function dan harus sesuai dengan panggilan tool oleh assistant. Demi kompatibilitas mundur, pesan function mungkin masih diterima dan dikonversi menjadi pesan tool dalam penanganan server. Pesan developer dapat dipetakan ulang tergantung dukungan model.

  • content berisi teks pesan dari peran 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 yang sederhana pun 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, melakukan percakapan bolak-balik dengan model lebih mudah dari sebelumnya 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?