Playground e Simular API
Teste o rascunho de um template de IDP antes de publicar: o Playground, que mostra o resultado de cada etapa, e o Simular API, que monta a chamada como um sistema externo faria.
Playground e Simular API
O template oferece duas formas de testar o rascunho — a configuração atual do construtor, com as mudanças ainda não publicadas — num documento de teste. As duas ficam no menu Testar, no topo do template, e no fim do construtor, na etapa Resultado.
| Ferramenta | Para que serve |
|---|---|
| Playground | Roda o rascunho num documento de exemplo e mostra o resultado de cada etapa. |
| Simular API | Monta a chamada como um sistema externo faria e mostra um resumo do processamento. |
As duas executam o rascunho, não a versão ativa, e registram a execução no ambiente Desenvolvimento, em Execuções. Para testar vários documentos de uma vez e comparar com o resultado esperado, use a Base de testes.
Só desenvolvedores e administradores do workspace podem executar testes.
Uma execução de teste é uma execução real do pipeline: conta na cota de requisições de IDP do workspace, consome OCR e IA conforme as etapas, e as validações por robô executam o robô de verdade.
Playground
Entradas
| Entrada | Descrição |
|---|---|
| Documento de teste | Um PDF, PNG ou JPG, arrastado para o Playground ou escolhido no seu computador. O documento de referência do template não é carregado automaticamente, e o documento de teste não fica salvo no template. Use Trocar para testar outro arquivo. |
| Pág. | As páginas do documento de teste a processar, com a mesma sintaxe do escopo de análise, por exemplo 1-3, 5. Vazio processa as páginas do escopo do template. Só aparece quando a opção Permitir que a API sobrescreva as páginas por execução está ligada; veja Documento e páginas. |
| Parâmetros (JSON) | Opcional. Um objeto JSON enviado junto com o documento, como os parâmetros de uma chamada pela API, por exemplo {"cliente": "ACME"}. Precisa ser um objeto; outro valor é recusado. |
Clique em Executar para rodar o pipeline. O Playground acompanha a execução até o fim e desiste depois de 5 minutos sem resposta, com a mensagem de tempo limite excedido; a execução continua registrada em Execuções.
Resultado por etapa
Ao terminar, o Playground mostra uma aba por etapa do pipeline. Etapas que não fizeram nada com o documento aparecem vazias no mapa da execução.
| Aba | O que mostra |
|---|---|
| Documento | O documento de teste enviado. |
| Pré-processamento | A imagem depois de cada filtro e a imagem final. |
| Identificação | A similaridade com a referência, se o documento foi aceito ou rejeitado, o tipo detectado e os sinais de fraude. Quando o documento é rejeitado, mostra Pipeline interrompido, e as etapas seguintes aparecem como não executadas. |
| Extração | O Texto extraído, os Formulários, as Tabelas e os Blocos de texto, conforme o método, com busca no conteúdo. Os blocos mostram a confiança — alta a partir de 90%, média a partir de 70% — e a posição; a imagem da página mostra apenas a página 1. |
| Pós-processamento | A saída de cada etapa, na ordem. |
| Validações | O placar, por exemplo "2/3 aprovadas", e o resultado de cada validação. Para validações por robô, os argumentos enviados e a resposta do robô. |
| Resultado | A saída final do pipeline, formatada (Pretty) ou bruta (Raw), e o tempo total da execução. |
O Playground também alimenta o editor: depois de uma execução, os editores de código do pós-processamento e das validações e o mapeamento de entradas do robô sugerem os campos do resultado e dos parâmetros.
Simular API
O Simular API abre a janela Simular processamento, que monta a chamada como um sistema externo faria: um arquivo, as páginas (quando a opção de sobrescrever páginas está ligada) e os Parâmetros, um objeto JSON opcional.
Aceita arquivos pdf, png, jpg, jpeg, webp, tiff, tif e bmp. Clique em Executar pipeline para processar.
O resultado traz um resumo — Tempo total, Identificação (aceito ou rejeitado), Método de extração e Validações aprovadas — e uma aba por etapa: Identificação, Pré-processamento, Extração, Pós-processamento e Validações.
O Simular API executa o rascunho atual, no ambiente Desenvolvimento, e não a versão ativa. Quando o template ainda não tem uma versão publicada e ativa, a janela mostra um aviso, mas a simulação roda do mesmo jeito. Para chamar o template pela API de verdade, veja API e webhook.
Quando usar cada um
| Use | Quando |
|---|---|
| Playground | Você está montando ou ajustando o pipeline e quer ver o que cada etapa fez: os filtros, o texto extraído, a saída de cada passo do pós-processamento. |
| Simular API | Você quer conferir o resultado como uma integração o veria, com o arquivo, as páginas e os parâmetros que o sistema externo vai mandar. |
| Base de testes | Você quer garantir que uma mudança não quebrou documentos que já funcionavam, antes de publicar. |