Повторять цепочку каждый день: вручную → CLI → MCP/API
Цель
Взять цепочку, которую вы проверили вручную в браузере, и сделать так, чтобы она запускалась снова с меньшим числом щелчков — шаг за шагом, не изображая её более автоматической, чем она есть.
Сценарий. Каждый понедельник секретариат сканирует накладные за неделю в папку. Три недели подряд вы в браузере делали «Объединить, Убрать первую страницу, OCR, Сжать». Работает, занимает 15 минут, и вам это надоело.
Исходное состояние
- Цепочка, которая уже работает вручную (см. составьте свой рецепт), и тестовый файл на две-три страницы, для которого вы знаете правильный ответ.
- Решение о том, куда файлам можно уходить (см. Какой канал когда).
Лестница
Веб-приложение (вручную) → Плагины CLI (локальный скрипт) → MCP (запускает ИИ-ассистент) → REST API (запускает ваша программа)
проверить цепочку повторять на своём компьютере диалог, облако встроить, облако
Не перепрыгивайте через ступени. Каждая использует то, чему научила нижняя: порядок шагов и значения параметров.
Ступень 1: вручную, записано
- Запишите цепочку со значениями параметров (по строке на шаг). Рецепты в этой главе написаны именно так.
- Засеките время и отметьте, какие шаги требуют вашего взгляда (например, проверка языка скана). Эти шаги автоматизировать труднее всего.
Ступень 2: плагины CLI (локально, с возможностью скриптов)
Сначала прочитайте главу о CLI. Факты, которые она подтверждает:
- Каждый плагин выполняет одну операцию, требует среду выполнения .NET 10, файл лицензии
documentize.licрядом с dll (без него — режим оценки), а в Linux — дополнительные пакеты (libgdiplus, fontconfig, шрифты). - Плагины не принимают пути к файлам в виде флагов. Они читают входную папку и пишут в выходную:
$PLUGIN_INPUT_DIR/<task-id>/и$PLUGIN_OUTPUT_DIR/<task-id>/. Всегда передавайте собственный--task-id. - Команды, которые документирует глава, с их флагами:
dotnet Documentize.Merge.dll --task-id j1(файлы объединяются в порядке имён)dotnet Documentize.RemovePages.dll --task-id j4 --remove-range 1,3dotnet Documentize.OcrSearchable.dll --task-id j5 --language eng(нужен локальный Tesseract)dotnet Documentize.Compress.dll --task-id j2 --compress-type 1dotnet Documentize.Rotate.dll --task-id j3 --angle 90
- Цепочки без конвейера нет: выходная папка одного шага копируется во входную папку следующего. Это делает функция
step()из главы.
Ваша понедельничная цепочка, собранная из этих деталей (моя компоновка примера из главы; проверьте имена выходных файлов на своём компьютере):
set -e
export PLUGIN_INPUT_DIR=$HOME/dmz/in PLUGIN_OUTPUT_DIR=$HOME/dmz/out
step() { prev=$1; next=$2; plugin=$3; shift 3
mkdir -p "$PLUGIN_INPUT_DIR/$next"
cp "$PLUGIN_OUTPUT_DIR/$prev"/*.pdf "$PLUGIN_INPUT_DIR/$next/"
dotnet "Documentize.$plugin.dll" --task-id "$next" "$@"; }
dotnet Documentize.Merge.dll --task-id w1 # сканы уже лежат в $PLUGIN_INPUT_DIR/w1
step w1 w2 RemovePages --remove-range 1
step w2 w3 OcrSearchable --language eng
step w3 w4 Compress --compress-type 1
Порядок соответствует рецептам: сначала страницы, затем текст, сжатие в конце. Чтобы запускать это по расписанию, вызывайте скрипт из планировщика вашей системы. Средства для этого — часть вашей операционной системы, а не Documentize; встроенного планировщика книга не проверяла.
Честные оговорки: плагины работают на вашем компьютере, поэтому файлы с него не уходят; но есть файл лицензии и, по словам главы, проверки при первом запуске и подключение к интернету для активации (проверьте для каждого плагина). На страницах каталога стиль команд может отличаться от readme; приоритет у readme из архива zip. Плагинам, которые обращаются к ИИ, нужно соединение с сервисом ИИ (об этом сказано у плагина Resume).
Ступень 3: MCP (цепочку запускает ассистент)
Прочитайте MCP. Точка доступа https://api.documentize.app/mcp, необязательный ключ dmk_ в заголовке Bearer. Среди названных там инструментов — MergeDocuments, RemovePages, MakeSearchable, CompressDocument, ExtractFormData, AddToc, GenerateAbstract и другие, а также ProcessBatch, WaitForTasks и GetTaskStatus.
- Вы говорите словами: «Объедини эти три файла по ссылкам, убери страницу 1, сделай поисковым, сожми». Ассистент вызывает инструменты, дожидается каждой задачи и передаёт ссылку на результат следующей.
- Для 20 и более файлов глава советует использовать ProcessBatch (одна операция, до 200 файлов за вызов), затем WaitForTasks.
- Не угадывайте параметры инструментов; попросите ассистента их перечислить. Источник истины — сервер.
- Не у каждого приложения есть инструмент: например, у Collage и Ask PDF, как отмечено, инструмента MCP нет.
- Оговорки: файлы уходят в облако; у анонимных запусков крошечная дневная квота (в документации — 2 операции; проверьте), у бесплатных учётных записей — 5 (проверьте). Одна цепочка из четырёх шагов — это четыре операции.
Ступень 4: REST API (цепочку запускает ваша программа)
Прочитайте REST API. Схема такова: отправить (POST multipart), опрашивать process_status/{id} (203 — ещё работает, 200 — готово со ссылками, 204 — ожидает, 500 — сбой), скачать, при желании удалить.
- Используйте его, чтобы встроить цепочку в приложение.
- Главная оговорка главы: отдельного публичного справочника нет, детали точек доступа — это «то, как сервис работает сегодня», имена полей JSON не зафиксированы, и работают ли ключи
dmk_на всех маршрутах, не задокументировано. Сверяйтесь с живым ответом и, если создаёте продукт, рассмотрите самостоятельное размещение. - Долгие задания на бесплатном тарифе могут останавливаться с продолжением обработки; обработайте это (маршруты перечислены в главе).
Какую ступень выбрать?
- Один человек, одна и та же цепочка еженедельно, файлы могут оставаться локально: CLI.
- Хотите говорить словами, небольшие партии: MCP.
- Запускает другая система: API или самостоятельное размещение.
- Конфиденциальные данные: CLI или самостоятельное размещение, но не MCP и не облачный API.
- Всё, что требует суждения (проверка языка скана, резюме от ИИ): оставьте шаг с участием человека.
Проверьте, что получилось
Запустите автоматизированную цепочку на тестовом файле и сравните с ручным результатом: число страниц, выделяемый текст, размер. Повторяйте это после каждого обновления плагина.
Что может пойти не так
- Плагин не находит мой файл. Он читает входную папку задачи, а не путь из флага.
- «Usage error» (код выхода 2). Неверный флаг; код выхода 1 означает, что задача запустилась и завершилась ошибкой (подробности в stderr).
- Следующий шаг работает не с тем файлом. Ваша команда копирования подхватила старый результат; используйте новый task-id для каждого запуска.
- Отказы по квоте через MCP (
quota_exceeded): на сегодня лимит исчерпан. - Цепочка отличается от браузерной. Сверьтесь с практическим руководством для этого приложения (библиотека); если руководство и книга расходятся, доверяйте руководству.
Почему именно такой порядок
Сначала вручную — это подтверждает цепочку и значения её параметров. CLI повторяет её локально с теми же значениями. MCP и API расширяют охват, но переносят ваши файлы в облако и приносят квоты, поэтому их выбирают сознательно, а не по умолчанию.