OpenAI
Bu sayfanın çevirisi otomatik olarak yapılmıştır. Orijinal İngilizce makaleyi görüntüleyin.

OpenAI API’de Completions’tan Chat Completions’a geçiş

Eski OpenAI Completions API’sinden Chat Completions’a nasıl geçilir

Güncellenme zamanı: 6 hours ago

Chat Completions, OpenAI'ın en yeni modelleriyle kullanılacak standart API'dir. Başlamayı, metin oluşturma geliştirici kılavuzumuzu kullanarak öğrenebilirsiniz.

11 Mart 2025 itibarıyla yeni Otonom Ajanlar platformumuzun yapı taşlarını kullanıma sunduk. Ayrıntılar için Responses API API belgelerimize, Web Arama, Dosya Arama ve Bilgisayar Kullanımı dahil araçlara ve İzleme içeren Otonom Ajanlar SDK sayfamıza bakın.

Komutlardan Mesajlara

Modellerimizle daha etkileşimli ve dinamik bir konuşma yapmak için completions ile kullanılan eski komut stili yerine sohbet biçimindeki mesajları kullanabilirsiniz.

İşleyişi şöyle:

  • Komutunuz olarak tek bir dize göndermek yerine, girdi olarak bir mesaj listesi gönderirsiniz.

  • Her mesajın bir role ve content değeri vardır.

  • Yaygın roller arasında system, user, assistant, developer ve tool bulunur. Araç mesajları, araç/işlev sonuçları için kullanılır ve asistan araç çağrılarıyla eşleşmelidir. Geriye dönük uyumluluk için işlev mesajları hâlâ kabul edilebilir ve sunucu işleyişinde araç mesajlarına dönüştürülebilir. Geliştirici mesajları, model desteğine bağlı olarak yeniden eşlenebilir.

  • content, rolden gelen mesajın metnini içerir.

  • Sistem talimatı, konuşma için üst düzey talimatlar verebilir

  • Mesajlar listede göründükleri sırayla işlenir ve asistan buna göre yanıt verir.

Aşağıda görebileceğiniz gibi, temel Completions istekleri bile Chat Completions üzerinden tamamlanabilir:

| Önceden | Şimdi | | 'prompt' : 'tell me a joke' | 'messages': <br>[{'role':'user', 'content':'tell me a joke'}] |

Artık konuşmadaki mesaj listesini genişleterek modelle karşılıklı etkileşimler kurmak her zamankinden daha kolay.

'messages': [{'role':'user', 'content':'bana bir fıkra anlat'}, 
{'role':'assistant', 'content':'tavuk neden yolun karşısına geçti'},
{'role':'user', 'content':'Bilmiyorum, tavuk neden yolun karşısına geçti'}]

Sistem Talimatları

Konuşma boyunca modelin davranışını yönlendirmek için sistem düzeyinde bir talimat da kullanabilirsiniz. Örneğin, bir sistem talimatı ve buna benzer bir mesaj kullanmak

'messages': [{'role':'system', 'content':'Shakespeare gibi konuşan bir asistansın.'}, 
{'role':'user', 'content':'bana bir fıkra anlat'},

şuna benzer bir sonuç verir

{...
'message': {'role':'assistant',
'content':'Tavuk neden yolun karşısına geçti? Öbür tarafa varmak için, ama doğrusu öbür taraf tehlike ve riskle doluydu, bu yüzden hızla geldiği yere geri döndü, doğrusu!'}
...}

Mesaj konuşma geçmişini kendiniz yönetmenizi gerektirmeyen seçenekleri keşfetmek istiyorsanız Assistants API'ye göz atın.

Bu makale yararlı oldu mu?