> ## Documentation Index > Fetch the complete documentation index at: https://docs.tess.im/llms.txt > Use this file to discover all available pages before exploring further. # Memorias 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\\ Captura De Tela 2026 06 09 Às 18 32 20 * Selecciona una colección existente o crea una nueva, según tus necesidades\\ Captura De Tela 2026 06 09 Às 18 32 50 * Crea memorias y una colección\\ Captura De Tela 2026 06 09 Às 18 33 41 * 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: *Solo tú accedes y editas* Cuando creas una colección sin compartirla, es completamente tuya. Ideal para contextos personales, metodologías propias o información confidencial. *Cualquier persona con el enlace importa una copia* Genera 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. *Acceso en vivo — conexión permanente* Todos 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. *Toda la empresa accede* Ideal 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: 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: Captura De Tela 2026 06 09 Às 18 34 38 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. Captura De Tela 2026 06 09 Às 18 37 35 Captura De Tela 2026 06 09 Às 18 37 52 Captura De Tela 2026 06 09 Às 18 39 07 **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](/es/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 ```bash theme={null} 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: ```bash theme={null} 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: ```bash theme={null} 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.