Saltar al contenido principal
Roberty Studio
IDPIDP

Playground y Simular API

Prueba el borrador de una plantilla de IDP antes de publicar: el Playground, que muestra el resultado de cada etapa, y Simular API, que arma la llamada como lo haría un sistema externo.

Playground y Simular API

La plantilla ofrece dos formas de probar el borrador — la configuración actual del constructor, con los cambios aún sin publicar — en un documento de prueba. Las dos están en el menú Probar, arriba de la plantilla, y al final del constructor, en la etapa Resultado.

HerramientaPara qué sirve
PlaygroundEjecuta el borrador en un documento de ejemplo y muestra el resultado de cada etapa.
Simular APIArma la llamada como lo haría un sistema externo y muestra un resumen del procesamiento.

Las dos ejecutan el borrador, no la versión activa, y registran la ejecución en el entorno Desarrollo, en Ejecuciones. Para probar varios documentos a la vez y compararlos con el resultado esperado, usa los casos de prueba.

Solo los desarrolladores y administradores del workspace pueden ejecutar pruebas.

aviso

Una ejecución de prueba es una ejecución real del pipeline: cuenta en la cuota de solicitudes de IDP del workspace, consume OCR e IA según las etapas, y las validaciones por robot ejecutan el robot de verdad.

Playground​

Entradas​

EntradaDescripción
Documento de pruebaUn PDF, PNG o JPG, arrastrado al Playground o elegido en tu equipo. El documento de referencia de la plantilla no se carga automáticamente, y el documento de prueba no se guarda en la plantilla. Usa Cambiar para probar otro archivo.
Pág.Las páginas del documento de prueba que se procesan, con la misma sintaxis que el alcance del análisis, por ejemplo 1-3, 5. Vacío procesa las páginas del alcance de la plantilla. Solo aparece cuando la opción Permitir que la API sobrescriba las páginas por ejecución está activada; consulta Documento y páginas.
Parámetros (JSON)Opcional. Un objeto JSON enviado junto con el documento, como los parámetros de una llamada por la API, por ejemplo {"cliente": "ACME"}. Debe ser un objeto; cualquier otro valor se rechaza.

Haz clic en Ejecutar para ejecutar el pipeline. El Playground sigue la ejecución hasta el final y desiste tras 5 minutos sin respuesta, con un mensaje de tiempo límite excedido; la ejecución sigue registrada en Ejecuciones.

Resultado por etapa​

Al terminar, el Playground muestra una pestaña por etapa del pipeline. Las etapas que no hicieron nada con el documento aparecen vacías en el mapa de la ejecución.

PestañaQué muestra
DocumentoEl documento de prueba enviado.
PreprocesamientoLa imagen después de cada filtro y la imagen final.
IdentificaciónLa similitud con la referencia, si el documento se aceptó o se rechazó, el tipo detectado y las señales de fraude. Cuando el documento se rechaza, muestra Pipeline interrumpido, y las etapas siguientes aparecen como no ejecutadas.
ExtracciónEl Texto extraído, los Formularios, las Tablas y los Bloques de texto, según el método, con búsqueda en el contenido. Los bloques muestran la confianza — alta desde el 90%, media desde el 70% — y la posición; la imagen de la página muestra solo la página 1.
PosprocesamientoLa salida de cada etapa, en orden.
ValidacionesEl marcador, por ejemplo "2/3 aprobadas", y el resultado de cada validación. En las validaciones por robot, los argumentos enviados y la respuesta del robot.
ResultadoLa salida final del pipeline, formateada (Pretty) o en bruto (Raw), y el tiempo total de la ejecución.

El Playground también alimenta el editor: después de una ejecución, los editores de código del posprocesamiento y de las validaciones y la asignación de entradas del robot sugieren los campos del resultado y de los parámetros.

Simular API​

Simular API abre la ventana Simular procesamiento, que arma la llamada como lo haría un sistema externo: un archivo, las páginas (cuando la opción de sobrescribir páginas está activada) y los Parámetros, un objeto JSON opcional.

Acepta archivos pdf, png, jpg, jpeg, webp, tiff, tif y bmp. Haz clic en Ejecutar pipeline para procesarlo.

El resultado muestra un resumen — Tiempo total, Identificación (aceptado o rechazado), Método de extracción y Validaciones aprobadas — y una pestaña por etapa: Identificación, Preprocesamiento, Extracción, Posprocesamiento y Validaciones.

Simular API ejecuta el borrador actual, en el entorno Desarrollo, y no la versión activa. Cuando la plantilla aún no tiene una versión publicada y activa, la ventana muestra un aviso, pero la simulación se ejecuta igualmente. Para llamar a la plantilla por la API real, consulta API y webhook.

Cuándo usar cada uno​

UsaCuándo
PlaygroundEstás armando o ajustando el pipeline y quieres ver qué hizo cada etapa: los filtros, el texto extraído, la salida de cada paso del posprocesamiento.
Simular APIQuieres comprobar el resultado como lo vería una integración, con el archivo, las páginas y los parámetros que enviará el sistema externo.
Casos de pruebaQuieres asegurarte de que un cambio no rompió documentos que ya funcionaban, antes de publicar.