Redis Memory
Redis Memory guarda la memoria de un agente en un servidor Redis de tu empresa. Con ella, el agente recuerda lo que se habló en los mensajes anteriores de cada conversación y, si lo activas, también datos importantes de cada usuario que conserva de una conversación a otra.
Si solo quieres que un agente recuerde la conversación, no necesitas este componente: al activar Use memory en el agente, NappAI guarda el historial por ti. Usa Redis Memory cuando quieras que esa memoria quede en tu propio servidor Redis.
Cuándo usarlo
- Tu empresa ya usa Redis y quiere tener allí la memoria de sus asistentes.
- Tu política de datos exige que el historial de las conversaciones se guarde en un servidor propio.
- Quieres que un asistente recuerde datos de cada cliente, como su tienda habitual, entre conversaciones distintas.
Configuración
Antes de empezar necesitas un servidor Redis accesible desde NappAI que incluya los módulos de búsqueda y JSON (vienen de serie en Redis Stack y en Redis 8), y su dirección de conexión.
| Campo | Qué hace |
|---|---|
| Redis Server Connection URL (obligatorio) | La dirección de conexión a tu servidor Redis, con el servidor, el puerto, el usuario, la contraseña y la base de datos. |
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| Enable Checkpointing | Guarda en tu servidor Redis el hilo de cada conversación, para que el agente recuerde los mensajes anteriores. Por defecto: activado. |
| Enable Store | Activa la memoria a largo plazo: el agente puede guardar datos importantes de cada usuario y buscarlos en conversaciones posteriores. Al activarlo aparece Enable Semantic Search. Por defecto: desactivado. |
| Enable Semantic Search | Aparece con Enable Store. Permite que el agente busque recuerdos por su significado y no solo por palabras exactas. Al activarlo aparecen la conexión Embedding y el campo Embedding Dimension. |
| Embedding Dimension | Aparece con Enable Semantic Search. El tamaño de las representaciones numéricas que genera el modelo de embeddings conectado. Debe coincidir con el de ese modelo; consulta el valor en la documentación del proveedor. Por defecto: 1536. |
| Session ID | Identificador de la sesión. Puedes dejarlo vacío: el agente usa la sesión de cada ejecución, que puedes fijar con Set Session ID. |
| Conversation ID | Identificador de la conversación. Puedes dejarlo vacío: el agente guarda y recupera el hilo por la conversación de cada ejecución. |
| Conexión | Qué conectar |
|---|---|
| Embedding | Un componente de embeddings, por ejemplo OpenAI Embeddings. Es obligatorio para usar Enable Store. |
Resultado
Memory es la memoria configurada. Conéctala a la entrada Memory de un agente, como Agent, Simple Agent o Deep Agent. Esa entrada aparece cuando activas Use memory en la pestaña Avanzado del agente.
Con Enable Store activado, el agente recibe además la capacidad de guardar un dato importante, buscar entre lo guardado y recuperar un dato concreto. Él decide cuándo hacerlo según la conversación.
Ejemplo
Ópticas Mirador atiende por chat las citas de sus tiendas y ya usa Redis en sus sistemas:
- Añade Redis Memory y conecta Redis Server Connection URL a un componente Environment Variable que contenga la dirección del servidor.
- En el agente, activa Use memory en la pestaña Avanzado y conecta Memory a la nueva entrada Memory.
Si un cliente pide una cita y después escribe “mejor por la tarde”, el agente sabe de qué cita y de qué tienda se habla, y la conversación queda guardada en el servidor de Ópticas Mirador.
Buenas prácticas
- Activa la memoria a largo plazo solo si el agente necesita recordar datos entre conversaciones distintas; para seguir una conversación basta con Enable Checkpointing.
- Indica en las instrucciones del agente qué datos debe recordar y cuáles no.
- Usa Set Session ID con un identificador estable del cliente para que sus recuerdos no se mezclen con los de otros.