Cómo conservar el estado de una tarea de agente entre ejecuciones
Conserva el estado de la tarea en un registro persistente que puedas recuperar sin pedir al modelo que reconstruya lo sucedido.
Equipo enginerIT· 2 min de lectura
Conserva el estado de la tarea en un registro persistente que puedas recuperar sin pedir al modelo que reconstruya lo sucedido. Guarda por separado la conversación, el progreso operativo y las confirmaciones de los sistemas externos. Un historial de mensajes puede explicar una decisión, pero no acredita que se haya aplicado un cambio.
Elige qué debe sobrevivir
Define la unidad de continuidad: expediente, conversación o trabajo concreto. Asigna un identificador estable y una versión del estado. Incluye objetivo autorizado, entradas validadas, paso pendiente, referencias de resultados y propietario. Evita convertir cada frase del usuario en un dato permanente. Una preferencia recordada y una aprobación para enviar una oferta tienen vigencias distintas.
Guarda en puntos que puedas interpretar
Acuerda con desarrollo qué transiciones generan una instantánea: validación de entrada, recepción de una respuesta, propuesta preparada o derivación aceptada. LangGraph distingue checkpoints de un hilo y almacenes compartidos entre hilos. Es una capacidad de ese marco; tu aplicación debe elegir dónde persiste y quién accede. Su almacenamiento en memoria no conserva el estado tras reiniciar.
Separa progreso y efectos
Si el registro indica “mensaje preparado”, no lo transformes en “enviado” al recuperar. Conserva la referencia que permita comprobar el resultado en el destino. Para una operación enviada sin confirmación, abre conciliación. Restaurar una instantánea anterior tampoco deshace lo ocurrido fuera del agente. Esta diferencia debe verse en la interfaz de operaciones.
Demuestra recuperación con un reinicio
En una prueba autorizada, interrumpe el proceso entre dos pasos y arráncalo desde otro trabajador. Comprueba identificador, versión, siguiente acción y datos disponibles. Repite después de una escritura externa cuyo resultado llegue tarde. El responsable del proceso debe poder explicar qué se conserva y qué sigue incierto. Si depende de copiar manualmente la conversación, la continuidad todavía no está resuelta.
Versiona también el esquema
Si cambia la estructura del estado, define una migración o rechaza versiones incompatibles con un mensaje recuperable. Prueba un expediente guardado por la versión anterior. Recuperar datos sin entender su significado puede ser peor que detenerse: una etiqueta que antes significaba propuesta no debe interpretarse ahora como aprobación.
Comprobaciones para cerrar la tarea
- ✓ Recupera el mismo expediente desde otro proceso.
- ✓ Distingue enviado de confirmado tras reiniciar.
- ✓ Comprueba acceso y caducidad del estado guardado.
Fuentes y documentación
- Persistencia de LangGraph — Distingue estado por hilo y memoria compartida; la memoria en RAM no sobrevive al reinicio.
- Checkpointers de LangGraph — Documenta instantáneas del estado y recuperación por hilo; no confirma por sí solo efectos externos.
Aplicarlo en tu empresa
Podemos revisar el entorno y acordar qué actuaciones, validaciones y mantenimiento necesitas.
Conocer el servicio relacionado →