Ejecutar una plantilla de IDP
Procesa un documento con una plantilla de IDP del workspace desde el agente.
Ejecutar una plantilla de IDP
Permite que el agente procese un documento con una plantilla de IDP del workspace. El agente envía el archivo, espera el procesamiento y recibe el resultado estructurado: identificación, texto extraído, salidas de posprocesamiento y validaciones.
Configuración
| Campo | Obligatorio | Qué es |
|---|---|---|
| Plantilla de IDP | Sí | La plantilla de IDP que procesará los documentos. Cada acción usa una sola plantilla; para usar varias plantillas, añade una acción por plantilla |
| Tiempo límite (ms) | No | Cuánto esperar el procesamiento, en milisegundos. Por defecto: 300000 (5 minutos). Máximo: 840000 (14 minutos) |
La plantilla necesita una versión publicada activa. El agente siempre usa la versión activa en el momento de la llamada; los cambios en el borrador de la plantilla solo se aplican después de publicarlos.
De dónde viene el archivo
El agente puede enviar a la plantilla:
- Un archivo adjunto en la conversación — el agente usa el nombre del archivo que el usuario envió en el chat.
- Un archivo enviado con una ejecución por API — los archivos enviados junto con la ejecución del agente.
- Un archivo de una herramienta de almacenamiento — por ejemplo, un archivo obtenido con la acción Descargar un archivo de Google Drive o de OneDrive. Las dos acciones deben estar configuradas en el mismo agente.
Se aceptan PDF e imágenes (PNG, JPG, JPEG, WEBP, TIFF y BMP) de hasta 5 MB.
Cómo funciona
Cuando el agente usa esta herramienta:
- Encuentra el archivo indicado (adjunto, archivo de la ejecución o archivo de almacenamiento).
- Envía el archivo a la plantilla de IDP configurada, usando la versión publicada activa.
- Espera el procesamiento hasta el tiempo límite configurado.
- Recibe el resultado y responde a partir de él.
Cada procesamiento aparece en el historial de Ejecuciones de la plantilla, en la pestaña Producción, con el origen Webhook, y se contabiliza en el consumo de IDP del workspace como cualquier otra ejecución.
Si se alcanza el tiempo límite, el procesamiento continúa en IDP y se puede consultar en el historial de ejecuciones de la plantilla.
Parámetros de entrada (en tiempo de ejecución)
| Parámetro | Qué es |
|---|---|
| Nombre del archivo | El nombre exacto del archivo adjunto en la conversación, enviado con la ejecución o devuelto por la herramienta de almacenamiento |
| URL de descarga | Solo para archivos de almacenamiento: la URL de descarga que devuelve la acción Descargar un archivo |
| Tipo de archivo | Solo para archivos de almacenamiento: el tipo MIME que devuelve la misma acción |
El agente nunca elige la plantilla: siempre es la configurada en la acción.
Respuesta
| Campo | Qué es |
|---|---|
| Éxito | true si la plantilla terminó el procesamiento, false ante un error o un tiempo agotado |
| ID de la solicitud | El identificador de la ejecución en el historial de la plantilla |
| Resultado | El resultado de la plantilla (cuando tuvo éxito): identificación, texto extraído, salidas de posprocesamiento y validaciones |
| Error | El código de error (cuando el procesamiento falló o agotó el tiempo) |
Si la etapa de identificación de la plantilla rechaza el documento, la respuesta sigue siendo exitosa y el resultado informa el rechazo, sin texto extraído.
Errores comunes
| Código | Significado |
|---|---|
FILE_NOT_FOUND | No se envió ningún archivo con ese nombre en la conversación ni en la ejecución |
UNSUPPORTED_FILE_EXTENSION | El archivo no es un PDF ni una imagen que IDP acepte |
FILE_TOO_LARGE | El archivo supera los 5 MB |
URL_NOT_ALLOWED | La URL de descarga no viene de Google Drive ni de OneDrive |
FILE_DOWNLOAD_FAILED | No se pudo descargar el archivo (por ejemplo, la URL de descarga expiró) |
TEMPLATE_NOT_FOUND | La plantilla configurada ya no existe en este workspace |
NO_ACTIVE_VERSION | La plantilla no tiene una versión publicada activa |
TIMEOUT | El procesamiento no terminó dentro del tiempo límite |