Коли ви просите AI‑агента редагувати (redact) скановану сторінку, а редагування тексту нічого не знаходить для заміни, сторінка не чиста, у ній немає текстового шару для пошуку. Щоб редагувати скан локально, агент покриває область координатами за допомогою 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 і повертає її вбудовано, а сервер 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 на Linux. На Linux, включаючи Docker‑образ, redact_image_area та erase_metadata наразі не працюють з PDF‑файлами (обробка зображень у PDF‑движку залежить від System.Drawing, який .NET підтримує лише на Windows); обидва працюють з документами Word, а redact_text працює з PDF. Запустіть редагування області PDF та стирання метаданих на Windows з dnx.

Питання та відповіді

Чи може AI‑агент редагувати сканований документ? Так, за допомогою області. Він покриває прямокутник, який ви визначаєте за допомогою redact_image_area, оскільки немає тексту для пошуку за шаблоном.

Чи може Claude видалити підпис зі сканованого зображення? Claude може керувати редагуванням, коли позиція підпису відома, з переглядача або відрендереного попереднього перегляду сторінки. Сервер тоді покриває цей прямокутник суцільним блоком.

Як автоматично затемнити область у скані або зображенні? Передайте агенту файл і прямокутник, і він викликає redact_image_area. Інструмент не має аргументу сторінки, тому перевірте кожну сторінку результату візуально.

Чому редагування тексту нічого не змінює у моєму скані? Скан або зображення містить пікселі, а не текст, тому немає чого замінювати. Використовуйте редагування областю і перевірте результат візуально.

Детальніше