Executar template IDP
Processe um documento com um template IDP do workspace diretamente pelo agente.
Executar template IDP
Permite que o agente processe um documento com um template IDP do workspace. O agente envia o arquivo, aguarda o processamento e recebe o resultado estruturado: identificação, texto extraído, saídas de pós-processamento e validações.
Configuração
| Campo | Obrigatório | Descrição |
|---|---|---|
| Template IDP | Sim | Selecione o template IDP que processará os documentos. Cada ação usa um único template; para usar vários templates, adicione uma ação para cada um |
| Tempo limite (ms) | Não | Tempo máximo de espera pelo processamento, em milissegundos. Padrão: 300000 (5 minutos). Valor máximo: 840000 (14 minutos) |
O template precisa ter uma versão publicada ativa. O agente sempre usa a versão ativa no momento da chamada; alterações no rascunho do template só passam a valer depois de publicadas.
De onde vem o arquivo
O agente pode enviar ao template:
- Um arquivo anexado na conversa — o agente usa o nome do arquivo enviado pelo usuário no chat.
- Um arquivo enviado na execução por API — os arquivos enviados junto com a execução do agente.
- Um arquivo de uma ferramenta de armazenamento — por exemplo, um arquivo baixado com a ação Baixar arquivo do Google Drive ou do OneDrive. Para isso, as duas ações precisam estar configuradas no mesmo agente.
São aceitos arquivos PDF e imagens (PNG, JPG, JPEG, WEBP, TIFF e BMP) de até 5 MB.
Como funciona
Quando o agente aciona esta ferramenta:
- Localiza o arquivo indicado (anexo, arquivo da execução ou arquivo de armazenamento).
- Envia o arquivo para o template IDP configurado, usando a versão publicada ativa.
- Aguarda o processamento até o tempo limite configurado.
- Recebe o resultado e responde com base nele.
Cada processamento aparece no histórico de Execuções do template, na aba Produção, com a origem Webhook, e é contabilizado no consumo de IDP do workspace como qualquer outra execução.
Se o tempo limite for atingido, o processamento continua no IDP e pode ser consultado no histórico de execuções do template.
Parâmetros de entrada (em tempo de execução)
| Parâmetro | Descrição |
|---|---|
| Nome do arquivo | Nome exato do arquivo anexado na conversa, do arquivo enviado na execução ou do arquivo retornado pela ferramenta de armazenamento |
| URL de download | Usado apenas para arquivos de ferramentas de armazenamento: a URL de download retornada pela ação Baixar arquivo |
| Tipo do arquivo | Usado apenas para arquivos de ferramentas de armazenamento: o tipo MIME retornado pela mesma ação |
O agente nunca escolhe o template: ele é sempre o configurado na ação.
Resposta
| Campo | Descrição |
|---|---|
| Sucesso | true se o template concluiu o processamento, false se houve erro ou timeout |
| ID da requisição | Identificador da execução no histórico do template |
| Resultado | Resultado do template (quando bem-sucedido): identificação, texto extraído, saídas de pós-processamento e validações |
| Erro | Código do erro (quando o processamento falhou ou atingiu o tempo limite) |
Se a etapa de identificação do template rejeitar o documento, a resposta é bem-sucedida e o resultado informa a rejeição, sem texto extraído.
Erros comuns
| Código | Significado |
|---|---|
FILE_NOT_FOUND | Nenhum arquivo com esse nome foi enviado na conversa ou na execução |
UNSUPPORTED_FILE_EXTENSION | O arquivo não é um PDF ou imagem aceito pelo IDP |
FILE_TOO_LARGE | O arquivo tem mais de 5 MB |
URL_NOT_ALLOWED | A URL de download não vem do Google Drive ou do OneDrive |
FILE_DOWNLOAD_FAILED | Não foi possível baixar o arquivo (por exemplo, a URL de download expirou) |
TEMPLATE_NOT_FOUND | O template configurado não existe mais neste workspace |
NO_ACTIVE_VERSION | O template não tem uma versão publicada ativa |
TIMEOUT | O processamento não terminou dentro do tempo limite |