Pular para o conteúdo principal
Roberty Studio
IDPIDP

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.

FerramentaPara que serve
PlaygroundRoda o rascunho num documento de exemplo e mostra o resultado de cada etapa.
Simular APIMonta 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.

aviso

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​

EntradaDescrição
Documento de testeUm 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.

AbaO que mostra
DocumentoO documento de teste enviado.
Pré-processamentoA imagem depois de cada filtro e a imagem final.
IdentificaçãoA 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çãoO 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-processamentoA saída de cada etapa, na ordem.
ValidaçõesO 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ô.
ResultadoA 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​

UseQuando
PlaygroundVocê 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 APIVocê 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 testesVocê quer garantir que uma mudança não quebrou documentos que já funcionavam, antes de publicar.