Pular para o conteúdo principal
Roberty Studio
IDPConstrutor

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:

TipoO que faz
LLMReestrutura o resultado a partir de uma instrução em linguagem natural.
CódigoTransforma 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.
json
{
"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.

informação

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ávelO que é
inputO resultado atual do pipeline: o resultado da extração ou a saída da etapa anterior.
outputOnde o script grava o resultado. O valor atribuído vira a saída da etapa.
paramsSó 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:

js
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:

python
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.