Разделяне на документи с помощта на Split Agent в n8n

Здравейте и добре дошли в Академията на PaperOffice AI. Тази епизод е посветен на Split Agent в n8n: входящ партиден скенер, от който излизат индивидуални документи.

Резултатът първо: Входящ партиден скенер, изходящи документи

Нека първо разгледаме резултата. Нашият партиден скенер от пощенското отделение има седем страници, разделени с разделителна страница. Split Agent разпознава къде свършва един документ и започва следващият. Връщат се пет документа, всеки със свой тип, описателно име и страници. Ето как изглежда това в n8n. За тест стартираме работния процес в редактора и изпращаме партидния скенер към уебхука. Сега работният процес се изпълнява възел по възел. Задачата за разделяне отива към PaperOffice, а цикълът продължава да проверява, докато не приключи. След малко над четиридесет секунди всичко е завършено. Възелът „Парчета“ (Pieces) съхранява резултата: пет записа, по един за всеки документ. Това са петте документа: поръчка за покупка, товарителница, фактура, служебна бележка и доклад от инспекция. Служебната бележка има две страници и те остават заедно. Split Agent разпознава разделителната страница на трета страница и я премахва. Всеки документ получава описателно име въз основа на нашето правило. Всяко „парче“ е отделен PDF файл. Ето служебната бележка: двете страници в един файл, наименувани според нашето правило. Резултатът включва връзка за изтегляне, но тя е валидна само за кратко време. Ето втори партиден скенер, по-труден: шест страници на три езика. Английска поръчка за покупка, испанска товарителница и испанска фактура, кредитна бележка, фактура за транспорт с петно от кафе и изкривена снимка на телефон на фактура. Split Agent разделя всички шест и ги наименува последователно на английски. И ето как го построяваме, в четири етапа: вход, задача за разделяне, изчакване и парчета.

Етап 1 от 4: Вход

Етап първи е входът: уебхук с автентикация на заглавката, който приема файла чрез POST. Ако файлът липсва, работният процес веднага отговаря с ясно съобщение за грешка. А какво се случва без файл? Изпращам заявка без прикачен файл. Работният процес минава краткия път през възела „Липсващ файл“ и отговаря веднага със статус 400 и ясно съобщение. Не се създава задача за разделяне, така че няма и разходи.

Етап 2 от 4: Задача за разделяне

На втория етап пакетът се изпраща към Split Agent чрез единичен HTTP извикване към API-то на PaperOffice. То включва разделения шаблон, модела Ultra и правило за наименуване на частите: тип документ, дата, изпращач. В полето за модел Вие избирате обхвата. Basic открива границите и наименува частите. Premium също така прочита типа на документа, датата и изпращача. Ultra допълнително предоставя обосновката за всяко разделяне и осигурява одитен след. Таксуването е на страница. Цената се определя от две неща: обхватът и лентата за обработка. Избрахте мигновен старт, което означава незабавно начало. Без гаранция за старт, без SLA, цената е по-ниска. Текущите цени можете да намерите на нашия уебсайт в раздела Цени.

Етап 3 от 4: Изчакване

Заданието се изпълнява във фонов режим. На всеки шест секунди цикълът проверява неговия статус. Когато приключи, изпълнението продължава. Ако срещне грешка, изпълнението завършва с съобщение.

Етап 4 от 4: Части

На етап четвърти отговорът става списък с по една позиция за всеки документ. Ако някога разделителна страница се върне като отделен обект, този възел я филтрира. Накрая уебхукът връща точно този списък. А какво се случва със списъка след това? В основното видео за входящата поща тук точно цикълът поема контрола: всеки документ се обработва индивидуално чрез IDP Agent, се чете и се архивира в Workspace. По този начин разделянето става начало на цял работен процес.

Създайте го сами: Удостоверения и извикване отвън

За да го изградите сами, са ви необходими две удостоверявания, и двете като заглавка за автентикация в n8n. Вие избирате ключа за уебхука самостоятелно, с име на персонализирана заглавка. За PaperOffice използвате API ключ от вашия акаунт, в раздела API и разработчици. Той се поставя в заглавката Authorization. Отвън вие извиквате работния процес чрез POST към URL адреса на уебхука: файла във файловото поле, ключа в заглавката. Това може да бъде скрипт, друга програма или втори работен процес. Връща се списък с документи, готови за следващата стъпка. Три съвета от практиката. Първо: не ви трябват разделителни страници; Split Agent открива границите от съдържанието. Второ: вие задавате правилото за наименуване в полето за инструкции за наименуване, например дата, изпращач, тип документ. И трето: изтегляйте парчетата своевременно или ги архивирайте веднага, тъй като връзките изтичат след кратко време. Това беше Split Agent в n8n: уебхук, извикване, цикъл и списък. В PaperOffice можете също да го използвате директно при качване. Основното видео за входящата поща показва как отделните документи продължават оттам. До следващия път в Академията PaperOffice AI.