Documentación: Nodo Memoria de Agente MongoDB (Agent Memory MongoDB)¶

Descripción General¶

El Nodo Memoria de Agente MongoDB (Agent Memory MongoDB) es un nodo de la familia de AI Models que proporciona memoria persistente basada en MongoDB para un Agente. Permite que el agente recuerde el historial de la conversación entre ejecuciones, almacenando los mensajes en una colección de MongoDB identificada por la sesión.

En entornos IoT e industriales, es clave para construir asistentes conversacionales con memoria: por ejemplo, un agente de soporte de planta que mantiene el contexto de una conversación a lo largo del tiempo.

¿Cuándo usar este nodo?¶

Utiliza este nodo cuando necesites:

Dar memoria persistente a un Agente para que recuerde conversaciones anteriores.
Mantener el contexto de un diálogo entre varias ejecuciones del flujo.
Almacenar el historial de interacciones en una infraestructura MongoDB existente.

Arquitectura: conectar al Agente¶

Este nodo se conecta al conector Memory de un nodo Agente. Por sí solo provee el backend de memoria; su efecto se materializa cuando el Agente lo utiliza para leer y escribir el historial de la conversación (usando el session_id del agente).

Configuración del Nodo¶

Configuración vacía del nodo Memoria de Agente MongoDB

Vista Formulario¶

1. Cadena de Conexión (Connection String)¶

Selecciona la credencial de MongoDB que contiene la cadena de conexión a la base de datos (gestionada de forma centralizada y segura).

2. Base de Datos (Database)¶

El nombre de la base de datos de MongoDB donde se almacenará la memoria (por ejemplo, plant_agent).

3. Colección (Collection)¶

El nombre de la colección donde se guardarán los mensajes/historial (por ejemplo, conversations).

Formulario configurado del nodo Memoria de Agente MongoDB

Estructura JSON (Parámetros de entrada)¶

{
  "connection_string": "<referencia a credencial MongoDB>",
  "database": "plant_agent",
  "collection": "conversations"
}

Campos del JSON¶

Campo	Tipo	Descripción
`connection_string`	string	Referencia a la credencial de MongoDB (gestionada de forma segura).
`database`	string	Nombre de la base de datos de MongoDB.
`collection`	string	Nombre de la colección donde se almacena la memoria.

Output: Dónde viene la data del nodo¶

Este nodo provee el backend de memoria; no produce un payload por sí mismo. Su efecto se observa en el comportamiento del Agente, que recuerda el contexto de la conversación gracias a la persistencia en MongoDB.

Ejemplos de uso¶

Ejemplo 1: Asistente de planta con memoria¶

Caso de uso: Conectar este nodo a un Agente para que el asistente de soporte de planta recuerde las interacciones previas de cada operador (por session_id).

Database: plant_agent
Collection: conversations

(ver estructura JSON anterior)

Validación y errores¶

Condición	Causa / Solución habitual
El agente no recuerda el contexto	Verifica que este nodo esté conectado al conector Memory del Agente y que el `session_id` sea consistente.
No se conecta a MongoDB	Revisa la credencial (cadena de conexión) y que el servidor MongoDB sea accesible.
Datos mezclados	Usa una base de datos/colección dedicada para la memoria del agente.

Buenas prácticas¶

Usar credenciales centralizadas: No escribas la cadena de conexión en el nodo; selecciona una credencial de MongoDB gestionada de forma segura.
Sesiones consistentes: Mantén un session_id estable en el Agente para que la memoria se asocie correctamente a cada conversación.
Colecciones dedicadas: Reserva una colección para la memoria del agente, separada de otros datos.
Conectar al Agente: Recuerda que este nodo solo tiene efecto al conectarse al conector Memory de un Agente.