Execuções
Acompanhe cada vez que um template de IDP processou um documento: ambientes, status, indicadores e os detalhes, o rastreamento e os logs de cada execução.
Execuções
A aba Execuções lista todas as vezes que o template processou um documento, e o que aconteceu em cada uma. Só desenvolvedores e administradores do workspace veem as execuções de um template.
Ambientes
As execuções são separadas por ambiente, porque uma falha no Playground e uma falha em produção são lidas de formas bem diferentes. Escolha o ambiente no seletor do topo; a aba abre em Desenvolvimento.
| Ambiente | O que alimenta | Configuração usada |
|---|---|---|
| Produção | Chamadas pela API e webhook, pela ação de robô e pela ação de agente de IA. Veja Usar templates em automações. | A versão ativa. |
| Desenvolvimento | O Playground e o Simular API. | O rascunho. |
| Testes | A Base de testes. | O rascunho. |
Lista de execuções
As execuções aparecem da mais recente para a mais antiga, 20 por página. Cada linha mostra:
- o nome do documento processado (ou Sem documento) e há quanto tempo a execução começou;
- a etiqueta via API ou via Webhook, quando a execução veio de uma chamada externa;
- no ambiente Testes, o veredito do caso: Passou ou Reprovou;
- o status e a duração.
Enquanto houver uma execução na fila ou em andamento, a lista se atualiza sozinha a cada poucos segundos. Use Atualizar para recarregar a qualquer momento.
Status
| Status | Significado |
|---|---|
| Aguardando arquivo | A execução foi reservada por uma chamada da API, mas o documento ainda não foi enviado. |
| Na fila | O documento chegou e a execução aguarda para começar. |
| Executando | O pipeline está processando o documento. |
| Concluída | O pipeline chegou ao fim. Isso inclui documentos rejeitados na identificação e resultados reprovados nas validações: são resultados válidos, não erros. |
| Falhou | A execução terminou com erro, por exemplo uma falha do modelo, um erro num script de pós-processamento ou um formato de arquivo não suportado. A mensagem aparece nos detalhes. |
| Expirado | O documento de uma chamada da API não foi enviado a tempo, e a reserva expirou. |
Indicadores
Acima da lista, três indicadores resumem o ambiente selecionado:
| Indicador | Como é calculado |
|---|---|
| Execuções | Quantas execuções o ambiente tem. |
| Taxa de sucesso | A porcentagem de execuções Concluída entre as que terminaram (Concluída ou Falhou). |
| Duração média | A média de duração das execuções que já terminaram. |
Detalhes de uma execução
Clique numa execução para abrir o painel com a data e hora de início, o status e três abas.
Detalhes
| Item | Descrição |
|---|---|
| Resultado do teste | Só no ambiente Testes: Passou ou Reprovou. |
| Documento | O nome e o formato do arquivo processado. |
| Páginas | As páginas pedidas na chamada, quando ela informou o campo page. |
| Parâmetros | Os parâmetros enviados na chamada, quando houver. |
| Saída | A saída final do pipeline: a saída da última etapa de pós-processamento ou, sem elas, o texto extraído. |
| Erro | A mensagem de erro, quando a execução falhou. |
| Ambiente, Início, Fim e Duração | Onde e quando a execução rodou e quanto tempo levou. |
Rastreamento
O Rastreamento mostra a árvore do pipeline como ele rodou: o documento recebido e, abaixo dele, cada etapa executada, com seus filtros, etapas e validações. Etapas que não chegaram a rodar não aparecem; quando a identificação rejeita o documento, ela é marcada como Interrompido. Validações reprovadas mostram o motivo ao lado do nome.
Clique em qualquer item para ver o valor registrado — por exemplo, o texto extraído, a saída de uma etapa ou a resposta de uma validação —, Formatado ou Bruto. Imagens, como as prévias do pré-processamento, aparecem como imagem.
Logs
Os Logs mostram o mesmo caminho em formato de linhas, uma por etapa, com o tempo desde o início da execução e a duração de cada passo, por exemplo [+1520ms] Extração (840ms). O tempo desde o início é calculado somando as durações das etapas, na ordem do pipeline.