OpenAI Decisions API vs Structured Outputs

La diferencia real

Structured Outputs restringe la forma de la respuesta — el modelo debe producir JSON que coincida con tu esquema. Si le pides una etiqueta dentro de ese esquema, obtienes una etiqueta, y nada sobre las que quedaron atrás.

Una llamada de decisión restringe la semántica — el modelo elige una de tus respuestas finitas y devuelve una probabilidad por cada opción más un valor de confianza. La opción en segundo lugar y su probabilidad son el punto: te dicen si actuar automáticamente o escalar a un humano.

Lado a lado

Structured Outputs te da un campo enum parseable. El endpoint de decisión te da el mismo enum más la distribución detrás.

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

La versión de decisión

La misma tarea de enrutamiento, expresada como pregunta choice. La respuesta lleva el ganador, las probabilidades por opción y una confianza — suficiente para enrutar automáticamente a 0.8 y escalar por debajo.

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

Cuándo usar cuál

Usa Structured Outputs cuando necesites que el modelo produzca datos — extracción, relleno de formularios, respuestas multi-campo donde cada campo importa. Usa un endpoint de decisión cuando el trabajo del modelo es elegir una rama y necesitas saber qué tan cerrada fue la elección.

Se componen limpio: una llamada de decisión elige la ruta, luego una generación estructurada produce el payload para esa ruta.

Preguntas frecuentes