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ública | Acción de robot | Acción de agente de IA | |
|---|---|---|---|
| Quién llama | Cualquier sistema externo | Un robot RPA del workspace | Un agente de IA del workspace |
| Autenticación | Una clave de API del workspace con el alcance Plantillas IDP | Ninguna: el robot usa la identidad del dispositivo | Ninguna: el agente se ejecuta dentro del workspace |
| De dónde viene el archivo | Lo envía el sistema a una URL firmada | Una ruta en el dispositivo que ejecuta el robot | Un adjunto de la conversación, un archivo de la ejecución por API o un archivo descargado de Google Drive o de OneDrive |
| Formatos | PDF, PNG, JPG, JPEG, WEBP, TIFF, TIF y BMP | PDF, PNG, JPG, JPEG, WEBP, TIFF, TIF y BMP | PDF e imágenes (PNG, JPG, JPEG, WEBP, TIFF y BMP) de hasta 15 MB |
| Páginas y parámetros | Campos page y params | Opciones avanzadas Páginas a procesar y Parámetros | No se envían |
| Espera del resultado | El sistema consulta el estado hasta el final | Tiempo de espera: 10 minutos por defecto; 0 espera indefinidamente | Tiempo 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_FOUNDsi el archivo no existe en el dispositivo, conTIMEOUTsi se agota el tiempo de espera, conEXPIREDsi 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.
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.