OpenAI Decisions API vs Structured Outputs

Реальная разница

Structured Outputs ограничивает форму ответа — модель обязана выдать JSON по вашей схеме. Попросите метку внутри схемы — получите метку и ничего про проигравшие варианты.

Вызов решения ограничивает семантику — модель выбирает один из ваших конечных ответов и возвращает вероятность для каждого варианта плюс значение уверенности. Второе место и его вероятность — в этом суть: они говорят, действовать ли автоматически или эскалировать человеку.

Рядом

Structured Outputs даёт парсибельное enum-поле. Эндпоинт решений даёт тот же enum плюс распределение за ним.

// 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"] }
        }
      }
    }
  }
}

Версия с решением

Та же задача маршрутизации в виде вопроса choice. Ответ несёт победителя, вероятности по вариантам и уверенность — достаточно, чтобы автоматически маршрутизировать от 0.8 и эскалировать ниже.

// 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."
      }
    }
  }
}

Когда что использовать

Используйте Structured Outputs, когда модель должна производить данные — извлечение, заполнение форм, многофельдные ответы, где важен каждый field. Используйте эндпоинт решений, когда задача модели — выбрать ветку, а вам нужно знать, насколько близким был выбор.

Они чисто комбинируются: вызов решения выбирает маршрут, затем структурированная генерация производит payload для этого маршрута.

Частые вопросы