Extrair dados de documentos em lote

Quando a tarefa é sempre a mesma, como ler contratos e extrair partes, valores e prazos, um Workflow entrega mais que um Agente. O caminho é fixo, o resultado é estruturado e cada execução fica registrada.

Este guia monta o fluxo de extração em lote, do upload ao resultado.

Pré-requisitos

Papel de Proprietário, Curador ou Editor no workspace.
Um modelo habilitado, de preferência barato, já que a tarefa é repetitiva.
Alguns arquivos de exemplo que representem a variação real dos documentos.

O desenho do fluxo

Entrada: receba a lista de arquivos

No nó de Entrada, declare uma variável que recebe os arquivos. Ela vira o campo do formulário que quem executa preenche.

Dê a ela um nome legível: quem executa lê esse rótulo na tela.

Extrator de arquivos: converta em texto

Ligue um nó Extrator de arquivos à Entrada. Ele transforma os binários em texto e devolve uma lista, acessível como {{ extrator_arquivos.contents }}.

Sem este nó, os arquivos não chegam ao modelo de forma aproveitável.

Iteração: repita por documento

Adicione um nó de Iteração e aponte a entrada dele para a lista de textos extraídos.

Dentro do laço, o nó Início da iteração fornece item, o texto de um documento, e index.

LLM: extraia os campos

Dentro da Iteração, ligue um nó LLM ao Início da iteração. No prompt, peça os campos e exija o formato.

Extraia os campos abaixo do contrato e responda apenas com JSON válido,
sem texto antes ou depois.

Campos: partes, valor_total, data_inicio, data_fim, prazo_rescisao.
Use null quando o campo não estiver no documento.

Contrato:
{{ inicio_da_iteracao.item }}

A instrução de formato não é opcional. Sem ela, o modelo devolve texto corrido e nada depois consegue tratar a saída de forma confiável.

Saída da iteração: colete os resultados

Em Variáveis de saída do nó de Iteração, declare o nome da lista que sai do laço, por exemplo contratos_extraidos, e aponte a variável de origem para a resposta do nó LLM interno.

Saída: devolva o resultado

Ligue a lista ao nó de Saída. Para um resultado consumível por outro sistema, declare campos separados; para leitura humana, um campo só com o consolidado basta.

Se quem executa precisa de um arquivo, acrescente um nó Gerador de arquivos antes da Saída.

Antes de publicar

Execute a partir do estúdio com dois ou três documentos reais, incluindo um caso atípico. O registro da execução mostra o que cada nó recebeu e devolveu, etapa a etapa.

O ponto de falha mais comum é o nó LLM devolvendo formato inconsistente em documentos fora do padrão. Isso se resolve no prompt, não no nó seguinte.

O custo

Um nó LLM dentro de uma Iteração executa uma vez por item. Cem documentos são cem chamadas.

Antes de liberar para o time, estime o custo de um lote típico em Observabilidade e, se for relevante, defina um teto em Quotas.

Publicar

Publique o Workflow. Ele passa a aparecer na área Agentes do módulo Chat, onde as pessoas executam sem precisar de acesso ao Admin.

Próximos passos

Escolha o nó certo para cada etapa em Catálogo de nós.
Investigue uma execução que saiu errada em Execuções.

Extrair dados de documentos em lote

Nesta página