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

Chat Completions, OpenAI'ın en yeni modelleriyle kullanılacak standart API'dir. Bununla çalışmaya başlamayı metin üretimi geliştirici kılavuzumuzdan öğrenebilirsiniz.

11 Mart 2025 itibarıyla yeni otonom ajan platformumuzun yapı taşlarını kullanıma sunduk. Ayrıntılar için Responses API, Web Search, File Search ve Computer Use dahil Araçlar ile Agents SDK ve Tracing için API belgelerimize bakın.

Komutlardan Mesajlara

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

İşleyiş şöyledir:

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

• Listedeki her mesajın iki özelliği vardır: role ve content.

  • 'role' üç değerden birini alabilir: 'system', 'user' veya 'assistant'

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

• Sistem talimatı konuşma için üst düzey yönergeler 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:

Artık, konuşmadaki mesaj listesini genişleterek modelle karşılıklı konuşmalar yapmak 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ı

Modelin davranışını konuşma boyunca yönlendirmek için sistem düzeyinde bir talimat da kullanabilirsiniz. Örneğin, şöyle bir sistem talimatı ve 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ç verecektir

{...
'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önetmekle uğraşmayı gerektirmeyen seçenekleri keşfetmek isterseniz, Assistants API'sine göz atın.