Chat Completions adalah API standar untuk digunakan dengan model terbaru OpenAI. Anda dapat mempelajari cara memulainya lewat panduan developer text generation kami.
Mulai 11 Maret 2025, kami telah merilis komponen penyusun dari platform Agents baru kami. Untuk detailnya, lihat dokumentasi API kami untuk Responses API, Tools termasuk Web Search, File Search, dan Computer Use, serta Agents SDK kami dengan Tracing.
Dari Prompt ke Messages
Untuk melakukan percakapan yang lebih interaktif dan dinamis dengan model kami, Anda dapat menggunakan messages dalam format chat alih-alih gaya prompt lama yang digunakan pada completions.
Berikut cara kerjanya:
Alih-alih mengirim satu string sebagai prompt, Anda mengirim daftar messages sebagai input.
Setiap message dalam daftar memiliki dua properti: role dan content.
'role' dapat bernilai salah satu dari tiga: 'system', 'user', atau 'assistant'
'content' berisi teks message dari role tersebut.
Instruksi system dapat memberikan instruksi tingkat tinggi untuk percakapan
Messages diproses sesuai urutan kemunculannya dalam daftar, dan assistant merespons sesuai itu.
Bahkan permintaan Completions yang sederhana pun dapat dilakukan melalui Chat Completions, seperti yang dapat Anda lihat di bawah ini:
| Dulu | Sekarang |
'prompt' : 'ceritakan lelucon' | 'messages': [{'role':'user', 'content':'ceritakan lelucon'}] |
Sekarang, melakukan percakapan bolak-balik dengan model jadi lebih mudah daripada sebelumnya dengan memperpanjang daftar messages 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 System
Anda juga dapat menggunakan instruksi tingkat system untuk memandu perilaku model sepanjang percakapan. Misalnya, menggunakan instruksi system dan message 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 sang ayam menyeberangi jalan? Agar sampai ke seberang, namun sungguh, seberang itu penuh mara bahaya dan ancaman, maka ia lekas kembali dari tempat asalnya, sungguh!'}
...}Jika Anda ingin mengeksplorasi opsi yang tidak mengharuskan Anda mengelola sendiri riwayat percakapan messages, lihat Assistants API.