Upstash Redis Chat Memory

El Upstash Redis Chat Memory permite guardar y recuperar el historial de conversaciones de un chat directamente en un almacén de datos en la nube de Upstash Redis.
Con esta funcionalidad, cada sesión de chat mantiene su propio historial, lo que facilita la continuidad de la conversación y la personalización de respuestas en los flujos de trabajo de Nappai.

¿Cómo funciona?

Cuando configuras el componente, Nappai toma el Session ID que tú le indicas y lo usa como clave para acceder a la base de datos de Upstash Redis.
El componente necesita una credencial de tipo Upstash API que ya debe haber sido creada en la sección de credenciales de Nappai. Esa credencial contiene el Index URL y el Index Token que permiten autenticar y conectar con el índice de Upstash.
Una vez establecida la conexión, el componente lee los mensajes guardados bajo la clave del Session ID y los devuelve como un objeto BaseChatMessageHistory.
Cuando el chat genera nuevos mensajes, el componente los escribe de nuevo en la misma clave, manteniendo el historial actualizado.

Entradas

Campos de Entrada

• Session ID: Identificador único de la sesión de chat. Se utiliza para separar el historial de cada conversación.

Nota: Antes de usar el componente, debes:

1. Configurar la credencial Upstash API en la sección de credenciales de Nappai.
2. Seleccionar esa credencial en el campo Credential del componente.

Salidas

• Memory: Objeto BaseChatMessageHistory que contiene el historial completo de mensajes de la sesión.
  Este objeto puede ser conectado a otros componentes de chat o a cualquier flujo que necesite acceder al historial de conversación.

Ejemplo de Uso

1. Crear la credencial
   En la sección de credenciales de Nappai, crea una nueva credencial de tipo Upstash API y guarda el Index URL y el Index Token.

2. Añadir el componente
   Arrastra el componente Upstash Redis Chat Memory al flujo de trabajo.

   • Selecciona la credencial creada en el campo Credential.
   • Introduce un Session ID (por ejemplo, chat_12345).

3. Conectar la salida
   Conecta la salida Memory a un componente de chat que requiera historial, como un Chatbot o un LLM que utilice memoria.

4. Ejecutar
   Al iniciar la conversación, el componente recuperará cualquier mensaje previo asociado a chat_12345 y, a medida que se envíen nuevos mensajes, los guardará automáticamente.

Componentes Relacionados

• LCChatMemoryComponent – Base sobre la que se construyen los componentes de memoria de chat.
• Upstash Redis Chat Memory – Versión específica que utiliza Upstash Redis como backend.
• Chatbot – Componente que puede consumir la salida Memory para mantener contexto.

Consejos y Mejores Prácticas

• Usa un Session ID único y descriptivo para cada conversación (por ejemplo, user_987_chat).
• Evita reutilizar el mismo Session ID para conversaciones distintas a menos que quieras compartir historial.
• No expongas la credencial Upstash API en el código ni en archivos de configuración públicos.
• Revisa los límites de almacenamiento y costos de Upstash para evitar sorpresas en la facturación.

Consideraciones de Seguridad

• La credencial Upstash API contiene el token de acceso; manténlo seguro y revísalo periódicamente.
• No incluyas el Index URL ni el Index Token en logs o en la salida de la consola.
• Configura reglas de acceso en Upstash para limitar quién puede leer o escribir en el índice.

---