OpenAI Decisions
OpenAI Decisions es el modelo de decisión de OpenAI. Funciona igual que Laya y Jev: responde a una pregunta que tú defines y devuelve siempre una de las respuestas que has previsto, con lo segura que está de cada una. Cada respuesta posible es una salida del nodo, y el texto continúa solo por la de la respuesta elegida.
Lo que lo distingue es que también mira imágenes: una foto, un documento escaneado o una captura de pantalla, solas o junto a un texto. El texto y las imágenes se envían a OpenAI, y cada decisión se cobra en tu cuenta de OpenAI con la misma credencial que usas para sus modelos.
Cuándo usarlo
- Saber si la foto que manda un cliente muestra un producto dañado.
- Distinguir si un documento escaneado es una factura, un albarán o un contrato.
- Valorar la gravedad de una incidencia a partir de la captura de pantalla y del mensaje que la acompaña.
- Clasificar correos o tickets cuando ya trabajas con OpenAI y prefieres no dar de alta otro servicio.
Configuración
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial de OpenAI API. Elige una en Seleccionar una credencial o crea una con Crear nueva credencial, con la clave de tu cuenta de OpenAI. Más información en Credenciales. |
| Text | El texto sobre el que se decide. Conéctalo desde otro componente o escríbelo. Es obligatorio salvo que conectes imágenes. En Batch Mode, cambia a Mapped y arrastra el campo del elemento que contiene el texto. |
| Images | Las imágenes sobre las que se decide, solas o junto al texto. Para las fotos que te mandan por el chat, conecta la salida Binary de Chat Input; también acepta archivos y datos con la imagen. Si un mensaje llega sin foto, se decide solo con el texto. Admite PNG, JPEG, WEBP y GIF; otros formatos se convierten. Hasta 128 imágenes por decisión. |
| Decision | El tipo de decisión: Pick one (elegir una respuesta), Pick several (todas las que apliquen), Yes or no (sí o no) o Scale (un nivel de una escala). Por defecto: Pick one. Los campos y las salidas del nodo cambian según lo que elijas. |
| Question (obligatorio) | Lo que hay que decidir, en lenguaje normal y en el idioma de los textos. Por ejemplo: «¿Qué muestra la foto?». |
| Answers (obligatorio con Pick one y Pick several) | Una fila por respuesta: su nombre y cuándo elegirla. La descripción es lo que el modelo compara con el texto y las imágenes. Necesitas al menos dos respuestas y como máximo 50. |
| Levels (obligatorio con Scale) | Los niveles de la escala, de menor a mayor; por ejemplo baja, media, alta. Entre 2 y 10 niveles, sin nombres repetidos. |
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| Minimum confidence | Un valor entre 0 y 1. Si la respuesta es menos segura que este valor, el texto no sale por esa respuesta sino por una salida adicional Unsure, para que lo revise una persona. Con 0 (por defecto) está desactivado. |
| Model | El modelo de OpenAI que decide. Por defecto: gpt-6-luna, el único que admite hoy la API de decisiones. |
Procesamiento por lotes
Con el interruptor Batch Mode activado, el componente se ejecuta una vez por cada elemento de la lista que conectes en Batch Input y devuelve todos los resultados juntos en una lista. Parallel Executions indica cuántos elementos se procesan a la vez (de 1 a 5). Skip if Empty Batch Input salta el componente si la lista llega vacía, y Skip Branch if Empty Output detiene los componentes siguientes si el resultado está vacío. Más información en Conceptos clave.
La pregunta y las respuestas son las mismas para todos los elementos, y cada elemento sale por su propia respuesta.
Uso como herramienta de un agente
Puedes conectar este componente a la entrada Tools de un agente. En la pestaña Tool, Tool Name y Tool Description son el nombre y la explicación con los que el agente reconoce la herramienta y decide cuándo usarla: escribe una descripción clara de lo que hace.
Si los dejas vacíos, se forman a partir de tu pregunta y sus respuestas. El agente escribe él mismo el texto sobre el que decidir y recibe la decisión completa. Mientras el nodo está conectado como herramienta, las salidas por respuesta se ocultan.
Resultado
Las salidas son las mismas que en Laya y Jev:
- Una salida por respuesta (Pick one), por respuesta más None of them (Pick several), Yes y No (Yes or no) o una por nivel (Scale). Si has puesto un valor en Minimum confidence, aparece también Unsure. Solo la salida elegida lleva el texto (en Pick several, todas las que apliquen).
- Decision: el texto y su decisión como datos: la pregunta, el tipo de decisión, la respuesta elegida (
answer), lo segura que está (confidence), la probabilidad de cada respuesta (probabilities) y si quedó por debajo del mínimo de confianza (unsure).
Ejemplo
La tienda online Muebles Alameda recibe por el chat fotos de los pedidos que llegan con desperfectos. Con OpenAI Decisions:
- Conecta la salida Message de Chat Input a Text y su salida Binary a Images, y elige la credencial de OpenAI API.
- Deja Decision en Pick one y escribe en Question: «¿Qué muestra la foto?».
- En Answers añade dañado (un mueble roto, rayado o con la caja aplastada), pieza_equivocada (un mueble o una pieza que no corresponde al pedido) y otra_cosa (cualquier otra imagen).
- Conecta dañado a la apertura de una devolución, pieza_equivocada al equipo de logística y otra_cosa a un agente que pida al cliente una foto mejor.
Buenas prácticas
- Describe bien cada respuesta y escríbelas en el idioma de los textos.
- Añade una respuesta para lo que no encaja, como otra_cosa, para que una imagen inesperada no se fuerce en una respuesta equivocada.
- Una decisión por nodo. Para dos preguntas sobre la misma entrada, usa dos nodos.
Componentes relacionados
- Laya: el modelo de decisión propio de NappAI, sin credencial y sin enviar el texto fuera.
- Jev: el mismo tipo de decisión con el servicio de TypeSafe AI, para textos largos.
- Describe Image: describe una imagen con palabras en lugar de decidir sobre ella.