Memory

Introducción

Memory te permite guardar variables que persisten entre conversaciones, workflows y nodos. A diferencia de Context (que solo está disponible durante la conversación actual), Memory mantiene los datos disponibles para futuras interacciones con el usuario.

Una sola memoria por usuario, cuatro formas de acceder. Memory es un único almacén por usuario que ves desde distintas superficies según dónde estés trabajando:

Builder — placeholder {{$memory.key}} y métodos $memory.set/get/... en nodos de código.
Functions — cliente ctx.memory (ver guía de ctx.memory).
AI Agent — tool nativa memory_manager (ver Tools nativas).
REST API — endpoints POST https://gateway.jelou.ai/workflows/v2/memory/users/{get-all|find-one|set}.

Cualquier escritura desde una superficie es visible inmediatamente desde las otras. No hay copias paralelas ni sincronización que hacer.

Características principales

Característica	Descripción
TTL configurable	Define el tiempo de vida de cada variable en segundos
Múltiples tipos	Soporta primitivos, JSON y archivos
Almacenamiento de archivos	Guarda imágenes, videos, audios y documentos hasta 10MB
Métodos específicos	API diferenciada para cada tipo de dato

Tipos de datos

Tipo	Tamaño máximo	TTL por variable	TTL máximo por variable
String	255 caracteres	Opcional	-
Number	15 dígitos	Opcional	-
Boolean	-	Opcional	-
JSON	15KB	Requerido	86.400s (1 día)
File	10MB	Requerido	604.800s (1 semana)

TTL (Time To Live): Tiempo de vida en segundos de cada variable. Transcurrido el TTL, la variable se elimina automáticamente. Por ejemplo, 3600 = 1 hora, 86400 = 1 día.

Cuánto dura Memory en total

Memory tiene dos relojes independientes funcionando a la vez:

Reloj	Duración	Qué controla	Se renueva cuando
hashTTL	30 días	La memoria del usuario entera	Cada vez que escribes cualquier variable
TTL por variable	Ver tabla arriba	Cada variable individual	No se renueva — expira desde el `set`

Regla mental: si el usuario escribe algo en Memory al menos una vez cada 30 días, su memoria vive indefinidamente. Si pasa 30 días completos sin escribir, toda su memoria se borra. Cada variable puede caducar antes por su propio TTL sin afectar el resto.

Solo escribir (set, setJson, setFile) renueva el hashTTL. Leer (get, getJson, getFile) no cuenta.

Guardar variables

Usando el nodo Variable

Para guardar variables sin código, usa el nodo Variable dentro de la sección Lógica. En Variable coloca el nombre y en Valor lo que quieres guardar; puede ser texto plano, otra variable o un dato del contexto.

Variable: nombre
Valor: {{$user.names}}

El nodo Variable es ideal para guardar primitivos (string, number, boolean) de forma rápida y visual.

Cada nodo Variable permite un máximo de 20 variables. Si necesitas más, usa varios nodos o guarda los valores desde un nodo de código.

Usando nodos de código

Para mayor control sobre TTL y tipos de datos complejos, usa los métodos de $memory en nodos de código:

// Primitivos (string, number, boolean) - TTL opcional
$memory.set('nombre', 'Juan')
$memory.set('intentos', 3)
$memory.set('verificado', true)

// Primitivo con TTL (expira en 1 hora)
$memory.set('codigoTemporal', 'ABC123', 3600)

// JSON - TTL requerido (máximo 1 día)
$memory.setJson('preferencias', {
  idioma: 'es',
  notificaciones: true
}, 86400)

// Archivo - async, TTL requerido, MIME requerido (máximo 1 semana)
await $memory.setFile('comprobante', base64String, 604800, 'application/pdf')

Leer variables

En cualquier nodo

Dentro de cualquier nodo puedes acceder a Memory con la sintaxis {{$memory.nombreVariable}}. Por ejemplo, si las variables en memoria son:

{
  "nombre": "Juan",
  "ultimoPedido": { "id": "PED-123", "estado": "en camino" }
}

Entonces:

{{$memory.nombre}} muestra Juan
{{$memory.ultimoPedido.estado}} muestra en camino

En nodos de código

Usa los métodos específicos según el tipo de dato:

// Primitivos
const nombre = $memory.get('nombre')
const nombre = $memory.get('nombre', 'Invitado') // con valor por defecto

// JSON
const prefs = $memory.getJson('preferencias')
const prefs = $memory.getJson('preferencias', {}) // con valor por defecto

// Archivos - devuelve FileHandle
const archivo = $memory.getFile('comprobante')

Trabajar con archivos

Al guardar un archivo en Memory, debes proporcionar el contenido en base64, el TTL y el tipo MIME:

// Guardar un archivo
await $memory.setFile('documento', base64Content, 604800, 'application/pdf')

Al leer un archivo con $memory.getFile() obtienes un FileHandle con tres métodos para acceder al contenido:

Método	Descripción	Async
`.toUrl()`	URL temporal para descargar (S3)	No
`.toBase64()`	Contenido en string base-64	Sí
`.toRaw()`	Buffer / Uint8Array	Sí

// Obtener URL temporal
const url = $memory.getFile('comprobante').toUrl()

// Obtener contenido en base64
const base64 = await $memory.getFile('comprobante').toBase64()

// Obtener contenido del archivo
const contenido = await $memory.getFile('comprobante').toRaw()

Tipos MIME permitidos

Categoría	Tipos MIME
Texto	`text/plain`
JSON	`application/json`
XML	`application/xml`, `text/xml`
Imágenes	`image/jpeg`, `image/png`, `image/gif`
Videos	`video/mp4`, `video/ogg`, `video/webm`, `video/x-msvideo`, `video/mpeg`
Audios	`audio/mpeg`, `audio/wav`, `audio/ogg`, `audio/aac`, `audio/flac`
Documentos	`application/pdf`

Los métodos $memory.setFile(), $memory.getFile().toBase64() y $memory.getFile().toRaw() son asincrónicos. Debes usar await al llamarlos.

Eliminar variables

Puedes eliminar variables antes de que expire su TTL:

// Eliminar una variable
$memory.delete('temporal')

// Eliminar múltiples variables
$memory.delete(['cache', 'sesion', 'temporal'])

Seguridad

No almacenes datos sensibles en Memory:

Contraseñas o números de tarjeta de crédito
Tokens de autenticación de larga duración
Información de identificación personal (PII) altamente sensible

Para persistencia a largo plazo, usa Datum.

Empezando

Agentes IA

Nodos

Variables

Mensajería Outbound

Gestión

Marketplace

Canales

Configuración

Facturación

Introducción

Características principales

Tipos de datos

Cuánto dura Memory en total

Guardar variables

Usando el nodo Variable

Usando nodos de código

Leer variables

En cualquier nodo

En nodos de código

Trabajar con archivos

Tipos MIME permitidos

Eliminar variables

Seguridad

​Introducción

​Características principales

​Tipos de datos

​Cuánto dura Memory en total

​Guardar variables

​Usando el nodo Variable

​Usando nodos de código

​Leer variables

​En cualquier nodo

​En nodos de código

​Trabajar con archivos

​Tipos MIME permitidos

​Eliminar variables

​Seguridad

Introducción

Características principales

Tipos de datos

Cuánto dura Memory en total

Guardar variables

Usando el nodo Variable

Usando nodos de código

Leer variables

En cualquier nodo

En nodos de código

Trabajar con archivos

Tipos MIME permitidos

Eliminar variables

Seguridad