OpenAI Decisions API vs Structured Outputs

A diferença real

Structured Outputs restringe a forma da resposta — o modelo deve produzir JSON que bata com seu esquema. Se você pedir um rótulo dentro desse esquema, recebe um rótulo, e nada sobre os que ficaram para trás.

Uma chamada de decisão restringe a semântica — o modelo escolhe uma das suas respostas finitas e retorna uma probabilidade para cada opção mais um valor de confiança. A opção em segundo lugar e sua probabilidade são o ponto: dizem se deve agir automaticamente ou escalar para um humano.

Lado a lado

Structured Outputs dá um campo enum parseável. O endpoint de decisão dá o mesmo enum mais a distribuição por trás dele.

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

A versão de decisão

A mesma tarefa de roteamento, expressa como pergunta choice. A resposta carrega o vencedor, as probabilidades por opção e uma confiança — suficiente para rotear automaticamente em 0.8 e escalar abaixo.

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

Quando usar cada um

Use Structured Outputs quando precisar que o modelo produza dados — extração, preenchimento de formulários, respostas multi-campo onde cada campo importa. Use um endpoint de decisão quando o trabalho do modelo é escolher um ramo e você precisa saber quão apertada foi a escolha.

Eles se compõem bem: uma chamada de decisão escolhe a rota, depois uma geração estruturada produz o payload para aquela rota.

Perguntas frequentes