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.
Promptlardan Mesajlara
Modellerimizle daha etkileşimli ve dinamik bir konuşma yapmak için completions ile kullanılan eski prompt tarzı yerine sohbet biçimindeki mesajları kullanabilirsiniz.
İşleyiş şöyle:
Tek bir prompt dizesi göndermek yerine, girdi olarak mesaj nesnelerinden oluşan bir liste gönderirsiniz.
Her mesajda bir
rolebulunur ve genelliklecontentde yer alır.Yaygın roller arasında
system,user,assistant,developervetoolbulunur. 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 function mesajları hâlâ kabul edilebilir ve sunucu tarafındaki işlemede tool mesajlarına dönüştürülebilir. Developer mesajları, model desteğine bağlı olarak yeniden eşlenebilir.content, ilgili rolden gelen mesajın metnini içerir.Sistem talimatı, konuşma için genel 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 Sohbet Tamamlamaları üzerinden tamamlanabilir:
| Eskiden | Ş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ı diyalog 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.