Когда вы просите AI‑агента вырезать отсканированную страницу, а текстовое вырезание ничего не находит для замены, страница не чистая, у неё нет текстового слоя для поиска. Чтобы вырезать скан локально, агент покрывает область координатами с помощью redact_image_area вместо поиска слов. При подключении GroupDocs.Redaction.Mcp к Claude Desktop или Cursor запрос выглядит так:

Закройте нижнюю треть scan.png черным прямоугольником.

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

Почему текстовое вырезание ничего не находит на скане?

Скан — это изображение документа. Слова на нём представляют собой пиксели, поэтому регулярное выражение ничего не может сопоставить. redact_text не находит ничего для замены на отсканированной странице, и отсутствие найденного не означает отсутствие конфиденциальных данных. Рассматривайте пустой результат для файла, содержащего только изображение, как «отсутствие текстового слоя», а затем переключайтесь на другой инструмент. То же самое относится к фотографиям, печатям и отсканированной странице с подписью в конце в основном цифровом контракте.

Какой инструмент покрывает область страницы?

redact_image_area покрывает прямоугольник страницы сплошным цветным блоком и постоянно скрывает находящееся под ним изображение, например лица, подписи и печати. Он принимает параметры x, y, width и height в пикселях, измеряемые от верхнего левого угла страницы, а также необязательный параметр color (по умолчанию Black, или шестнадцатеричное значение, например #FF0000). Инструмент не принимает аргумент страницы, только файл и прямоугольник, поэтому откройте полученный файл и проверьте, где оказался блок. Поскольку значения указаны в пикселях, вам нужен размер изображения или страницы перед выбором прямоугольника.

Как получить координаты?

Начните с размера страницы. get_document_info возвращает тип файла, количество страниц и ширину и высоту каждой страницы, что позволяет превратить «нижнюю треть» в реальные числа.

Какой размер у scan.png?

Затем передайте агенту область:

Закройте нижнюю треть scan.png черным прямоугольником.

Для конкретного элемента, например подписи или лица, вам нужна его позиция. Работают два практических подхода. Откройте страницу в любом просмотрщике и самостоятельно считайте координаты. Либо позвольте агенту отрисовать страницу с помощью сервера, который возвращает изображения страниц: инструмент GroupDocs.Viewer.Mcp render_page отрисовывает одну страницу в формате PNG и возвращает её inline, а сервер GroupDocs.Annotation.Mcp может возвращать превью страниц (его инструмент превью в настоящее время не работает для PDF‑файлов на Linux и в Docker; Word и другие документы Office отрисовываются, а на Windows с dnx отрисовывается любой формат). Затем модель, способная к зрительному восприятию, может оценить прямоугольник, и вы подтверждаете его перед запуском вырезания.

Что делать с документами, которые наполовину текст, наполовину скан?

Цифровой контракт с отсканированной страницей подписи требует использования обоих инструментов, и redact_image_area нельзя направить на одну страницу через аргумент. Держите части раздельно: сначала вырежьте текст, а отсканированные страницы рассматривайте как изображения, к которым применяется отдельное вырезание области.

Вырежьте электронные адреса в contract.docx, затем скажите мне, какой сохранённый файл использовать для следующего шага.

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

Как выглядит типичный рабочий процесс со сканами?

Рабочий порядок выглядит так: считайте размер страницы, определите область, закройте её, затем посмотрите результат. Если область не очевидна, сначала отрисуйте страницу и позвольте модели, способной к зрительному восприятию, предложить прямоугольник. Сохраните предложение и окончательные координаты в транскрипте, чтобы любой, просматривающий дело, мог увидеть, что было покрыто и почему. Вырезание по области намеренно грубое: оно покрывает только прямоугольник и ничего больше.

Читает ли этот сервер текст на изображениях (OCR)?

Нет. GroupDocs.Redaction.Mcp выполняет вырезание; он не распознаёт текст на изображениях. Это делает поведение предсказуемым, поскольку никакой порог уверенности тихо не решает, что размытое имя не является именем. Если ваш процесс требует извлечения текста из сканов, сначала извлеките его с помощью инструмента, предназначенного для этого, определите, что является конфиденциальным, а затем вырежьте область. Сервер не может подсказать, где находится имя на картинке.

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

You:    How big is scan.png?
Agent:  -> get_document_info(file: scan.png)
        The image is 1200 x 1600 pixels.
You:    Cover the bottom third of scan.png with a black box.
Agent:  -> redact_image_area(file: scan.png, x: 0, y: 1067, width: 1200, height: 533, color: Black)
        Saved the output file. Please open it and check that the box covers the area.

Как проверить вырезание области?

Просмотрите каждую страницу результата, а не только ту, на которую вы нацелились. Вырезание области, которое короче на 20 пикселей, считается неудачным, и никакой текст ответа об этом не скажет. Это единственный случай, когда проверка не может быть автоматизирована повторным запуском шаблона: проверка осуществляется вашими глазами или отрисованным превью, которое может увидеть агент. Верификация описана в отдельном посте, Не доверяйте вырезанию, которое вы не проверили.

Каковы ограничения режима оценки?

Без лицензии сервер позволяет один документ на процесс и одно вырезание, ограниченное 4 заменами, плюс пробные значки. Для сканов это означает один блок: страница, которой требуется три покрытых области, получит только одну, и всё равно будет выглядеть обработанной. Сначала выполните get_license_status. Ограничение предназначено для пробного использования инструментов, а не для реальной работы.

  • PDF on Linux. На Linux, включая Docker‑образ, redact_image_area и erase_metadata в настоящее время не работают с PDF‑файлами (обработка изображений в PDF‑движке зависит от System.Drawing, который .NET поддерживает только на Windows); оба работают с документами Word, а redact_text работает с PDF. Выполняйте вырезание области PDF и удаление метаданных на Windows с dnx.

FAQ

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

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

Как автоматически затемнить область на скане или изображении? Передайте агенту файл и прямоугольник, и он вызовет redact_image_area. Инструмент не принимает аргумент страницы, поэтому проверяйте каждую страницу результата визуально.

Почему текстовое вырезание ничего не меняет в моём скане? Скан или изображение состоит из пикселей, а не текста, поэтому нечего заменять. Используйте вырезание области и проверяйте результат визуально.

Подробнее