osFoundry / Platform
Replay en caliente e historial
Cada canal conserva los eventos de los últimos N días. Reinicia un cursor, reproduce desde cualquier seq id.
Qué es
Hot replay e historial es el registro de eventos por canal de osFoundry. Cada canal, es decir, los flujos que hay detrás de tus chats, agentes y herramientas, retiene los eventos de los últimos N días, y cada evento lleva un id de secuencia monótono (seq id). Los consumidores leen hacia adelante siguiendo un cursor que apunta al último seq id que procesaron. Como la ventana reciente se mantiene «en caliente», no tienes que tratar un canal como un flujo del que te olvidas tras enviarlo: el historial está ahí para volver a leerlo.
La operación central es sencilla. Mueve un cursor hacia atrás hasta cualquier seq id y reproduce desde ese punto. Un agente que se cayó a mitad de una ejecución, un consumidor nuevo que acaba de unirse a un canal o una herramienta que procesó eventos de forma incorrecta pueden releer exactamente la misma secuencia en lugar de perder el hueco o adivinar qué ocurrió. Como osFoundry es un espacio de trabajo de escritorio con tu propia clave (BYOK), este historial vive con tu espacio de trabajo y no en los servidores de un proveedor: la ventana de eventos es local-first, de modo que reproducir eventos antiguos no implica enviar tus datos a un tercero. Reinicias el cursor, reproduces y el consumidor ve los mismos eventos ordenados que habría visto en vivo.
Por qué importa: los flujos de agentes y multicanal tienen estado, y ese estado solo es tan fiable como tu capacidad de reconstruirlo. Una ventana retenida y direccionable por seq id convierte la pregunta «¿qué vio realmente este canal?» de una conjetura en una relectura determinista. Hace que la depuración sea reproducible (reproduce la secuencia exacta que provocó un fallo), que la recuperación sea barata (reanuda desde el último cursor válido en vez de desde cero) y que incorporar un consumidor nuevo sea seguro (rellena desde un seq id elegido). La ventana está acotada por diseño a los últimos N días, de modo que el historial se mantiene útil y actual sin crecer de forma ilimitada.
Capacidades principales
- Cada canal retiene los eventos de los últimos N días, cada uno marcado con un id de secuencia monótono (seq id)
- Reinicia el cursor de un consumidor a cualquier seq id y reproduce la secuencia exacta y ordenada de eventos desde ese punto
- Recupera agentes caídos o ejecuciones interrumpidas reanudando desde el último cursor procesado en lugar de empezar de cero
- Reproduce fallos de forma determinista repitiendo la secuencia precisa de eventos que los provocó, o rellena un consumidor recién añadido desde un seq id elegido
- Una retención acotada y local-first mantiene el historial reciente «en caliente» en tu dispositivo, sin crecimiento ilimitado ni idas y vueltas al proveedor
Casos de uso
- Desarrollador de agentes: un agente se cae a mitad de la ejecución, así que rebobinas su cursor al último seq id confirmado y reproduces el canal para reanudar justo donde lo dejó
- Depurador de flujos: una herramienta posterior produjo un resultado incorrecto, así que reproduces el mismo rango de eventos para reproducirlo y confirmar la corrección de forma determinista
- Constructor de integraciones: añades un consumidor nuevo a un canal con mucho tráfico y lo rellenas desde un seq id elegido para que se ponga al día con los últimos N días antes de entrar en producción
Preguntas frecuentes
¿Hasta cuándo puedo reproducir los eventos de un canal?
Cada canal mantiene una ventana móvil con los eventos de los últimos N días. Todo lo que esté dentro de esa ventana es direccionable por su id de secuencia y puede reproducirse; los eventos más antiguos que el periodo de retención van caducando, por lo que hot replay está pensado para el historial reciente y la recuperación, no para el archivo permanente.
¿Qué hace realmente reiniciar un cursor?
Un cursor marca el último seq id que ha procesado un consumidor. Reiniciarlo a un seq id anterior le indica a ese consumidor que relea el canal desde ese punto en adelante, recibiendo de nuevo los mismos eventos ordenados. No borra ni reescribe los eventos: solo cambia dónde se reanuda la lectura.
¿Reproducir el historial de mi canal envía datos a los servidores de osFoundry?
No. osFoundry es un espacio de trabajo de escritorio local-first con tu propia clave (BYOK), y la ventana de eventos se retiene con tu espacio de trabajo. Reproducir relee eventos que ya están guardados localmente, así que recuperar o reprocesar el historial no requiere enviar los datos de tu canal a un servicio de terceros.