Pós-processamento
Transforme o resultado da extração no JSON que você quer com etapas de LLM e de código em Node.js ou Python no template de IDP: o contrato input/output/params e como os dados passam de uma etapa à outra.
Pós-processamento
O pós-processamento transforma o resultado da extração no JSON que você quer devolver. Ele é uma lista de etapas executadas de cima para baixo, cada uma com os controles de cartão descritos em Pipeline.
Há dois tipos de etapa:
| Tipo | O que faz |
|---|---|
| LLM | Reestrutura o resultado a partir de uma instrução em linguagem natural. |
| Código | Transforma o resultado com um script em Node.js ou Python. |
Sem nenhuma etapa, o resultado da extração é devolvido como está.
Como os dados passam entre as etapas
Cada etapa recebe o resultado atual do pipeline e entrega um novo resultado, que vira a entrada da etapa seguinte. A saída da última etapa é o resultado final, que segue para as validações e é devolvido a quem chamou o template.
A primeira etapa recebe o resultado da extração:
- só texto — OCR com LLM, ou OCR Roberty Cloud sem tabelas, formulários e blocos —: o texto, como uma string;
- com dados estruturados: um objeto com o texto e as partes extraídas.
{
"text": "NOTA FISCAL ...",
"tables": [{ "rows": [["Item", "Qtd", "Valor"], ["Parafuso", "10", "5,00"]] }],
"forms": [{ "key": "CNPJ:", "value": "12.345.678/0001-90" }]
}
Uma etapa desativada não muda nada: o resultado passa por ela como chegou.
Etapa de LLM
A etapa de LLM envia o resultado atual ao modelo configurado em Modelo, junto com a sua Instrução, por exemplo "Devolva um JSON com os campos numero, emissao e total.". Objetos são enviados ao modelo como JSON.
Quando a chamada ao template traz parâmetros, eles também são enviados ao modelo, depois do resultado, para que a instrução possa usá-los.
A resposta do modelo vira a saída da etapa. Se ela for um JSON — mesmo que venha dentro de um bloco de código Markdown —, a etapa entrega o objeto ou a lista já interpretados; caso contrário, entrega o texto.
Etapas de LLM precisam do recurso de IA generativa habilitado no workspace; sem ele, a opção aparece bloqueada. Entre em contato com o seu gerente de contas para habilitar o recurso.
Etapa de código
A etapa de Código roda um script em Node.js (padrão) ou Python, escolhido na barra do editor. O contrato é o mesmo nas duas linguagens:
| Variável | O que é |
|---|---|
input | O resultado atual do pipeline: o resultado da extração ou a saída da etapa anterior. |
output | Onde o script grava o resultado. O valor atribuído vira a saída da etapa. |
params | Só em Node.js: os parâmetros enviados na chamada ao template. Sem parâmetros, é {}. |
Uma etapa nova começa com output = input, que passa o resultado adiante sem mudanças. Se o código estiver vazio, a etapa também devolve a entrada como está.
Exemplo em Node.js, que monta um JSON a partir das tabelas e do texto:
const rows = input.tables?.[0]?.rows ?? [];
const numero = input.text.match(/N[ºo°]\s*(\d+)/)?.[1] ?? null;
output = {
numero,
itens: rows.slice(1).map(([item, quantidade, valor]) => ({ item, quantidade, valor })),
cliente: params.cliente ?? null,
};
Em Python, sem params:
tables = input.get("tables") or []
rows = tables[0]["rows"] if tables else []
output = {
"linhas": len(input["text"].splitlines()),
"itens": [
{"item": row[0], "quantidade": row[1], "valor": row[2]}
for row in rows[1:]
],
}
Em Node.js, o script roda isolado, com um limite de 5 segundos e só com os recursos básicos da linguagem (JSON, Math, Date, Object, Array, String, Number, Boolean): não há require nem acesso à rede, e o que for escrito com console.log não aparece no resultado. Se o script lançar um erro, a execução termina como Falhou.
O editor sugere os campos de input e de params a partir da última execução do Playground: rode o Playground uma vez com um documento de exemplo antes de escrever o código.
Dicas
- Use o OCR Roberty Cloud com tabelas e uma etapa de código quando o documento tem estrutura fixa; use uma etapa de LLM quando o layout varia e é mais fácil descrever o resultado do que programá-lo.
- Combine as duas: uma etapa de LLM que devolve um JSON, seguida de uma etapa de código que ajusta formatos, como datas e valores.
- No Playground, a aba Pós-processamento mostra a saída de cada etapa, para você conferir onde o resultado mudou.