Разделение документов с помощью 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 вебхука: файл в поле file, ключ — в заголовке. Это может быть скрипт, другая программа или второй рабочий процесс. На выходе вы получаете список документов, готовый к следующему шагу. Три практических совета. Во-первых: вам не нужны разделительные листы; Split Agent определяет границы на основе содержимого. Во-вторых: правило именования задается в поле инструкции именования, например, дата, отправитель, тип документа. И третье: скачайте фрагменты быстро или сразу же сохраните их, так как ссылки истекают через короткое время. Это был Split Agent в n8n: вебхук, вызов, цикл и список. В PaperOffice вы также можете использовать его непосредственно при загрузке. Основное видео о входящем почтовом ящике показывает, как отдельные документы продолжают обрабатываться оттуда. До встречи в Академии PaperOffice AI.