Вы можете превратить «прикрепить страницу, показывающую проблему» в один запрос. Сервер GroupDocs.Viewer.Mcp рендерит указанные вами страницы из PDF, Word, Excel или PowerPoint‑файла и сохраняет каждую как PNG с предсказуемым именем файла локально на вашем компьютере, чтобы Claude, Cursor или GitHub Copilot могли создавать изображения для отчёта об ошибке, заметки к обзору или слайда:

Отобразите страницы 1, 4 и 9 спецификации и скажите, где находятся файлы.

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

Зачем автоматизировать создание изображений страниц?

Изображение страницы — самое дешёвое доказательство. Инженер поддержки прикрепляет страницу счёта, где указана неверная сумма; рецензент вставляет миниатюру каждой изменённой страницы в заметки обзора; презентатору нужен один диаграмма без переоформления. Делая это вручную, каждый раз нужно открыть файл, найти страницу, сделать скриншот и назвать результат. Количество страниц различается в разных файлах, поэтому работу трудно пакетировать.

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

Каков рабочий процесс?

  1. Поместите файлы туда, где их видит сервер. Смонтируйте папку, содержащую документы, будь то PDF‑файлы или Word‑файлы, чтобы рендеринг изображения страницы DOCX работал одинаково. Сервер читает из пути хранилища и записывает изображения в путь вывода, который можно держать отдельным с помощью GROUPDOCS_MCP_OUTPUT_PATH.
  2. Проверьте количество страниц. Запрос: «Сколько страниц в спецификации?» Агент вызывает get_view_info и читает pageCount. Это важно, потому что render_page не отклоняет номер страницы, выходящий за пределы документа.
  3. Назовите страницы. Запрос: «Отобразите страницы 1, 4 и 9 спецификации и скажите, где находятся файлы.» Агент вызывает render_page три раза, по одному на каждую страницу.
  4. Соберите имена файлов. Файлы — specification_page1.png, specification_page4.png и specification_page9.png в папке вывода. Агент сообщает пути.
  5. Прикрепите их. Если ваш клиент также подключён к системе отслеживания проблем или чат‑серверу MCP, попросите агента прикрепить файлы к тикету или сообщению. Этот шаг использует инструменты другого сервера, а не этого.

Если вам нужны только файлы, скажите об этом, чтобы агент не описывал каждое изображение:

Просто сохраните изображения; их не нужно описывать.

Что решает агент, а что делает движок?

Решение или действие Агент Движок
Какие страницы релевантны Преобразует «страницы с таблицей цен» в номера страниц после рендеринга или инспекции Ничего
Существует ли страница Вызывает get_view_info и сравнивает Возвращает pageCount и размеры страниц
Рендеринг Вызывает render_page один раз на страницу Создаёт PNG
Именование файлов Сообщает сохранённый путь Сохраняет как <source-stem>_page<N>.png
Прикрепление к тикету Использует инструмент другого сервера Ничего

Пример сеанса

Иллюстрация основана на задокументированных именах выходных файлов, а не на захваченном скриншоте.

Вы:   Отобразите страницы 1, 4 и 9 спецификации и скажите, где находятся файлы. Просто сохраните изображения; их не нужно описывать.

Agent: [вызывает render_page для страниц 1, 4 и 9]
       Сохранено:
         <output folder>/specification_page1.png
         <output folder>/specification_page4.png
         <output folder>/specification_page9.png

Как сократить набор?

Рендеринг происходит по одной странице за вызов, и каждое изображение также возвращается агенту в строке. Запрос десяти страниц означает десять вызовов и десять изображений в разговоре. Запрашивайте только те страницы, которые нужны. Разумное правило — выбирать страницы до рендеринга, используя количество страниц и, для длинных документов, оглавление.

Типичные применения

  • Отчёты об ошибках. Страница руководства или счёта, где проявилась проблема.
  • Обзоры документов. По одному изображению на каждую изменённую страницу в заметках обзора.
  • Слайды. Картинка единственной диаграммы, которую вы хотите, без её переоформления.

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

  • Режим оценки. Отрендеренные страницы содержат водяной знак оценки, а процесс сервера открывает не более 15 документов. Если изображения покидают вашу команду, сначала спросите «Лицензирован ли сервер Viewer?», чтобы агент вызвал get_license_status.
  • Одна страница за вызов. Инструмента для многостраничного рендеринга нет. Пакет — это серия вызовов.
  • Только PNG. Формат фиксирован; разрешение не является параметром, который можно задать через инструмент.
  • Неправильный номер страницы всё равно даёт изображение. Файл _page12.png будет страницей 12 только если документ действительно имеет 12 страниц. Сначала проверьте количество страниц.

FAQ

Как конвертировать страницу PDF в изображение с помощью AI‑агента? Подключите сервер GroupDocs.Viewer.Mcp к вашему клиенту и запросите страницу по номеру. Агент вызывает render_page, и PNG сохраняется в папке вывода как <name>_page<N>.png.

Как прикрепить превью документа к тикету с помощью AI‑агента? Сервер Viewer создаёт файл изображения. Прикрепление требует подключённого к тому же клиенту сервера отслеживания проблем MCP, который является отдельным сервером со своими инструментами.

Можно ли генерировать миниатюры документов локально? Да. Движок работает в процессе сервера на вашей машине, а изображения записываются в папку вывода, которую вы настроили.

Подробнее