IDP
Templates que recebem um documento, identificam, extraem, tratam e validam seus dados em um pipeline e devolvem um JSON, testável, versionado e acessível por API.
IDP
O IDP (processamento inteligente de documentos) transforma documentos — notas fiscais, formulários, comprovantes, PDFs e imagens — em dados estruturados. Cada caso de uso é um template: um pipeline que recebe um documento, passa por etapas configuráveis e devolve um JSON a quem chamou.
Use templates de IDP quando um processo depende de ler documentos que chegam de fora — de clientes, fornecedores, e-mails ou portais — e você quer que essa leitura seja padronizada, testada antes de entrar em produção e chamada por sistemas, robôs e agentes.
O pipeline
Todo documento percorre as mesmas etapas, de cima para baixo: do arquivo recebido ao JSON devolvido.
| Etapa | O que faz |
|---|---|
| Documento | Guarda o documento de referência do template e define quais páginas de cada documento recebido entram no pipeline. |
| Pré-processamento | Filtros de imagem aplicados ao documento antes da extração, como escala de cinza e nitidez. |
| Identificação | Confere se o documento recebido é do tipo esperado antes de extrair qualquer coisa, e pode recusá-lo. |
| Extração | Tira o conteúdo do documento com um único método: OCR Roberty Cloud ou OCR com LLM. |
| Pós-processamento | Etapas de LLM ou de código que transformam o resultado da extração no JSON que você quer. |
| Validações | Verificações que o resultado final precisa passar: código, chamada a uma API ou um robô. |
| Resultado | O JSON final, devolvido a quem chamou a API e enviado aos webhooks. |
Etapas sem configuração são simplesmente puladas: sem filtros, o documento segue para a extração como foi enviado; sem pós-processamento, o resultado da extração é devolvido como está; sem validações, todo resultado é aceito. Veja Construtor.
Rascunho e versão ativa
Tudo o que você edita no template fica no rascunho, salvo automaticamente. O rascunho é o que o Playground, o Simular API e a Base de testes executam, para você testar mudanças sem afetar quem já usa o template.
Ao publicar, toda a configuração do pipeline é congelada em uma versão. A versão marcada como ativa é a que atende em produção: a API, a ação de robô e a ação de agente sempre executam a versão ativa. Enquanto não houver uma versão publicada, o template não processa documentos pela API. Veja Versões.
Ambientes
Cada execução do template é registrada em um de três ambientes:
| Ambiente | O que alimenta |
|---|---|
| Produção | Chamadas pela API e webhook, pela ação de robô e pela ação de agente de IA. |
| Desenvolvimento | Execuções do Playground e do Simular API. |
| Testes | Execuções da Base de testes. |
Veja Execuções.
Onde os templates ficam
Templates de IDP são criados e organizados na aba Arquivos do workspace, junto com robôs, agentes e projetos de código. Ao abrir um template, ele é exibido em abas: Construtor, Base de testes, Execuções, Versões e Configurações. No topo ficam a versão ativa (ou Rascunho, se ainda não houver uma), o menu Testar — Playground, Simular API e Base de testes — e o botão Publicar.
Só desenvolvedores e administradores do workspace podem criar e editar templates. Veja Papéis e permissões.
O template pode ser ativado ou desativado em Configurações › Geral.
Algumas etapas dependem de recursos habilitados no workspace. A identificação, o OCR com LLM e as etapas de LLM do pós-processamento precisam do recurso de IA generativa; o OCR Roberty Cloud precisa do recurso de mesmo nome. Se uma opção aparecer bloqueada, entre em contato com o seu gerente de contas para habilitar o recurso.