Azure OpenAI'ın Decisions API'si genel kullanıma açıldı: Üretilmiş metin yerine skorlar döndürüyor

Sohbet modeli yerine bir skorlama uç noktası

Microsoft, Azure OpenAI için Decisions API'yi Microsoft Foundry içinde genel kullanıma açtı; bu bilgiye, 22 Ekim 2026 tarihli bir Foundry duyurusuna atıfta bulunan Taswar Bhatti'nin dev.to'daki rehberinden ulaşıyoruz. Uç nokta metin üretmek yerine, metin veya görsel gibi bir girdiyi değerlendirip tipli bir yanıt döndürüyor: bir olasılık, çağıran tarafın tanımladığı bir listeden bir seçim ya da bir rubrik üzerinde konumlanan bir skor.

API'nin hedeflediği sorun, agent geliştiren herkese tanıdık gelecektir. Bir biletin hangi ekibe ait olduğu, müşterinin iade isteyip istemediği veya bir sorunun ne kadar ciddi olduğu gibi küçük yargılamalar genellikle bir sohbet modeli üzerinden yürütülür. Bu da JSON için prompt yazmayı, yalnızca geçerli JSON'a benzeyen yanıtları ele almayı ve modelin böyle bir garanti vermediği halde belirtilen bir güven skorunu anlamlı saymayı gerektirir. Bhatti'ye göre Decisions API, bu deseni çağıran tarafın güvenebileceği yapılandırılmış yanıtlarla değiştiriyor.

Üç soru tipi, tek bir paylaşılan girdi

Yazıda özetlendiği şekliyle Foundry duyurusuna göre API, her soru tipine karşılık gelen üç sonuç destekliyor:

• Probability (predicate adıyla), bir koşulun geçerli olup olmadığını 0 ile 1 arasında bir değer olarak döndürür
• Choice, çağıran tarafın tanımladığı bir listeden bir değer seçer
• Score, girdiyi sıralı bir rubrik üzerine yerleştirir

Bir istek, tek bir paylaşılan girdi ve her biri benzersiz bir ada sahip bir sorular dizisi taşır; böylece yanıtlar sorularıyla eşleştirilebilir. Yanıt, aynı sırada bir answers dizisi ve token kullanımını döndürür. Her istek en fazla 400 soru destekler ve bir istekteki tüm sorular aynı girdiyi görür.

Uç nokta, standart Azure OpenAI kaynak alanı altındaki decisions yolunda yer alıyor. model alanı deployment adını alır; dokümantasyonda gpt-6-luna kullanılıyor ve Bhatti, şu anda yalnızca bu modelin desteklendiğini belirtiyor. Kimlik doğrulama, bir header'da gönderilen API key veya bir Microsoft Entra ID bearer token ile yapılabilir.

Yazıya göre dokümanlardaki iki davranışa dikkat çekmek gerek. Bir red (refusal), düşük bir olasılık olarak değil, kendi yanıt tipi olarak geri gelir; bu yüzden uygulama kodunda ayrıca ele alınması gerekir. Ayrıca tüm sorular tek bir girdiyi paylaştığından, tek bir istek aynı içeriği aynı anda birkaç eksende sınıflandırabilir.

Microsoft-Decision-1 ile ilişkisi

Yazı, yeni API'yi, düz metin yerine skorlu yargılamalar döndüren daha erken tarihli bir Microsoft sağlayıcı yolu olan Microsoft-Decision-1 ile karşılaştırıyor. İkisi uç nokta ve soru tipi adlarıyla ayrışıyor; yazı, Decision-1 için noul, choice ve score, Azure API için ise predicate, choice ve score listeliyor. Kimlik doğrulama da farklı: Decision-1 yalnızca Entra ID kullanırken Decisions API bir API key de kabul ediyor. Dokümantasyon kapsamı da değişik: Decision-1 hızlı başlangıç kılavuzu SDK örnekleri olmadan yayımlandı, Decisions API dokümanları ise Python, JavaScript ve REST örnekleri içeriyor. İkisi de tipli yanıtlar döndürüyor.

C#'tan çağırma

Resmî dokümantasyon, uç nokta için bir C# SDK göstermediğinden rehber onu HttpClient ile çağırıyor. GitHub'da OpenAI-DecisionApi-CSharp-Sample olarak yayımlanan örnek proje .NET 10'u hedefliyor ve uç nokta ile kimlik bilgilerinin kaynak kodda değil kullanıcı gizli dizilerinde ya da ortam değişkenlerinde kalması için Azure.Identity ile yapılandırma paketlerini içeriyor.

Bir API key yapılandırılmışsa uygulama onu gönderir; aksi halde DefaultAzureCredential'a geri düşer, yani normal bir az login yeterlidir. Örnek, resmî Python örneğini yansıtıyor: yinelenen bir tahsilatla ilgili bir destek bileti, iade istenip istenmediğini, dört departmandan hangisinin ele alması gerektiğini ve üç rubrik seçeneğinden belirlenen bir ciddiyet düzeyini kapsayan üç soruyla değerlendiriliyor. Aynı soruları çalıştırmak, çıktının belgelenmiş sonuçlarla doğrudan karşılaştırılabilmesini sağlıyor.

Neden önemli

Agent'lar iş akışı başına çok sayıda küçük sınıflandırma kararı verir ve bunları chat completions üzerinden yürütmek token'ları düz metne harcar, ayrıştırma hatalarına davetiye çıkarır ve hiç kalibre edilmemiş güven sayıları üretir. Olasılık, seçim ve rubrik skorları döndüren adanmış bir uç nokta, bu işi test etmesi daha kolay ve üretimde daha az kırılgan olan tipli bir sözleşmeye taşır. Zaten Azure OpenAI kullanan .NET ekipleri için genel kullanıma açılma, bu yeteneğin artık mevcut kaynak, kimlik doğrulama ve deployment araçlarının arkasında olduğu anlamına gelir; ancak rehberin gösterdiği gibi, C# SDK örneği bulunmadığından şu anda HTTP çağrısını elle yazmaları gerekiyor. 400 soruluk batch limiti ve redyi ayrı bir yanıt tipi yapma kararı, Microsoft'un yapılandırılmış yargılamayı bir prompt mühendisliği geçici çözümü değil, birinci sınıf bir API yüzeyi olarak gördüğüne işaret ediyor.