Divisão de documentos com o Split Agent em n8n

Olá e bem-vindo à Academia PaperOffice AI. Este episódio trata do Split Agent em n8n: um lote de digitalização é enviado, e documentos individuais são retornados.

Resultado primeiro: Lote de digitalização enviado, documentos retornados

Vamos analisar o resultado primeiro. Nossa digitalização em lote da central de correspondências possui sete páginas, com uma folha separadora no meio. O Split Agent reconhece onde um documento termina e o próximo começa. Cinco documentos são retornados, cada um com seu tipo, um nome descritivo e suas páginas. Veja como isso se apresenta no n8n. Para testar, eu inicio o fluxo de trabalho no editor e envio a digitalização em lote para o webhook. Agora o fluxo de trabalho executa nó por nó. O trabalho de divisão é enviado para o PaperOffice, e o loop continua verificando até que esteja concluído. Após pouco menos de quarenta segundos, tudo está finalizado. O nó Pieces mantém o resultado: cinco entradas, uma por documento. Estes são os cinco documentos: ordem de compra, nota de entrega, fatura, boletim de serviço e relatório de inspeção. O boletim de serviço possui duas páginas, que permanecem juntas. O Split Agent detectou a folha separadora na página três e a removeu. E cada documento recebe um nome descritivo com base em nossa regra. Cada peça é um PDF independente. Aqui está o boletim de serviço: ambas as páginas em um único arquivo, nomeado conforme nossa regra. O resultado inclui o link de download, mas ele é válido apenas por pouco tempo. Aqui está um segundo lote, mais difícil: seis páginas em três idiomas. Uma ordem de compra em inglês, uma nota de entrega em espanhol e uma fatura em espanhol, uma nota de crédito, uma fatura de frete com uma mancha de café e uma foto torta do telefone de uma fatura. O Split Agent separa todos os seis e os nomeia consistentemente em inglês. E é assim que o construímos, em quatro etapas: entrada, trabalho de divisão, espera e peças.

Etapa 1 de 4: Entrada

A etapa um é a entrada: um webhook com autenticação de cabeçalho que aceita o arquivo via POST. Se o arquivo estiver ausente, o fluxo de trabalho responde imediatamente com um erro claro. E o que acontece sem um arquivo? Eu envio uma solicitação sem anexo. O fluxo de trabalho segue o caminho curto pelo nó Arquivo ausente e responde imediatamente com status 400 e uma mensagem clara. Nenhum trabalho de divisão é criado, portanto, não há custos.

Etapa 2 de 4: Trabalho de divisão

A etapa dois envia o lote para o Split Agent, com uma única chamada HTTP à API PaperOffice. Inclui o modelo de divisão, o modelo Ultra e uma regra para nomear as partes: tipo de documento, data, remetente. No campo do modelo, escolhe-se o escopo. O Basic detecta os limites e nomeia as partes. O Premium também lê o tipo de documento, a data e o remetente. O Ultra fornece adicionalmente o raciocínio para cada corte e oferece um rastreamento de auditoria. A cobrança é por página. Duas coisas determinam o preço: o escopo e a faixa de processamento. Escolheu-se instantâneo, significando um início imediato. Sem garantia de início, sem SLA, o custo é menor. O senhor pode encontrar os preços atuais em nosso site na seção Preços.

Etapa 3 de 4: Aguardando

O trabalho é executado em segundo plano. A cada seis segundos, o loop verifica seu status. Quando concluído, a execução continua. Se falhar, a execução termina com uma mensagem.

Etapa 4 de 4: Partes

Na etapa quatro, a resposta torna-se uma lista, com uma entrada por documento. Se uma folha separadora retornar como um item isolado, este nó a filtra. Por fim, o webhook responde exatamente com esta lista. E o que acontece com a lista em seguida? No vídeo principal sobre a caixa de entrada, é exatamente aqui que o loop assume o controle: cada documento vai para o IDP Agent individualmente, é lido e arquivado em um Workspace. Dessa forma, a divisão torna-se o início de todo um fluxo de trabalho.

Construa você mesmo: Credenciais e chamada de fora

Para construir isso você mesmo, são necessárias duas credenciais, ambas como autenticação de cabeçalho em n8n. Você escolhe a chave para o webhook com um nome de cabeçalho personalizado. Para PaperOffice, utiliza-se uma chave de API da sua conta, em API e desenvolvedores. Ela vai para o cabeçalho Authorization. De fora, você chama o workflow com um POST para a URL do webhook: o arquivo no campo file, a chave no cabeçalho. Isso pode ser um script, outro programa ou um segundo workflow. O que retorna é a lista de documentos, pronta para a próxima etapa. Três dicas da prática. Primeiro: não são necessárias folhas separadoras; o Split Agent detecta os limites a partir do conteúdo. Segundo: você define a regra de nomenclatura no campo de instrução de nomenclatura, por exemplo, data, remetente, tipo de documento. E terceiro: baixe as partes prontamente ou arquivadas imediatamente, pois os links expiram após pouco tempo. Esse foi o Split Agent em n8n: um webhook, uma chamada, um loop e uma lista. Em PaperOffice, você também pode usá-lo diretamente ao fazer o upload. O vídeo principal da caixa de entrada mostra como os documentos individuais continuam a partir daí. Até a próxima na Academia PaperOffice AI.