Saltar al contenido principal
Roberty Studio
IDPConstructor

Posprocesamiento

Convierte el resultado de la extracción en el JSON que quieres con etapas de LLM y de código en Node.js o Python en una plantilla de IDP: el contrato input/output/params y cómo pasan los datos de una etapa a otra.

Posprocesamiento

El posprocesamiento convierte el resultado de la extracción en el JSON que quieres devolver. Es una lista de etapas que se ejecutan de arriba abajo, cada una con los controles de tarjeta descritos en Pipeline.

Hay dos tipos de etapa:

TipoQué hace
LLMReestructura el resultado a partir de una instrucción en lenguaje natural.
CódigoTransforma el resultado con un script en Node.js o Python.

Sin ninguna etapa, el resultado de la extracción se devuelve tal cual.

Cómo pasan los datos entre etapas​

Cada etapa recibe el resultado actual del pipeline y entrega un resultado nuevo, que pasa a ser la entrada de la etapa siguiente. La salida de la última etapa es el resultado final, que pasa a las validaciones y se devuelve a quien llamó a la plantilla.

La primera etapa recibe el resultado de la extracción:

  • solo texto — OCR con LLM, u OCR Roberty Cloud sin tablas, formularios ni bloques —: el texto, como una cadena;
  • con datos estructurados: un objeto con el texto y las 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" }]
}

Una etapa desactivada no cambia nada: el resultado pasa por ella tal como llegó.

Etapa de LLM​

La etapa de LLM envía el resultado actual al modelo configurado en Modelo, junto con tu Instrucción, por ejemplo "Devuelve un JSON con los campos numero, emision y total.". Los objetos se envían al modelo como JSON.

Cuando la llamada a la plantilla incluye parámetros, también se envían al modelo, después del resultado, para que la instrucción pueda usarlos.

La respuesta del modelo pasa a ser la salida de la etapa. Si es un JSON — aunque venga dentro de un bloque de código Markdown —, la etapa entrega el objeto o la lista ya interpretados; si no, entrega el texto.

información

Las etapas de LLM necesitan la función de IA generativa habilitada en el workspace; sin ella, la opción aparece bloqueada. Contacta con tu gerente de cuenta para que la activen.

Etapa de código​

La etapa de Código ejecuta un script en Node.js (por defecto) o Python, elegido en la barra del editor. El contrato es el mismo en los dos lenguajes:

VariableQué es
inputEl resultado actual del pipeline: el resultado de la extracción o la salida de la etapa anterior.
outputDonde el script escribe el resultado. El valor asignado pasa a ser la salida de la etapa.
paramsSolo en Node.js: los parámetros enviados en la llamada a la plantilla. Sin parámetros, es {}.

Una etapa nueva empieza con output = input, que pasa el resultado sin cambios. Si el código está vacío, la etapa también devuelve la entrada tal cual.

Ejemplo en Node.js, que arma un JSON a partir de las tablas y del 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,
};

En Python, sin 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:]
],
}

En Node.js, el script se ejecuta aislado, con un límite de 5 segundos y solo con los recursos básicos del lenguaje (JSON, Math, Date, Object, Array, String, Number, Boolean): no hay require ni acceso a la red, y lo que se escriba con console.log no aparece en el resultado. Si el script lanza un error, la ejecución termina como Falló.

El editor sugiere los campos de input y de params a partir de la última ejecución del Playground: ejecuta el Playground una vez con un documento de ejemplo antes de escribir el código.

Consejos​

  • Usa el OCR Roberty Cloud con tablas y una etapa de código cuando el documento tiene una estructura fija; usa una etapa de LLM cuando el diseño varía y es más fácil describir el resultado que programarlo.
  • Combina las dos: una etapa de LLM que devuelve un JSON, seguida de una etapa de código que ajusta formatos, como fechas e importes.
  • En el Playground, la pestaña Posprocesamiento muestra la salida de cada etapa, para que compruebes dónde cambió el resultado.