Khi bạn yêu cầu một AI agent xóa thông tin nhạy cảm trên một trang đã quét và việc xóa văn bản không tìm thấy gì để thay thế, trang đó không sạch, nó không có lớp văn bản để tìm kiếm. Để xóa một bản quét cục bộ, agent sẽ che một vùng bằng tọa độ bằng redact_image_area thay vì khớp từ. Khi kết nối GroupDocs.Redaction.Mcp với Claude Desktop hoặc Cursor, yêu cầu trông như sau:

Che phần dưới cùng một phần ba của scan.png bằng một hộp màu đen.

Phiên bản từng bước với cấu hình và khắc phục sự cố có trong tài liệu: Cách xóa thông tin nhạy cảm trên tài liệu và hình ảnh đã quét bằng AI agent.

Tại sao việc xóa văn bản không tìm thấy gì trên bản quét?

Một bản quét là hình ảnh của tài liệu. Các từ trên đó là các pixel, vì vậy một biểu thức chính quy không có gì để khớp. redact_text không tìm thấy gì để thay thế trên một trang đã quét, và việc không tìm thấy không đồng nghĩa với không có thông tin nhạy cảm. Xem kết quả trống trên tệp chỉ có hình ảnh như “không có lớp văn bản”, sau đó chuyển sang công cụ khác. Điều này cũng áp dụng cho ảnh chụp, con dấu và trang chữ ký đã quét ở mặt sau của một hợp đồng kỹ thuật số.

Công cụ nào che một vùng trên trang?

redact_image_area che một hình chữ nhật trên trang bằng một hộp màu đặc và ẩn vĩnh viễn nội dung hình ảnh bên dưới, chẳng hạn như khuôn mặt, chữ ký và con dấu. Nó nhận các tham số x, y, width và height tính bằng pixel, đo từ góc trên‑trái của trang, và một tùy chọn color (mặc định là Black, hoặc giá trị hex như #FF0000). Công cụ không nhận đối số trang, chỉ nhận tệp và hình chữ nhật, vì vậy hãy mở kết quả và xác nhận hộp đã được đặt ở đâu. Vì các số là pixel, bạn cần biết kích thước hình ảnh hoặc trang trước khi chọn hình chữ nhật.

Làm sao để lấy tọa độ?

Bắt đầu với kích thước trang. get_document_info trả về loại tệp, số trang và chiều rộng, chiều cao của mỗi trang, giúp chuyển “phần dưới cùng một phần ba” thành các số thực.

Kích thước của scan.png là bao nhiêu?

Sau đó cung cấp vùng cho agent:

Che phần dưới cùng một phần ba của scan.png bằng một hộp màu đen.

Đối với một yếu tố cụ thể như chữ ký hoặc khuôn mặt, bạn cần vị trí của nó. Hai cách thực tế có thể thực hiện. Mở trang trong bất kỳ trình xem nào và tự đọc tọa độ. Hoặc để agent render trang bằng một máy chủ trả về hình ảnh trang: công cụ render_page của GroupDocs.Viewer.Mcp render một trang duy nhất dưới dạng PNG và trả về trực tiếp, và máy chủ GroupDocs.Annotation.Mcp có thể trả về bản xem trước trang (công cụ preview hiện tại gặp lỗi với tệp PDF trên Linux và trong Docker; các tài liệu Word và các tài liệu Office khác render được, và trên Windows với dnx mọi định dạng đều render). Một mô hình có khả năng thị giác sau đó có thể ước tính hộp, và bạn xác nhận trước khi thực hiện xóa.

Còn những tài liệu có một nửa là văn bản, một nửa là bản quét thì sao?

Một hợp đồng được tạo số với một trang chữ ký đã quét cần cả hai công cụ, và redact_image_area không thể được chỉ định cho một trang bằng một đối số. Giữ các phần riêng biệt: xóa văn bản trước, và xem các trang đã quét như hình ảnh để thực hiện xóa vùng.

Xóa các địa chỉ email trong contract.docx, sau đó cho tôi biết tệp đã lưu nào nên dùng cho bước tiếp theo.

Sau đó kiểm tra từng trang của kết quả cuối cùng bằng mắt.

Quy trình làm việc với bản quét điển hình như thế nào?

Thứ tự hoạt động là: đọc kích thước trang, quyết định vùng, che nó, rồi xem kết quả. Nếu vùng không rõ ràng, hãy render trang trước và để mô hình có khả năng thị giác đề xuất một hộp. Giữ đề xuất và tọa độ cuối cùng trong bản ghi để bất kỳ ai xem lại hồ sơ vụ việc đều có thể thấy đã che gì và tại sao. Xóa bằng vùng được thiết kế thô sơ: nó chỉ che một hình chữ nhật và không gì khác.

Máy chủ này có đọc văn bản trong hình ảnh (OCR) không?

Không. GroupDocs.Redaction.Mcp chỉ thực hiện xóa; nó không nhận dạng văn bản trong hình ảnh. Điều này giúp hành vi dự đoán được, vì không có ngưỡng độ tin cậy nào âm thầm quyết định rằng một tên mờ không phải là tên. Nếu quy trình của bạn cần trích xuất văn bản từ bản quét, hãy lấy nó ra trước bằng công cụ chuyên dụng, xác định những gì nhạy cảm, rồi xóa bằng vùng. Máy chủ không thể cho bạn biết vị trí của một tên trong hình ảnh.

Phiên làm việc mẫu (rút gọn)

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.

Làm sao kiểm tra việc xóa vùng?

Xem từng trang của kết quả, không chỉ trang bạn đã chỉ định. Một việc xóa vùng thiếu 20 pixel là một lần xóa thất bại, và không có văn bản phản hồi nào sẽ cho bạn biết. Đây là trường hợp duy nhất mà việc xác minh không thể tự động hoá bằng cách chạy lại mẫu: kiểm tra bằng mắt bạn, hoặc một bản xem trước đã render mà agent có thể thấy. Việc xác minh được đề cập trong bài viết riêng, Không tin vào việc xóa nào nếu bạn chưa xác minh.

Giới hạn của chế độ đánh giá là gì?

Không có giấy phép, máy chủ cho phép một tài liệu mỗi quá trình và một lần xóa, giới hạn ở 4 lần thay thế, cộng với các huy hiệu dùng thử. Đối với bản quét, nghĩa là chỉ một hộp: một trang cần ba vùng che sẽ chỉ nhận được một hộp, và vẫn trông như đã được xử lý. Hãy chạy get_license_status trước. Giới hạn này chỉ dành cho việc thử nghiệm công cụ, không phải cho công việc thực tế.

  • PDF trên Linux. Trên Linux, bao gồm cả ảnh Docker, redact_image_area và erase_metadata hiện đang gặp lỗi với tệp PDF (việc xử lý hình ảnh của engine PDF phụ thuộc vào System.Drawing, mà .NET chỉ hỗ trợ trên Windows); cả hai công cụ hoạt động tốt với tài liệu Word, và redact_text hoạt động trên PDF. Hãy thực hiện xóa vùng PDF và xóa siêu dữ liệu trên Windows với dnx.

Câu hỏi thường gặp

AI agent có thể xóa một tài liệu đã quét không? Có, bằng vùng. Nó sẽ che một hình chữ nhật bạn định nghĩa bằng redact_image_area, vì không có văn bản để khớp mẫu.

Claude có thể xóa chữ ký khỏi hình ảnh đã quét không? Claude có thể điều khiển việc xóa một khi vị trí chữ ký đã được biết, từ một trình xem hoặc bản xem trước đã render. Máy chủ sau đó sẽ che hình chữ nhật đó bằng một hộp màu đặc.

Làm sao tự động làm đen một vùng trong bản quét hoặc hình ảnh? Cung cấp tệp và hình chữ nhật cho agent, và nó sẽ gọi redact_image_area. Công cụ không có đối số trang, vì vậy hãy kiểm tra từng trang của kết quả bằng mắt.

Tại sao việc xóa văn bản không thay đổi gì trên bản quét của tôi? Bản quét hoặc hình ảnh chỉ chứa pixel, không phải văn bản, vì vậy không có gì để thay thế. Hãy dùng xóa vùng, và kiểm tra kết quả bằng mắt.

Đi sâu hơn