Предположим, у вас есть папка с контрактами, и вам нужна первая страница каждого из них, или страница с подписью, для обзора. AI‑агент с сервером GroupDocs.Merger.Mcp делает это одним запросом, локально на вашем компьютере, из Claude Desktop, Claude Code, Cursor или VS Code с GitHub Copilot:

Извлечь страницу 1 из каждого PDF в моей папке документов и перечислить полученные результаты.

Пошаговая версия с настройками и устранением неполадок находится в документации: Как извлечь страницы из множества документов одновременно.

Что делает агент с папкой файлов?

Для каждого файла агент вызывает инструмент split один раз. Каждый вызов создает одностраничный документ. Папка из 40 счетов‑фактур, соответственно, дает 40 титульных страниц. У инструмента нет режима работы с папкой; агент обеспечивает цикл, а движок выполняет извлечение страниц для каждого файла. Файлы определяются по имени внутри папки, настроенной в GROUPDOCS_MCP_STORAGE_PATH, поэтому агент передаёт invoice-014.pdf, а не путь с вашего компьютера.

Как не помещать извлечённые страницы в папку оригиналов?

Сорок извлечённых страниц рядом со сорока оригиналами образуют папку, в которой невозможно ориентироваться. Установите GROUPDOCS_MCP_OUTPUT_PATH в отдельный каталог, и результаты будут сохраняться отдельно от исходных файлов. Без этого вывод попадает в папку хранилища. Это однократная настройка, и каждый последующий массовый запрос будет оставаться упорядоченным.

Как извлечь последнюю страницу или страницу, позиция которой меняется?

«Последняя страница» имеет разный номер в каждом файле. Сначала заставьте агента вызвать get_document_info для каждого документа. Он возвращает pageCount, поэтому агент может вычислить номер страницы для каждого файла:

Для каждого PDF в папке проверьте количество страниц, затем извлеките последнюю страницу каждого из них.

Агент, который угадывает, будет ошибаться в файлах, где предположение неверно. Ошибка относится к отдельному файлу и не является фатальной.

Какие варианты встречаются чаще всего?

Извлечь последнюю страницу каждого документа. Сначала проверьте количество страниц.

Вынуть страницу 2 из каждого контракта, а затем объединить их все в один файл для обзора.

Для каждого файла извлечь страницу с подписью и поместить результаты в папку вывода.

Второй запрос переходит к merge партиями по четыре документа, что даёт один объединённый документ, построенный из одной страницы каждого источника. Более четырёх источников требует дополнительных раундов. Запрос о странице с подписью работает, когда вы указываете агенту, какая страница содержит подпись; инструмент извлекает указанные вами номера страниц и не ищет содержимое.

Когда один запрос на папку — оптимальный размер?

Используйте его, когда одно и то же правило применимо к каждому файлу: первая страница, последняя страница, известная страница с подписью. Запрос формулирует правило один раз, и агент применяет его к каждому файлу. Такая схема подходит для архивных и юридических проверок: титульный лист из каждого файла для индекса или страница с подписями из каждого контракта для проверки. Если правило различается для файлов, разбейте папку на группы и выполните один запрос на группу, чтобы каждый запрос всё равно содержал одно правило. Сохраняйте инструкцию «перечислите, что вы получили» в каждом массовом запросе; список будет вашей записью о том, какие файлы были обработаны.

Пример сеанса (сокращённый)

Иллюстрация, основанная на задокументированном поведении инструмента, а не на реальном скриншоте.

You:   Extract page 1 from every PDF in my documents folder and
       list what you produced.

Agent: Found 3 PDFs in the folder.
       [calls split on each file with pages = "1"]
       Extracted page 1 from all 3 files: 3 single-page documents
       in your output folder. No failures.

Что может пойти не так при обработке большого количества файлов?

  • Сбои происходят по отдельным файлам. Повреждённый или защищённый паролем документ не проходит свой вызов. Запрашивайте сбои в виде списка, чтобы при обработке 40 файлов не скрыть две ошибки. Инструмент split принимает аргумент password для защищённых документов.
  • Короткий документ. Запрос страницы, которой нет, приводит к ошибке для этого файла; остальные файлы остаются без изменений.
  • Счётчик использования накапливается. При лицензировании с учётом объёма каждый вызов учитывается как обработка.

Честные ограничения

  • В режиме оценки объединённый вывод обрезается до 3 страниц. Результат сокращается до первых 3 страниц, на каждой странице отображается значок пробной версии. Извлечение отдельных страниц не затронуто, но как только вы объединяете результаты, ограничение применяется незаметно. Объединённый файл обзора, построенный из сорока первых страниц, будет возвращён как три страницы. Проверьте get_license_status перед запуском.
  • Поиск по содержимому отсутствует. Агент выбирает страницы по номеру. Поиск «страницы с подписью» — это ваша инструкция, а не функция инструмента.
  • В инструменте нет режима работы с папкой. Один вызов split обрабатывает один файл, поэтому большая папка подразумевает множество вызовов.

FAQ

Как извлечь первую страницу из всех PDF в папке? Укажите серверу папку, затем задайте запрос: «Извлечь страницу 1 из каждого PDF в моей папке документов и перечислить полученные результаты». Агент вызывает split для каждого файла.

Может ли AI пакетно разделять документы и собирать страницы в один файл? Да. После извлечения попросите агента объединить одностраничные файлы партиями по четыре. В режиме оценки полученный объединённый файл будет обрезан до 3 страниц.

Покидают ли файлы мой компьютер? Нет. Сервер читает и записывает папки, которые вы настроили, через локальный транспорт stdio, без входящих портов.

Углубиться