Inworld Decisions

Inworld Decisions toma decisiones con los modelos de decisión que ofrece Inworld, todos con una sola credencial. Funciona igual que Laya, Jev y OpenAI Decisions: 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.

Puede decidir sobre un texto, sobre imágenes (una foto, un documento escaneado, una captura de pantalla) o sobre ambos. El texto y las imágenes se envían a Inworld, y cada decisión se cobra en tu cuenta de Inworld con la misma credencial que usas para su voz o sus modelos de texto. Cada decisión tarda menos de medio segundo.

Cuándo usarlo

Decidir a qué equipo va un correo o un ticket: facturación, soporte o ventas.
Saber si un cliente amenaza con darse de baja, o cuánta urgencia o enfado transmite.
Etiquetar mensajes con todas las categorías que apliquen.
Saber si la foto que manda un cliente muestra un producto dañado, o qué tipo de documento es un escaneo.
Cuando ya trabajas con Inworld y prefieres no dar de alta otro servicio.

Configuración

Campo	Qué hace
Credential (obligatorio)	La credencial de Inworld API. Elige una en Seleccionar una credencial o crea una con Crear nueva credencial, con la clave Base64 de tu cuenta de Inworld. Más información en Credenciales.
Model	El modelo que decide. La lista muestra los modelos de decisión que permite tu cuenta de Inworld y se carga al elegir la credencial; el botón de actualizar la vuelve a pedir. Algunos solo leen texto. Por defecto: `perplexity/pplx-decider-v1.2`.
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 y WEBP; otros formatos se convierten. Algunos modelos admiten hasta 8 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é equipo debe atender este mensaje?».
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.

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, Jev y OpenAI Decisions:

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).
Decision Model: el propio nodo, para conectarlo al conector Barge-in Decision de un Voice Agent, que le hace su propia pregunta sobre un llamante que habla mientras el agente habla. Conectado así, el nodo oculta su texto, su pregunta, sus respuestas y sus salidas por respuesta, porque no se usan.

Ejemplo

Una empresa de software recibe en un buzón los correos de sus clientes y quiere que cada uno llegue al equipo correcto. Con Inworld Decisions:

Conecta el cuerpo del correo a Text y elige la credencial de Inworld API.
Deja Decision en Pick one y escribe en Question: «¿Qué equipo debe atender este mensaje?».
En Answers añade facturacion (facturas, cobros, devoluciones), soporte (errores, caídas, la aplicación no funciona) y ventas (precios, ampliar el plan, contratar).
Conecta cada salida al equipo que corresponde. Si además pones Minimum confidence en 0,7, los correos dudosos salen por Unsure para que los reparta una persona.

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 un mensaje inesperado no se fuerce en una respuesta equivocada.
Una decisión por nodo. Para dos preguntas sobre la misma entrada, usa dos nodos.
Para imágenes, elige un modelo que las lea. Si el modelo elegido solo lee texto, el componente se detiene con un error que lo indica.

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.
OpenAI Decisions: el mismo tipo de decisión con tu cuenta de OpenAI.