Saltar al contenido principal
Roberty Studio
IDPIDP

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:

CampoObligatorioDescripció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ónSí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óNoHasta 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:

EstadoSignificado
ActivaLa versión que responde en producción. Hay como máximo una por plantilla.
ArchivadaUna 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 409 y el error NO_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.