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 sohbet yürütmek için completions ile kullanılan eski prompt biçimi yerine sohbet biçimindeki mesajları kullanabilirsiniz.
Şöyle çalışır:
Girdi olarak tek bir prompt dizesi göndermek yerine mesaj nesnelerinden oluşan bir liste gönderirsiniz.
Her mesajın bir role alanı ve genellikle bir content alanı 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ın araç çağrılarıyla eşleşmelidir. Geriye dönük uyumluluk amacıyla işlev mesajları hâlâ kabul edilebilir ve sunucu tarafından işlenirken araç mesajlarına dönüştürülebilir. Geliştirici mesajları, model desteğine bağlı olarak yeniden eşlenebilir.
content, ilgili rolün mesaj metnini içerir.
Sistem talimatı, sohbet için üst düzey yönergeler sağlayabilir
Mesajlar listede göründükleri sırayla işlenir ve asistan buna göre yanıt verir.
Temel Completions istekleri bile aşağıda görebileceğiniz gibi Chat Completions üzerinden tamamlanabilir:
| Önceden | Şimdi |
|---|---|
'prompt' : 'tell me a joke' | 'messages': [{'role':'user', 'content':'tell me a joke'}] |
Artık sohbetteki mesaj listesini genişleterek modelle karşılıklı konuşmak 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.