“Change the hotel ceiling in this travel policy PDF” — это запрос, который люди делают AI‑агентам каждый день, а PDF — создан так, чтобы его не меняли: это описание страницы, а не документа. Полезный ответ — конверсия. При локальном запуске сервера GroupDocs.Editor MCP, Claude, Cursor или Copilot превращают PDF в редактируемый HTML, сохраняют его как Word‑документ и затем вносят изменение в копию Word, сохраняя текст, абзацы и нумерованные разделы нетронутыми и ничего не загружая:

Преобразовать travel-policy.pdf в редактируемый документ Word, а затем изменить потолок отеля с 160 EUR до 175 EUR.

Пошаговая версия находится в документации: Как превратить PDF в редактируемый документ Word с помощью AI‑агента.

Что должно означать «редактировать PDF» для агента

Существует три способа, которыми агент может действовать по запросу редактировать PDF, и только один из них честен.

  • Он может притворяться: прочитать текст, написать новый документ из своей копии и назвать его «отредактированным PDF». Макет, шрифты и всё, что модель не прочитала внимательно, исчезают, и в ответе об этом не говорится.

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

  • Или он может конвертировать: превратить PDF в формат, предназначенный для редактирования, внести изменение там и вернуть документ, который можно дальше редактировать, плюс PDF, если он нужен. Именно это делает сервер, и он явно указывает на это в своих ответах.

Вызовы

Зафиксировано из GroupDocs.Editor.Mcp 26.10.0 против синтетической трёхстраничной политики путешествий:

-> get_document_info {"file":{"filePath":"travel-policy.pdf"}}
<- { "family": "FixedLayout", "pageCount": 3, "canEdit": true,
     "canSaveTo": [ "docx", "doc", "rtf", "odt", "pdf", "md", ... ] }

-> extract_html {"file":{"filePath":"travel-policy.pdf"},"pages":"1-2"}
<- Extracted 'travel-policy.pdf' as editable HTML
   Saved to: …/travel-policy_pages1-2.html
   Preview (plain text): Travel Policy - Northwind Traders Version 4,
   effective 1 March 2026 Scope This policy applies to every employee ...

-> save_from_html {"htmlFile":{"filePath":"travel-policy_pages1-2.html"},
                   "format":"docx","outputName":"travel-policy.docx"}
<- Saved 'travel-policy_pages1-2.html' as DOCX
   Saved to: …/travel-policy.docx

-> replace_text {"file":{"filePath":"travel-policy.docx"},
                 "find":"160 EUR","replace":"175 EUR"}
<- Replaced 1 occurrence(s) of '160 EUR' in 'travel-policy.docx'
   Saved to: …/travel-policy_edited.docx

Четыре вызова: проверка, извлечение, сохранение как Word, редактирование. Последний шаг — тот же replace_text, который агент использует для любого Word‑файла, и именно в этом смысл предварительной конвертации. Как только содержимое становится документом, к нему применим любой инструмент редактирования.

Эта запись выполнена в режиме оценки, поэтому извлекались страницы 1–2, а Word‑копия содержит только эти две из трёх страниц. При полном лицензировании опустите параметр pages, и Word‑копия будет содержать всю политику.

travel-policy.pdf (3 pages, FixedLayout)
   |-- extract_html {"pages":"1-2"} ---> travel-policy_pages1-2.html
   |-- save_from_html {"format":"docx"} ---> travel-policy.docx
   '-- replace_text {"find":"160 EUR","replace":"175 EUR"}
          ---> travel-policy_edited.docx   (editable Word, change made)
   need a PDF again?  save_from_html / replace_text with "format":"pdf"

Выбор целевого формата

Word — естественный выбор, потому что он перераспределяет текст: более длинное предложение опускает следующее, а не накладывается на него. get_document_info перечисляет все форматы, в которые можно сохранить PDF, включая DOCX, DOC, RTF, ODT, Markdown, EPUB и снова PDF. Markdown — хороший вариант, когда «редактирование» на самом деле означает «положить это в репозиторий документации»; PDF — выбор, когда изменение должно быть возвращено в том же формате, а replace_text с "format":"pdf" выполняет правку и конверсию в одном вызове, как только содержимое находится в Word.

Параметр pages задаёт диапазон, поэтому 40‑страничный отчёт не нужно полностью пропускать через агента, чтобы исправить дату на странице 3. skipImages исключает изображения, когда важен только текст, а pagination: true сохраняет границы страниц в HTML, если важен макет по страницам.

Точность: чего ожидать

PDF фиксирует положение каждого глифа, а не то, что является заголовком или абзацем. Конверсия восстанавливает структуру, и для «родившихся» цифровых документов, таких как политики, отчёты и контракты, она делает это хорошо. В нашей политике путешествий заголовок и строка версии вернулись как абзацы, а нумерованные разделы («1. Scope», «2. Booking», «3. Allowances») — как нумерованный список, полностью редактируемый текст. Что восстанавливается, — структура, а не ваш фирменный стиль: раздел, выделенный в PDF жирным шрифтом 14 пт, вернётся как элемент списка или абзац, а не как ваш шаблон «Heading 2», поэтому документ, предназначенный для стилизованного шаблона, может потребовать повторного применения заголовков. Сложные макеты с несколькими колонками, текстовыми блоками поверх изображений или тяжёлым дизайном конвертируются менее чисто, а отсканированный PDF не содержит текста для конвертации вообще. Просмотрите Word‑копию перед тем, как отправлять её куда‑либо; предварительный просмотр HTML в ответе extract — быстрый способ проверить.

Когда не стоит конвертировать

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

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

  • Это конверсия, а не редактирование PDF «на месте». Результатом является новый документ Word (или другой), PDF не изменяется.
  • Отсканированные PDF без текстового слоя нельзя редактировать таким способом; шаг OCR не предусмотрен.
  • В режиме оценки редактируется PDF по две страницы за один вызов. Запрос extract_html с "pages":"1-3" вернёт страницы 1 и 2 без ошибки, страницу 3 можно извлечь отдельно, а replace_text откажется работать с PDF более двух страниц. Примечание об оценке в каждом ответе гласит «только первые 2 страницы PDF», что более свободно, чем реальное поведение. Каждый вывод также начинается со строки‑баннера оценки.
  • Страницы с тяжёлым макетом теряют часть дизайна при переходе в формат с перераспределением текста.

FAQ

Может ли AI‑агент напрямую редактировать PDF?
Нет, честно говоря. Этот сервер конвертирует PDF в редактируемый документ, вносит изменение там и при необходимости сохраняет PDF снова.

Загружается ли PDF куда‑либо?
Нет. Сервер работает локально; конверсия и редактирование происходят на вашем компьютере.

Можно ли получить PDF после редактирования?
Да. Сохраните или отредактируйте с "format": "pdf", и результатом будет новый PDF рядом с копией Word.

Углубиться