Pipeline
Como o pipeline de um template de IDP é montado no construtor: a ordem das etapas, o que passa de uma para a outra, os cartões de cada camada e o salvamento automático.
Pipeline
O Construtor mostra o caminho que todo documento percorre, de cima para baixo: do arquivo recebido ao JSON devolvido. Cada etapa tem sua própria configuração, e o mapa de etapas resume o estado de cada uma — quantos filtros, se a identificação está ativa, quantas etapas de pós-processamento e quantas validações.
Ordem das etapas
| # | Etapa | Recebe | Entrega |
|---|---|---|---|
| 1 | Documento | O arquivo enviado (PDF ou imagem). | As páginas que entram no pipeline, conforme o escopo de análise. |
| 2 | Pré-processamento | As páginas selecionadas. | As imagens com os filtros aplicados, de cima para baixo. |
| 3 | Identificação | A primeira página do documento recebido, antes dos filtros. | Aceita o documento ou, ao rejeitá-lo, interrompe o pipeline. |
| 4 | Extração | As imagens pré-processadas. | O texto extraído e, conforme o método, tabelas, formulários e blocos de texto. |
| 5 | Pós-processamento | O resultado da extração. | O resultado transformado, etapa por etapa: cada uma recebe a saída da anterior. |
| 6 | Validações | O resultado final: a saída da última etapa de pós-processamento ou, sem elas, o resultado da extração. | Aprovação ou reprovação de cada verificação. |
| 7 | Resultado | O resultado final. | O JSON devolvido a quem chamou a API e enviado aos webhooks. |
Etapas sem configuração não bloqueiam o caminho: sem filtros, o documento segue para a extração como foi enviado; com a identificação desligada, nenhum documento é recusado; sem pós-processamento, o resultado da extração é devolvido como está; sem validações, todo resultado é aceito.
A extração é a única etapa que sempre tem uma configuração: um template novo já começa com o OCR Roberty Cloud e a extração de tabelas ligada.
Cartões de camada
Pré-processamento, pós-processamento e validações são listas de camadas — filtros, etapas ou verificações — executadas de cima para baixo. Cada camada é um cartão com os mesmos controles:
| Controle | O que faz |
|---|---|
| Adicionar | Cria uma camada do tipo escolhido. Camadas novas entram no fim da lista. |
| Mover para cima / Mover para baixo | Muda a posição da camada e, com ela, a ordem de execução. |
| Chave Ativar / Desativar | Liga ou desliga a camada. Uma camada desativada mantém suas configurações, mas é ignorada nas execuções. |
| Mostrar configurações / Ocultar configurações | Abre ou fecha os campos da camada. |
| Remover | Exclui a camada da lista. |
Desativar uma camada é útil para comparar resultados no Playground com e sem ela, sem perder o que foi configurado.
Salvamento automático
Toda alteração no construtor é salva automaticamente no rascunho do template, logo depois de feita — não há botão de salvar. Se um salvamento falhar, o cabeçalho mostra Erro ao salvar com a opção Tentar salvar novamente.
O rascunho é o que o Playground, o Simular API e a Base de testes executam. A produção e a API continuam usando a versão ativa até que você publique uma nova. Veja Versões.
Só desenvolvedores e administradores do workspace podem editar templates.
Resultado
A última etapa do construtor é o Resultado: o JSON final, devolvido a quem chamou a API e enviado aos webhooks. Dela você abre o Playground, para rodar o rascunho num documento de exemplo e ver o resultado de cada etapa antes de publicar, ou o Simular API, para montar a chamada como um sistema externo faria. Veja Playground e Simular API.