Versiones
Publica versiones de una plantilla de IDP, elige cuál responde en producción y vuelve a una versión anterior cuando lo necesites.
Versiones
Todo lo que editas en la plantilla queda en el borrador. Publicar congela toda la configuración del pipeline en una versión — documento de referencia, páginas, filtros, identificación, extracción, posprocesamiento, validaciones y modelo. La pestaña Versiones muestra lo que ya se publicó y qué versión está activa.
La versión activa es la que responde en producción: la API y webhook, la acción de robot y la acción de agente de IA siempre ejecutan la versión activa, nunca el borrador. Los cambios en el borrador solo llegan a quienes usan la plantilla después de publicarse. Consulta Usar plantillas en automatizaciones.
Solo los desarrolladores y administradores del workspace pueden publicar y activar versiones.
Publicar una versión
Haz clic en Publicar, arriba de la plantilla, o en Publicar versión, en la pestaña Versiones. Los cambios aún no guardados se guardan antes, para que entren en la versión. La ventana muestra la Versión actual y la Nueva versión y pide:
| Campo | Obligatorio | Descripción |
|---|---|---|
| Tipo de cambio | — | Corrección, Mejora o Cambio grande. Cada opción muestra el número resultante a partir de la versión más alta publicada: desde 1.2.0, por ejemplo, pasa a 1.2.1, 1.3.0 o 2.0.0. En la primera publicación, las opciones parten de 0.0.1, 0.1.0 y 1.0.0. |
| Número de versión | Sí | Se completa según el tipo de cambio y se puede editar. Usa el formato semver, por ejemplo 1.2.0; también se aceptan sufijos como 1.2.0-beta.1. El número no puede repetir el de una versión ya publicada en la plantilla. |
| Qué cambió | No | Hasta 10.000 caracteres. Resume qué trae la versión; el texto aparece en la lista de versiones. |
| Hacer esta la versión activa | — | Activada por defecto. Activada, la nueva versión empieza a responder en producción en el acto. Desactivada, la versión se publica como Archivada y la versión activa actual sigue respondiendo. |
Haz clic en Publicar para terminar.
Lista de versiones
La pestaña Versiones lista las versiones de la más reciente a la más antigua. Cada fila muestra el número de versión, la fecha y hora de publicación, la descripción y el estado:
| Estado | Significado |
|---|---|
| Activa | La versión que responde en producción. Hay como máximo una por plantilla. |
| Archivada | Una versión publicada que no está respondiendo. Se puede activar en cualquier momento. |
La lista no permite editar ni eliminar versiones publicadas. Para cambiar el comportamiento de la plantilla, edita el borrador y publica una nueva versión.
Volver a una versión anterior
Para deshacer una publicación, haz clic en Activar en la fila de una versión archivada y confirma. La producción y la API empiezan a usar esa versión de inmediato, y la versión que estaba activa pasa a Archivada. El borrador no cambia.
Sin versión activa
Mientras la plantilla no tiene una versión activa, no responde en producción. El editor muestra el aviso Sin versión publicada, con el atajo Publicar versión, y:
- la API rechaza las llamadas con el estado
409y el errorNO_ACTIVE_VERSION. Consulta API y webhook; - la acción de robot y la acción de agente de IA fallan con el error
NO_ACTIVE_VERSION.
El Playground, Simular API y los casos de prueba siguen funcionando, porque ejecutan el borrador. Consulta Playground y Simular API.