Pipeline
Cómo se arma el pipeline de una plantilla de IDP en el constructor: el orden de las etapas, qué pasa de una a otra, las tarjetas de cada capa y el guardado automático.
Pipeline
El Constructor muestra el camino que recorre cada documento, de arriba abajo: del archivo recibido al JSON devuelto. Cada etapa tiene su propia configuración, y el mapa de etapas resume el estado de cada una — cuántos filtros, si la identificación está activa, cuántas etapas de posprocesamiento y cuántas validaciones.
Orden de las etapas
| # | Etapa | Recibe | Entrega |
|---|---|---|---|
| 1 | Documento | El archivo enviado (PDF o imagen). | Las páginas que entran en el pipeline, según el alcance del análisis. |
| 2 | Preprocesamiento | Las páginas seleccionadas. | Las imágenes con los filtros aplicados, de arriba abajo. |
| 3 | Identificación | La primera página del documento recibido, antes de los filtros. | Acepta el documento o, al rechazarlo, detiene el pipeline. |
| 4 | Extracción | Las imágenes preprocesadas. | El texto extraído y, según el método, tablas, formularios y bloques de texto. |
| 5 | Posprocesamiento | El resultado de la extracción. | El resultado transformado, etapa por etapa: cada una recibe la salida de la anterior. |
| 6 | Validaciones | El resultado final: la salida de la última etapa de posprocesamiento o, si no hay ninguna, el resultado de la extracción. | La aprobación o el rechazo de cada verificación. |
| 7 | Resultado | El resultado final. | El JSON devuelto a quien llamó a la API y enviado a los webhooks. |
Las etapas sin configuración no bloquean el camino: sin filtros, el documento pasa a la extracción tal como llegó; con la identificación desactivada, ningún documento se rechaza; sin posprocesamiento, el resultado de la extracción se devuelve tal cual; sin validaciones, todo resultado se acepta.
La extracción es la única etapa que siempre tiene configuración: una plantilla nueva empieza con el OCR Roberty Cloud y la extracción de tablas activada.
Tarjetas de capa
Preprocesamiento, posprocesamiento y validaciones son listas de capas — filtros, etapas o verificaciones — que se ejecutan de arriba abajo. Cada capa es una tarjeta con los mismos controles:
| Control | Qué hace |
|---|---|
| Agregar | Crea una capa del tipo elegido. Las capas nuevas entran al final de la lista. |
| Subir / Bajar | Cambia la posición de la capa y, con ella, el orden de ejecución. |
| Interruptor Activar / Desactivar | Activa o desactiva la capa. Una capa desactivada conserva su configuración, pero se omite en las ejecuciones. |
| Mostrar configuración / Ocultar configuración | Abre o cierra los campos de la capa. |
| Quitar | Elimina la capa de la lista. |
Desactivar una capa es útil para comparar resultados en el Playground con y sin ella, sin perder lo configurado.
Guardado automático
Cada cambio en el constructor se guarda automáticamente en el borrador de la plantilla, justo después de hacerlo — no hay botón de guardar. Si un guardado falla, el encabezado muestra Error al guardar con la opción Reintentar guardado.
El borrador es lo que ejecutan el Playground, Simular API y los casos de prueba. La producción y la API siguen usando la versión activa hasta que publiques una nueva. Consulta Versiones.
Solo los desarrolladores y administradores del workspace pueden editar plantillas.
Resultado
La última etapa del constructor es el Resultado: el JSON final, devuelto a quien llamó a la API y enviado a los webhooks. Desde ahí abres el Playground, para ejecutar el borrador en un documento de ejemplo y ver el resultado de cada etapa antes de publicar, o Simular API, para armar la llamada como lo haría un sistema externo. Consulta Playground y Simular API.