Pular para o conteúdo principal
Roberty Studio
IDPConstrutor

Documento e páginas

Envie o documento de referência do template de IDP, defina quais páginas de cada documento recebido entram no pipeline e se a API pode trocá-las a cada execução.

Documento e páginas

A etapa Documento abre o pipeline. Ela guarda o documento de referência que a identificação usa para comparar e define quais páginas de cada documento recebido são analisadas.

Documento de referência​

O documento de referência é um exemplo típico do documento que o template vai receber: um PDF, PNG ou JPG de até 15 MB. Ele é a base da comparação feita pela identificação.

Depois do envio, a etapa mostra uma miniatura do documento, o número de páginas, o tamanho e a data de envio. Em Ver páginas você navega por todas as páginas do documento.

Para trocar o documento, clique em Substituir documento ou solte um novo arquivo sobre a etapa. O documento de referência é opcional: sem ele, a identificação usa apenas o tipo de documento e os critérios que você descrever.

Escopo de análise​

O campo Escopo de análise define quais páginas de cada documento recebido entram no pipeline. Vazio, todas as páginas são analisadas, em uma única execução.

Para limitar, escreva as páginas como em uma impressão: números separados por vírgula e intervalos com hífen, por exemplo 1-3, 5, 8-10. O campo aceita apenas dígitos, vírgulas, espaços e hífens, e mostra logo abaixo quais páginas serão analisadas.

RegraExemplo
Intervalos podem ser decrescentes.10-8 analisa as páginas 10, 9 e 8.
Páginas que não existem no documento são descartadas.Em um documento de 4 páginas, 3-6 analisa as páginas 3 e 4.
Páginas repetidas são analisadas uma vez só.1-3, 2 analisa as páginas 1, 2 e 3.
A ordem escrita é mantida.5, 1-2 analisa as páginas 5, 1 e 2.
Um intervalo sem nenhuma página válida vale como vazio.Todas as páginas são analisadas.

Páginas definidas pela API​

A opção Permitir que a API sobrescreva as páginas por execução vem desligada. Quando ligada, cada chamada da API pode informar suas próprias páginas no campo page, com a mesma sintaxe do escopo de análise (um número sozinho também vale). Essas páginas valem só para aquela execução; o escopo salvo no template não muda.

Com a opção ligada, o Playground e o Simular API também mostram um campo de páginas, para você testar como uma chamada com page se comporta.

aviso

Com a opção desligada, uma chamada da API que envie o campo page é recusada com o status 400. Veja API e webhook.

Documentos com várias páginas​

Todas as páginas selecionadas são processadas na mesma execução. O que muda é como cada método de extração lida com elas:

MétodoComo processa
OCR com LLMEnvia todas as páginas selecionadas ao modelo em uma única chamada, para que ele leia o documento com o contexto de todas as páginas.
OCR Roberty CloudProcessa página por página e junta os resultados. O texto de cada página é marcado com === Página N de M ===, em que N é o número real da página no documento e M é o total de páginas do documento. Tabelas, formulários e blocos de texto recebem o número da página de onde vieram.

Veja Extração.