Saltar al contenido principal
Roberty Studio
IDPIDP

Usar plantillas en automatizaciones

Llama a una plantilla de IDP por la API pública, desde un robot RPA o desde un agente de IA, y conoce los límites de cada opción.

Usar plantillas en automatizaciones

Una plantilla de IDP publicada se puede llamar de tres formas: por la API pública, desde un robot RPA o desde un agente de IA. Las tres ejecutan siempre la versión activa — nunca el borrador —, registran la ejecución en el entorno Producción, en Ejecuciones, y cuentan en el consumo de solicitudes de IDP del workspace.

Sin una versión activa, las tres fallan con el error NO_ACTIVE_VERSION. Cuando la identificación rechaza el documento, la llamada no falla: el resultado informa del rechazo.

Comparación​

API públicaAcción de robotAcción de agente de IA
Quién llamaCualquier sistema externoUn robot RPA del workspaceUn agente de IA del workspace
AutenticaciónUna clave de API del workspace con el alcance Plantillas IDPNinguna: el robot usa la identidad del dispositivoNinguna: el agente se ejecuta dentro del workspace
De dónde viene el archivoLo envía el sistema a una URL firmadaUna ruta en el dispositivo que ejecuta el robotUn adjunto de la conversación, un archivo de la ejecución por API o un archivo descargado de Google Drive o de OneDrive
FormatosPDF, PNG, JPG, JPEG, WEBP, TIFF, TIF y BMPPDF, PNG, JPG, JPEG, WEBP, TIFF, TIF y BMPPDF e imágenes (PNG, JPG, JPEG, WEBP, TIFF y BMP) de hasta 15 MB
Páginas y parámetrosCampos page y paramsOpciones avanzadas Páginas a procesar y ParámetrosNo se envían
Espera del resultadoEl sistema consulta el estado hasta el finalTiempo de espera: 10 minutos por defecto; 0 espera indefinidamenteTiempo límite: 5 minutos por defecto, 14 minutos como máximo

El envío de páginas, por la API o por la acción de robot, solo se acepta cuando la plantilla permite que la API sobrescriba las páginas. Consulta Documento y páginas.

API pública​

Para integrar sistemas que no se ejecutan en Roberty. La llamada tiene tres pasos: solicitar la ejecución, enviar el documento a la URL firmada devuelta, válida durante 15 minutos, y consultar el resultado por su requestId.

Consulta API y webhook.

Acción de robot​

La acción Ejecutar plantilla IDP envía un archivo del dispositivo que ejecuta el robot, espera el procesamiento y devuelve el requestId y el resultado completo de la plantilla. Úsala cuando el documento ya está en una carpeta local, por ejemplo después de descargarlo de un portal o de un correo.

  • El robot consulta el progreso cada 2 segundos hasta el final o hasta que se agote el Tiempo de espera.
  • La acción falla con FILE_NOT_FOUND si el archivo no existe en el dispositivo, con TIMEOUT si se agota el tiempo de espera, con EXPIRED si la ejecución expira, y con el mensaje de error de la plantilla si el procesamiento falla.

Consulta Ejecutar plantilla IDP.

Acción de agente de IA​

La acción Ejecutar una plantilla de IDP permite que el agente procese un documento con una plantilla y responda a partir del resultado. Cada acción usa una sola plantilla, elegida en su configuración: el agente nunca elige la plantilla.

  • Archivos de hasta 15 MB.
  • Si se agota el tiempo límite, el procesamiento continúa en la plantilla y se puede consultar en Ejecuciones.

Consulta Ejecutar una plantilla de IDP.

información

Llamar a plantillas por la API y por la acción de robot depende de que el plan del workspace incluya solicitudes de IDP y webhooks. Si una llamada se rechaza por falta de la función, contacta con tu gerente de cuenta.