OpenAI Decisions API vs Structured Outputs

Gerçek fark

Structured Outputs yanıtın biçimini kısıtlar — model şemanıza uyan JSON üretmek zorundadır. O şema içinde bir etiket isterseniz bir etiket alırsınız ve ikinciler hakkında hiçbir şey bilmezsiniz.

Bir karar çağrısı anlamı kısıtlar — model sonlu yanıtlarınızdan birini seçer ve her seçenek için bir olasılık artı bir güven değeri döndürür. İkinci seçenek ve olasılığı asıl mesele: otomatik davranıp davranmayacağınızı veya bir insana yükseltip yükseltmeyeceğinizi söyler.

Yan yana

Structured Outputs size ayrıştırılabilir bir enum alanı verir. Karar uç noktası aynı enum'ı arkasındaki dağılımla birlikte verir.

// Structured Outputs: the model fills a JSON schema.
// You get a parseable label — not a probability per option.
{
  "response_format": {
    "type": "json_schema",
    "json_schema": {
      "name": "route",
      "schema": {
        "type": "object",
        "properties": {
          "team": { "enum": ["payments", "frontend", "account"] }
        }
      }
    }
  }
}

Karar versiyonu

Aynı yönlendirme görevi, bir choice sorusu olarak ifade edildi. Yanıt; kazananı, seçenek başına olasılıkları ve bir güven taşır — 0.8'de otomatik yönlendirip altında yükseltmek için yeterli.

// Decision endpoint: the answer carries a probability
// for every option plus a confidence — enough to set a threshold.
{
  "model": "decisions-1",
  "state": "The page renders blank in Safari.",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Which team should own this ticket?",
      "criteria": {
        "payments": "Checkout or billing.",
        "frontend": "Rendering or browser behavior.",
        "account": "Login or permissions."
      }
    }
  }
}

Hangisini ne zaman kullanmalı

Modelin veri üretmesi gerektiğinde Structured Outputs kullanın — çıkarım, form doldurma, her alanın önemli olduğu çok alanlı yanıtlar. Modelin işi bir dal seçmek olduğunda ve seçimin ne kadar yakın olduğunu bilmeniz gerektiğinde karar uç noktası kullanın.

Temiz şekilde birleşirler: karar çağrısı rotayı seçer, sonra yapılandırılmış bir üretim o rotanın yükünü üretir.

SSS