Memorias - Tess AI Docs

Las Memorias de Tess te permiten guardar, organizar y reutilizar información importante en forma de colecciones. Funcionan como “carpetas de conocimiento” que activas antes de cada conversación, garantizando que la IA responda con contexto, consistencia y alineación con tu trabajo o el de tu equipo.

¿Qué es?

Una Colección de Memoria es un conjunto de información estructurada (textos, instrucciones, datos o reglas) que le proporcionas a la IA antes de iniciar una conversación. En la práctica:

Escribes memorias (ej.: contexto de cliente, tono de voz, reglas internas)
Las organizas en colecciones temáticas
Activas esas colecciones en el chat
La IA considera automáticamente ese contenido en sus respuestas

Piénsalo como un “paquete de contexto reutilizable” que le entregas al agente antes de cada tarea. Puedes decidir, en todo momento, qué colecciones de memorias deseas mantener activas/inactivas para cada trabajo. Es totalmente modular. Estas memorias pueden usarse en nuevas conversaciones, sin que tengas que repetir todo el tiempo.

¿Por qué es importante?

Personalización real: Tess responde teniendo en cuenta el historial (la memoria), no solo el mensaje actual.
Menos repetición: No necesitas ingresar los mismos datos en cada interacción.
Contexto para el equipo: Las memorias organizadas ayudan tanto a la IA como al equipo humano a mantener el mismo nivel de atención, incluso cuando cambian los agentes.
Organización del trabajo: puedes organizar tus memorias por equipo, por proyecto, por cliente o como prefieras, para darle versatilidad a tu forma de trabajar con IA.

Configurando y Gestionando las Memorias

Abre la pantalla de Chat
Localiza el ícono de Colecciones de Memorias en la esquina superior derecha\
Selecciona una colección existente o crea una nueva, según tus necesidades\
Crea memorias y una colección\
Recuerda activar la colección — aparecerá un número en el ícono y las colecciones activas quedarán marcadas

En el ícono de Memorias, puedes:

Activar o desactivar colecciones de memorias
Crear nuevas colecciones segmentadas por caso de uso
Revisar, editar o eliminar memorias existentes

Después de activar alguna colección, puedes iniciar o continuar la conversación normalmente en el chat. Observa si el LLM está usando la información de memoria para complementar las respuestas (cuando tenga sentido).

Compartición de Colecciones

Tess ofrece 4 formas de compartir, con diferentes niveles de control:

Colección Individual (Privada)

Solo tú accedes y editasCuando creas una colección sin compartirla, es completamente tuya. Ideal para contextos personales, metodologías propias o información confidencial.

Compartir mediante enlace

Cualquier persona con el enlace importa una copiaGenera un enlace público. Quien acceda puede importar una copia completa a su propia cuenta. Cada uno tiene su versión independiente después de importarla.

Compartir con el equipo

Acceso en vivo — conexión permanenteTodos los miembros tienen acceso en tiempo real. Cualquier actualización del propietario aparece de inmediato para todos en el próximo chat. Define quién puede leer y quién puede editar.

Compartir con el Workspace

Toda la empresa accedeIdeal para el conocimiento que todos deben tener: valores de marca, manual de producto, glosario interno. El administrador controla los permisos.

Gestión de compartición

El flujo de compartición fue mejorado con más control y claridad:

Modal de gestión organizado para visualizar accesos
Permisos granulares (visualización o edición)
Prevención de invitaciones duplicadas
Control de enlaces activos
Preservación del origen de las colecciones compartidas

Para compartir, simplemente:

Localiza la colección y haz clic en el ícono de compartir

Al pasar el cursor sobre la colección, aparecerán los botones — solo localiza el botón de compartición e inicia la configuración:

Genera un enlace para compartir

Si quieres asignar algún prefijo, es posible, así como elegir el nivel de permiso — ver o editar. Después de configurar esto, solo genera tu enlace.

Si deseas revocar el enlace, solo haz clic en la opción existente

Si prefieres, elige el nivel de compartición para tu equipo

Buenas Prácticas

Define claramente qué tipo de información puede convertirse en memoria — y qué nunca debe guardarse (por ejemplo, datos sensibles, contraseñas, información que viole políticas de privacidad o cumplimiento normativo).
Usa colecciones diferentes para contextos diferentes (una para soporte, otra para ventas, otra para proyectos internos).
Revisa periódicamente las memorias y colecciones para eliminar lo que esté desactualizado o sea irrelevante, manteniendo solo lo que realmente ayude en la personalización y la calidad del servicio.
Prefiere colecciones compartidas para estandarizar equipos.

Observaciones importantes

Las memorias activas consumen tokens (forman parte del contexto enviado a la IA)
Cuantas más colecciones activas, mayor el costo potencial
Evita almacenar: Contraseñas; Datos sensibles; o Información confidencial sin control de acceso
Las comparticiones con equipo/workspace se sincronizan en tiempo real

Las Memorias transforman a Tess en un sistema verdaderamente contextual. Con colecciones bien estructuradas y el nuevo modelo de compartición, reduces la repetición, aumentas la consistencia y escalas el uso de la IA con mucho más control.

Usando Memorias via API

Las llamadas autenticadas a la API de memorias deben incluir x-workspace-id (obligatorio a partir del 01/09/2026). Hasta entonces, si se omite, se usa el workspace seleccionado (deprecated). Después de la fecha, ausencia → 422. Ver API Overview.

Puedes gestionar memorias y aplicarlas en ejecuciones de agentes directamente a través de la API. El flujo completo implica tres pasos:

Paso 1 — Crear una colección de memorias

curl --request POST \
  --url 'https://api.tess.im/memory-collections' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'x-workspace-id: YOUR_WORKSPACE_ID' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Datos del cliente",
    "description": "Información de perfil y preferencias"
  }'

Guarda el id devuelto en la respuesta — lo usarás en los siguientes pasos.

Paso 2 — Crear memorias en la colección

Agrega cada registro de memoria pasando el collection_id obtenido en el paso anterior:

curl --request POST \
  --url 'https://api.tess.im/memories' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'x-workspace-id: YOUR_WORKSPACE_ID' \
  --header 'Content-Type: application/json' \
  --data '{
    "memory": "El cliente prefiere comunicación formal y trabaja en el sector financiero.",
    "collection_id": 123
  }'

La memoria creada pasa por un proceso de embedding (indexación semántica). El campo embedding_status comienza como pending y cambia a succeeded cuando está lista para ser consultada. Espera el estado succeeded antes de ejecutar el agente para garantizar que la memoria sea encontrada.

Paso 3 — Ejecutar el agente con las colecciones de memorias

Al ejecutar el agente, pasa el parámetro memory_collections con los IDs de las colecciones que deseas activar:

curl --request POST \
  --url 'https://api.tess.im/agents/TU_AGENTE_ID/execute' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'x-workspace-id: YOUR_WORKSPACE_ID' \
  --header 'Content-Type: application/json' \
  --data '{
    "memory_collections": [123],
    "messages": [
      { "role": "user", "content": "¿Cómo prefieres que me comunique contigo?" }
    ]
  }'

Cómo funciona la inyección de memorias: Tess usa búsqueda semántica (RAG) para seleccionar automáticamente las memorias más relevantes de la colección en función del contenido de la conversación. Solo las memorias con alta similitud semántica se inyectan en el contexto del agente — no necesitas especificar qué memorias usar, solo qué colección activar.

​¿Qué es?

​¿Por qué es importante?

​Configurando y Gestionando las Memorias

​Compartición de Colecciones

Colección Individual (Privada)

Compartir mediante enlace

Compartir con el equipo

Compartir con el Workspace

​Gestión de compartición

​Observaciones importantes

​Usando Memorias via API

​Paso 1 — Crear una colección de memorias

​Paso 2 — Crear memorias en la colección

​Paso 3 — Ejecutar el agente con las colecciones de memorias

¿Qué es?

¿Por qué es importante?

Configurando y Gestionando las Memorias

Compartición de Colecciones

Gestión de compartición

Observaciones importantes

Usando Memorias via API

Paso 1 — Crear una colección de memorias

Paso 2 — Crear memorias en la colección

Paso 3 — Ejecutar el agente con las colecciones de memorias