Pular para o conteúdo principal
Roberty Studio
IDPRoberty Studio

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.

EtapaO que faz
DocumentoGuarda o documento de referência do template e define quais páginas de cada documento recebido entram no pipeline.
Pré-processamentoFiltros de imagem aplicados ao documento antes da extração, como escala de cinza e nitidez.
IdentificaçãoConfere se o documento recebido é do tipo esperado antes de extrair qualquer coisa, e pode recusá-lo.
ExtraçãoTira o conteúdo do documento com um único método: OCR Roberty Cloud ou OCR com LLM.
Pós-processamentoEtapas de LLM ou de código que transformam o resultado da extração no JSON que você quer.
ValidaçõesVerificações que o resultado final precisa passar: código, chamada a uma API ou um robô.
ResultadoO 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:

AmbienteO que alimenta
ProduçãoChamadas pela API e webhook, pela ação de robô e pela ação de agente de IA.
DesenvolvimentoExecuções do Playground e do Simular API.
TestesExecuçõ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.

informação

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.

Nesta seção​