Ingeniería de IA
Decisions API: cómo clasificar solicitudes con IA
A veces tu aplicación solo necesita saber si un mensaje es una duda o una incidencia. Decisions API devuelve categorías y puntuaciones sin montar una conversación.
Cuando una categoría basta
Llega un mensaje a soporte y tu aplicación necesita enviarlo a la cola correcta. Decisions API de OpenAI permite evaluar texto e imágenes y obtener una categoría, una probabilidad o una puntuación.
La API se publicó en beta el 6 de octubre de 2026. La documentación actual mantiene esa condición, identifica gpt-6-luna como modelo disponible y utiliza POST /v1/decisions. La aplicación decide qué hacer con el resultado.
Tres formas de preguntar por la misma entrada
Una petición puede plantear varias preguntas sobre el mismo contenido. Predicate estima si se cumple una condición; choice elige entre tus categorías; score sitúa la entrada en una escala ordenada. Estos ejemplos ilustran el diseño, no respuestas obtenidas de una llamada real.
| Tipo | Qué devuelve | Ejemplo de pregunta |
|---|---|---|
| predicate | Probabilidad estimada entre 0 y 1 | ¿El mensaje menciona un fallo al guardar? |
| choice | Una opción de las categorías que defines | ¿Se refiere a móvil, web o plataforma desconocida? |
| score | Puntuación que pondera las posiciones de niveles ordenados por su probabilidad | ¿Qué prioridad corresponde según una escala definida? |
El fallo de Android que tiene una alternativa
Imagina este mensaje: «No puedo guardar mi entrenamiento desde Android, pero en la web funciona». Puedes preguntar qué plataforma falla y si se menciona un problema al guardar.
La prioridad exige algo más: definir qué significa baja, media o alta. El mensaje ofrece una alternativa, pero quizá esa persona no pueda usar la web. Si ese dato cambia la atención que va a recibir, pide la información o deriva el caso a revisión.
Score combina probabilidades sobre posiciones de la escala y puede devolver un valor entre niveles. Esa cifra necesita interpretarse con el criterio que hayas definido; no es una urgencia universal.
Clasificar, extraer datos y actuar son trabajos distintos
La guía recomienda Structured Outputs con Responses API cuando quieres un objeto con campos propios, y function calling cuando el modelo debe solicitar una herramienta con argumentos.
Elegir entre móvil y web encaja en una clasificación. Extraer un identificador y una descripción en tu JSON es otra salida. Abrir la incidencia añade una acción que la aplicación debe validar y autorizar. Puedes probar Decisions solo en la clasificación y conservar el resto del proceso.
Qué hacer cuando no hay una respuesta utilizable
Una pregunta puede recibir un refusal aunque otras de la misma petición sí se respondan. Distingue ese rechazo de un error técnico y de una clasificación válida. Un mensaje pendiente de revisión no necesita una categoría inventada para continuar.
Prueba solicitudes ambiguas o con varios problemas mezclados. Si usas un umbral de confianza, elígelo según los errores observados y el coste de equivocarte. Después compara los mismos casos con tu solución actual, incluyendo aciertos, tiempos y revisión necesaria.