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
Agar percakapan dengan model kami lebih interaktif dan dinamis, Anda dapat menggunakan pesan dalam format chat, bukan gaya prompt lama yang digunakan dengan Completions.
Berikut cara kerjanya:
Alih-alih mengirim satu string prompt, Anda mengirim daftar objek pesan sebagai input.
Setiap pesan memiliki role dan biasanya content.
Role yang umum mencakup system, user, assistant, developer, dan tool. Pesan tool digunakan untuk hasil tool/fungsi dan harus sesuai dengan pemanggilan tool oleh assistant. Demi kompatibilitas mundur, pesan function mungkin masih diterima dan dikonversi menjadi pesan tool saat diproses oleh server. Pesan developer dapat dipetakan ulang, tergantung dukungan model.
Bagian content berisi teks pesan dari role tersebut.
Instruksi system dapat memberikan arahan umum untuk percakapan
Pesan diproses sesuai urutan kemunculannya dalam daftar, lalu assistant merespons berdasarkan urutan tersebut.
Bahkan permintaan Completions dasar dapat diproses melalui Chat Completions, seperti yang terlihat di bawah ini:
| Dulu | Sekarang |
|---|---|
'prompt' : 'tell me a joke' | 'messages': [{'role':'user', 'content':'tell me a joke'}] |
Kini, percakapan timbal balik dengan model menjadi lebih mudah dari sebelumnya: cukup tambahkan pesan ke 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.