Laya
Laya es el modelo de decisión de NappAI. No redacta texto: lee un texto (un correo, un ticket, un mensaje de chat), responde a una pregunta que tú defines y devuelve siempre una de las respuestas que has previsto, junto con lo segura que está de cada una.
Cada respuesta posible es una salida del nodo. El texto continúa solo por la salida de la respuesta elegida, así que el flujo se bifurca directamente según la decisión, sin añadir un componente de enrutado. Laya funciona dentro de NappAI: el texto no se envía a ningún servicio externo y no necesitas credencial.
Cuándo usarlo
- Repartir los mensajes que llegan al equipo que debe atenderlos: facturación, soporte técnico o ventas.
- Etiquetar correos o solicitudes con todos los temas que tratan.
- Decidir si un mensaje es una queja o si el cliente amenaza con darse de baja, para avisar a una persona.
- Clasificar la urgencia de una incidencia en niveles (baja, media, alta).
- Darle a un agente una herramienta de clasificación fiable, que siempre responde con una de tus opciones.
Configuración
| Campo | Qué hace |
|---|---|
| Text (obligatorio) | El texto sobre el que se decide. Conéctalo desde otro componente o escríbelo. En Batch Mode, cambia a Mapped y arrastra el campo del elemento que contiene el texto. |
| 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 Laya compara con el texto, así que cuanto más concreta, mejor. 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. |
| Long text | Lee textos más largos: hasta unas 3.000 palabras en lugar de unas 700. Cada decisión tarda más. Desactivado por defecto. |
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.
En Laya, solo el texto cambia de un elemento a otro: la pregunta y las respuestas son las mismas para todos, 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, Laya los forma a partir de tu pregunta y sus respuestas, de modo que puedes conectar varios nodos Laya al mismo agente sin que se confundan. 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 del nodo dependen del tipo de decisión:
| Decision | Salidas |
|---|---|
| Pick one | Una salida por respuesta, con su nombre. |
| Pick several | Una salida por respuesta y además None of them, por la que sale el texto si no aplica ninguna. El texto sale por todas las respuestas que apliquen. |
| Yes or no | Yes y No. |
| Scale | Una salida por nivel. |
Si has puesto un valor en Minimum confidence, aparece también la salida Unsure. Conecta a cada salida lo que deba pasar con esa respuesta: las que no se eligen no ejecutan nada.
La salida Decision trae siempre el texto y su decisión como datos: la pregunta (question), el tipo de decisión (decision), 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). En Yes or no, la respuesta es verdadero o falso y se añade la probabilidad de sí (probability). En Scale se añade la posición del nivel (level). En Pick several, la respuesta es la lista de respuestas que aplican.
Ejemplo
La empresa Distribuciones Levante recibe en un mismo buzón correos de clientes y quiere que cada uno llegue a su equipo:
- Conecta el texto del correo a Text.
- Deja Decision en Pick one y escribe en Question: «¿Qué equipo debe atender este mensaje?».
- En Answers añade tres filas: facturación (facturas, pagos, cobros, devoluciones), soporte técnico (errores, fallos, no puedo entrar) y ventas (precios, presupuestos, nuevos pedidos).
- Conecta cada salida al aviso del equipo correspondiente.
Un correo como «Me habéis cobrado dos veces la cuota de marzo, devolvedme el importe» sale por facturación, y los otros equipos no reciben nada.
Buenas prácticas
- Describe bien cada respuesta. «soporte técnico: errores, fallos, no puedo entrar» funciona mucho mejor que «soporte técnico» a secas.
- Escribe la pregunta y las respuestas en el idioma de los textos.
- Una decisión por nodo. Para dos preguntas sobre el mismo texto (por ejemplo, equipo y urgencia), usa dos nodos con el mismo texto.
- Describe los niveles cuando la escala importa. Un Pick one con niveles descritos («bloqueante: nadie puede trabajar; normal: molesta pero se puede seguir») suele acertar más que una escala con nombres sueltos.
- No acumules demasiadas respuestas en una sola decisión. Si son muchas y se parecen, divide en dos decisiones: una general y otra concreta.
- Usa Minimum confidence para mandar lo dudoso a una persona, sobre todo al principio.
- Cuidado con las negaciones y con lo que hay que deducir. «No quiero cancelar, pero…» puede leerse como una cancelación. Si equivocarse de rama sale caro, usa Minimum confidence o un agente con un modelo de IA.
Componentes relacionados
- Jev: el mismo tipo de decisión con el servicio de TypeSafe AI, para textos largos.
- OpenAI Decisions: el mismo tipo de decisión con OpenAI, que también mira imágenes.
- Agent: un agente al que puedes darle Laya como herramienta.