Saltearse al contenido
Nappai Documentation

Chat Output

Chat Output es un componente que permite mostrar mensajes de chat dentro del dashboard de Nappai. Puedes usarlo para enviar texto a la pantalla, ya sea generado por la IA o escrito por el usuario, y para mantener un registro de las conversaciones.

¿Cómo funciona?

El componente crea un objeto Message con el texto que le pases y la información del remitente (tipo y nombre). Si se proporciona un Session ID, el mensaje se guarda en el historial interno de Nappai para que pueda recuperarse más tarde. No hace llamadas a APIs externas; todo el procesamiento ocurre localmente dentro del entorno de Nappai.

Entradas

  • Conversation ID: Identificador único de la conversación. Se usa para agrupar mensajes relacionados.
  • Data Template: Plantilla que convierte datos en texto. Si lo dejas vacío, Nappai usará automáticamente la clave text del objeto de datos.
  • Text: El contenido del mensaje que quieres mostrar.
  • Sender Type: Tipo de remitente. Puedes elegir entre Machine (la IA) o User (el usuario).
  • Sender Name: Nombre que aparecerá junto al mensaje. Por defecto es “AI”.
  • Session ID: Identificador de la sesión actual. Ayuda a mantener el contexto entre mensajes.

Salidas

  • Message: Devuelve un objeto Message que contiene el texto, el remitente, el nombre, el ID de sesión y el ID de conversación. Este objeto puede conectarse a otros componentes que necesiten el mensaje completo, como un historial de chat o un analizador de sentimientos.

Ejemplo de Uso

  1. ChatInput → Chat Output

    • El usuario escribe “Hola, ¿cómo estás?” en el componente ChatInput.
    • El texto se pasa al campo Text de Chat Output.
    • Se selecciona Sender Type como User y Sender Name como “Usuario”.
    • Se deja Session ID vacío (se generará automáticamente).
    • El mensaje aparece en la pantalla y se guarda en el historial.

  2. Chat Output → Store Message

    • Después de generar una respuesta de IA, el texto se pasa a Chat Output con Sender Type = Machine y Sender Name = “AI”.
    • El mensaje se almacena y se puede usar en análisis posteriores.

Componentes Relacionados

  • Chat Input – Recibe texto del usuario.
  • Store Message – Guarda mensajes en el historial.
  • Message – Tipo de dato que representa un mensaje de chat.
  • Conversation Manager – Gestiona IDs de conversación y sesión.

Consejos y Mejores Prácticas

  • Usa siempre un Session ID consistente cuando quieras que los mensajes se agrupen correctamente.
  • Si necesitas mostrar datos dinámicos (por ejemplo, resultados de una consulta), configura Data Template con la sintaxis {text} o la clave que corresponda.
  • Mantén el Sender Name claro para que los usuarios identifiquen fácilmente quién habla.
  • Si el flujo incluye múltiples conversaciones, asigna un Conversation ID distinto a cada una.

Consideraciones de Seguridad

  • Los mensajes se almacenan localmente en el sistema de Nappai; no se envían a servicios externos.
  • Evita incluir información sensible en el campo Text a menos que el entorno esté protegido y cumpla con las políticas de privacidad de tu organización.