Postgres Memory
Postgres Memory guarda la memoria de un agente en una base de datos PostgreSQL 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 Postgres Memory cuando quieras que esa memoria quede en tu propia base de datos.
Cuándo usarlo
- Tu política de datos exige que las conversaciones con clientes se guarden en una base de datos de la empresa.
- Quieres que un asistente de atención al cliente recuerde las preferencias de cada cliente (idioma, tienda habitual, forma de pago) de una conversación a la siguiente.
- Varios flujos o equipos ya trabajan con una base de datos PostgreSQL y quieres concentrar en ella la memoria de tus agentes.
Configuración
Antes de empezar necesitas una base de datos PostgreSQL accesible desde NappAI y una credencial del servicio Postgres SQL con su dirección de conexión. Consulta Credenciales.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial del servicio Postgres SQL. Elige una con Seleccionar una credencial o crea una nueva con Crear nueva credencial. |
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| Enable Checkpointing | Guarda en tu base de datos 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 aparecen Session ID y Enable Semantic Search. Por defecto: desactivado. |
| Session ID | Aparece con Enable Store. Puedes dejarlo como está: el agente organiza los recuerdos por la sesión de cada usuario, que puedes fijar con Set Session ID. |
| 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. Tu base de datos debe tener instalada la extensión vector (pgvector); si no la tiene, el componente te avisa. |
| 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. |
| 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
Viajes Albaida tiene un asistente de reservas y guarda todos sus datos en PostgreSQL:
- Crea una credencial Postgres SQL con la dirección de la base de datos de la agencia.
- Añade Postgres Memory y elige esa credencial en Credential.
- En el agente, activa Use memory en la pestaña Avanzado y conecta Memory a la nueva entrada Memory.
Si un cliente escribe “quiero el mismo hotel que la última vez, pero en julio”, el agente encuentra en el hilo de la conversación qué hotel era, y todo queda guardado en la base de datos de Viajes Albaida.
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é tipo de datos debe recordar y cuáles no, por ejemplo “recuerda el idioma preferido, nunca guardes datos de pago”.
- Usa Set Session ID con un identificador estable del cliente para que sus recuerdos no se mezclen con los de otros.