Memoria y eventos clave

El panel de memoria gestiona dos tipos de memoria: contexto de la conversación (memoria a corto plazo, contexto completo) y eventos clave (memoria de negocio a largo plazo, entre sesiones).

Memoria a corto plazo

La memoria a corto plazo determina si el agente «recuerda las últimas rondas»:

• La controla el ajuste «Habilitar las últimas N rondas del historial de chat» del panel de memoria: puedes definir cuántas rondas recientes conservar (una pregunta y una respuesta = una ronda), con un valor predeterminado de 30 rondas.
• Cuando se desactiva, el historial entre rondas ya no se le pasa al modelo, y el agente «olvida la ronda anterior». Cuando un cliente informa de que «no recuerda la ronda anterior», mira aquí primero.
• En modo depuración / vista previa la memoria siempre está vacía (un contexto limpio cada vez), lo cual es normal.

Contexto completo

Dentro de la ventana de memoria a corto plazo, las rondas más antiguas conservan por defecto solo el texto plano de «qué se preguntó, qué se respondió»: qué herramienta se llamó en su momento, qué parámetros se pasaron y qué resultado se obtuvo no están en el historial. El contexto completo es una capa por encima de la memoria a corto plazo: hace que las rondas más recientes lleven adicionalmente el rastro completo de la llamada a herramientas (qué herramienta se llamó, los parámetros de entrada y el resultado devuelto), de modo que el modelo pueda recordar con precisión qué acaba de hacer exactamente.

• La controla el ajuste contexto completo del panel de memoria (mostrado como «últimas N rondas»), con un valor predeterminado de 1 ronda y un rango de 0–5; 0 significa desactivado (las rondas anteriores conservan solo el texto de pregunta y respuesta).
• Este ajuste y el número de rondas de la memoria a corto plazo son dos ajustes independientes que no se afectan entre sí.
• Se cuenta por ronda (una pregunta y una respuesta = una ronda), no por número de respuestas: si una sola ronda tiene varias respuestas, no se corta por la mitad; o toda la ronda lleva el rastro de herramientas o ninguna lo lleva.

Cuándo aumentarlo: cuando el modelo «parece no recordar qué herramienta acaba de llamar ni qué parámetros pasó», comprueba primero si este valor está en 0 o es demasiado pequeño, y luego auméntalo. A la inversa, cuantas más rondas se lleven, más rápido crece el uso de tokens: más grande no es mejor; normalmente basta con 1 o 2 rondas.

Eventos clave

Los eventos clave son la memoria a largo plazo de LoopAgent, entre sesiones y a nivel de usuario (equivalente a un ticket). Durante una conversación, el modelo crea / actualiza / consulta activamente eventos para el usuario (como «procesamiento de reembolso» o «anomalía de la cuenta»); cuando el mismo usuario vuelve en una sesión distinta, todavía se pueden ver y continuar.

• Los eventos van asociados a la identidad del usuario y son visibles y editables en todas las sesiones de ese usuario.
• El prompt del sistema de cada ronda lleva automáticamente hasta 5 eventos sin cerrar de ese usuario; cuando necesita más, el modelo los consulta activamente.

Diferencia con un Agent / FlowAgent normal: los tres tipos de agente comparten la misma configuración de eventos clave (interruptor + tipos de evento), pero la forma de escribir es distinta: LoopAgent escribe de forma síncrona durante la conversación (crea / modifica eventos directamente dentro de la ronda); un Agent / FlowAgent normal los extrae de forma asíncrona en segundo plano después de la conversación. Para los conceptos generales de los eventos clave, la configuración de los tipos de evento y los casos de uso, consulta Eventos clave.

Requisitos para que aparezcan: hay que cumplir ambas condiciones

Para que aparezcan las herramientas relacionadas con los eventos clave, deben cumplirse ambas:

1. El interruptor general de eventos clave de la memoria está activado;
2. Hay al menos un tipo configurado en las categorías de tipos de evento.

Interruptor activado pero sin ni un solo tipo de evento creado → las herramientas de eventos clave no aparecen, y no se inyecta ningún evento histórico. Esto no es un fallo.

Preguntas frecuentes

• «Crear un evento devuelve un error de parámetros»: lo más probable es que el tipo de evento que usó el modelo no esté en tu diccionario de tipos configurado. Comprueba que el tipo que pasó el modelo coincide con los nombres de tipo de la página de ajustes al pie de la letra (sensible a mayúsculas y a espacios).
• «Se creó pero no se encuentra en una visita posterior»: sospecha primero de que la identidad del usuario no se resolvió (anónimo / sesión de canal). En ese caso los eventos recurren a la sesión, y la recuperación entre sesiones puede pasarlos por alto.