Ketika Anda meminta agen AI untuk menyensor halaman yang dipindai dan penyensoran teks tidak menemukan apa pun untuk diganti, halaman tersebut tidak bersih, tidak memiliki lapisan teks untuk dicari. Untuk menyensor pemindaian secara lokal, agen menutupi wilayah dengan koordinat menggunakan redact_image_area alih‑alih mencocokkan kata. Dengan GroupDocs.Redaction.Mcp terhubung ke Claude Desktop atau Cursor, permintaan terlihat seperti ini:
Tutup sepertiga bagian bawah scan.png dengan kotak hitam.
Versi langkah‑demi‑langkah dengan konfigurasi dan pemecahan masalah ada dalam dokumentasi: How to redact scanned documents and images with an AI agent.
Mengapa penyensoran teks tidak menemukan apa pun pada pemindaian?
Pemindaian adalah gambar dari sebuah dokumen. Kata‑kata di dalamnya berupa piksel, sehingga ekspresi reguler tidak memiliki apa pun untuk dicocokkan. redact_text tidak menemukan apa pun untuk diganti pada halaman yang dipindai, dan tidak menemukan apa pun tidak sama dengan tidak ada yang sensitif. Anggap hasil kosong pada file yang hanya berupa gambar sebagai “tidak ada lapisan teks”, lalu beralih ke alat lain. Hal yang sama berlaku untuk foto, stempel, dan halaman tanda tangan yang dipindai di belakang kontrak yang sebaliknya digital.
Alat mana yang menutupi wilayah pada halaman?
redact_image_area menutupi sebuah persegi panjang pada halaman dengan kotak berwarna solid dan secara permanen menyembunyikan konten gambar di bawahnya, seperti wajah, tanda tangan, dan stempel. Ia menerima x, y, width, dan height dalam piksel, diukur dari sudut kiri atas halaman, serta opsional color (default Hitam, atau nilai heks seperti #FF0000). Alat ini tidak menerima argumen halaman, hanya file dan persegi panjang, jadi buka hasilnya dan konfirmasi di mana kotak tersebut berada. Karena angka‑angka tersebut dalam piksel, Anda memerlukan ukuran gambar atau halaman sebelum memilih persegi panjang.
Bagaimana cara mendapatkan koordinat?
Mulailah dengan ukuran halaman. get_document_info mengembalikan tipe file, jumlah halaman, serta lebar dan tinggi per halaman, yang mengubah “sepertiga bagian bawah” menjadi angka nyata.
Berapa ukuran scan.png?
Kemudian beri agen wilayah tersebut:
Tutup sepertiga bagian bawah scan.png dengan kotak hitam.
Untuk elemen spesifik seperti tanda tangan atau wajah, Anda memerlukan posisinya. Dua jalur praktis dapat digunakan. Buka halaman di penampil apa pun dan baca koordinatnya sendiri. Atau biarkan agen merender halaman dengan server yang mengembalikan gambar halaman: alat render_page pada GroupDocs.Viewer.Mcp merender satu halaman sebagai PNG dan mengembalikannya secara inline, dan server GroupDocs.Annotation.Mcp dapat mengembalikan pratinjau halaman (alat pratinjau saat ini gagal untuk file PDF di Linux dan dalam Docker; dokumen Word dan Office lainnya dapat dirender, dan di Windows dengan dnx setiap format dapat dirender). Model yang mampu visi kemudian dapat memperkirakan kotak tersebut, dan Anda mengonfirmasinya sebelum penyensoran dijalankan.
Bagaimana dengan dokumen yang setengah teks, setengah pemindaian?
Kontrak yang dibuat secara digital dengan halaman tanda tangan yang dipindai memerlukan kedua alat, dan redact_image_area tidak dapat diarahkan ke satu halaman melalui argumen. Simpan bagian‑bagian tersebut terpisah: saring teks terlebih dahulu, dan perlakukan halaman yang dipindai sebagai gambar yang mendapatkan penyensoran area masing‑masing.
Saring alamat email dalam contract.docx, lalu beri tahu saya file yang disimpan mana yang harus saya gunakan untuk langkah berikutnya.
Kemudian periksa setiap halaman hasil akhir secara visual.
Seperti apa alur kerja pemindaian yang umum?
Urutan yang berhasil adalah: baca ukuran halaman, tentukan wilayah, tutupi, lalu lihat hasilnya. Jika wilayah tidak jelas, render halaman terlebih dahulu dan biarkan model yang mampu visi mengusulkan sebuah kotak. Simpan usulan dan koordinat akhir dalam transkrip sehingga siapa pun yang meninjau berkas kasus dapat melihat apa yang ditutupi dan mengapa. Penyensoran berdasarkan wilayah sengaja dibuat sederhana: ia menutupi sebuah persegi panjang dan tidak lebih.
Apakah server ini membaca teks dalam gambar (OCR)?
Tidak. GroupDocs.Redaction.Mcp menyensor; ia tidak mengenali teks dalam gambar. Itu membuat perilaku dapat diprediksi, karena tidak ada ambang kepercayaan yang diam‑diam memutuskan bahwa nama yang buram bukan nama. Jika alur kerja Anda memerlukan teks dari pemindaian, ekstrak dulu dengan alat yang dibangun untuk itu, tentukan apa yang sensitif, lalu saring berdasarkan area. Server tidak dapat memberi tahu Anda di mana nama berada dalam gambar.
Contoh sesi (disingkat)
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.
Bagaimana cara memeriksa penyensoran area?
Lihat setiap halaman hasil, bukan hanya yang Anda targetkan. Penyensoran area yang kurang 20 piksel adalah penyensoran yang gagal, dan tidak ada teks respons yang akan memberi tahu Anda. Inilah satu kasus di mana verifikasi tidak dapat diotomatisasi dengan menjalankan pola lagi: pemeriksaan adalah mata Anda, atau pratinjau yang dirender yang dapat dilihat agen. Verifikasi dibahas dalam posting terpisah, Trust no redaction you haven’t verified.
Apa batasan mode evaluasi?
Tanpa lisensi server mengizinkan satu dokumen per proses dan satu penyensoran, dibatasi hingga 4 penggantian, plus lencana percobaan. Untuk pemindaian itu berarti satu kotak: halaman yang membutuhkan tiga wilayah tertutup hanya mendapat satu, dan tetap terlihat diproses. Jalankan get_license_status terlebih dahulu. Batas ini untuk mencoba alat, bukan untuk pekerjaan nyata.
- PDF di Linux. Di Linux, termasuk gambar Docker,
redact_image_areadanerase_metadatasaat ini gagal pada file PDF (penanganan gambar mesin PDF bergantung padaSystem.Drawing, yang .NET hanya dukung di Windows); keduanya bekerja pada dokumen Word, danredact_textbekerja pada PDF. Jalankan penyensoran area PDF dan penghapusan metadata di Windows dengandnx.
FAQ
Apakah agen AI dapat menyensor dokumen yang dipindai? Ya, dengan area. Ia menutupi persegi panjang yang Anda definisikan dengan redact_image_area, karena tidak ada teks untuk pencocokan pola.
Apakah Claude dapat menghapus tanda tangan dari gambar yang dipindai? Claude dapat mengendalikan penyensoran setelah posisi tanda tangan diketahui, dari penampil atau pratinjau halaman yang dirender. Server kemudian menutupi persegi panjang itu dengan kotak solid.
Bagaimana cara menutupi wilayah dalam pemindaian atau gambar secara otomatis? Beri agen file dan persegi panjang, dan ia memanggil redact_image_area. Alat ini tidak memiliki argumen halaman, jadi periksa setiap halaman hasil secara visual.
Mengapa penyensoran teks tidak mengubah apa pun pada pemindaian saya? Pemindaian atau gambar berisi piksel, bukan teks, sehingga tidak ada yang dapat diganti. Gunakan penyensoran area, dan periksa hasilnya secara visual.
Selami Lebih Dalam
- Dokumentasi, panduan kanonik: Cara menyensor dokumen dan gambar yang dipindai dengan agen AI
- Pusat dokumentasi: GroupDocs.Redaction MCP Server
- Mulai di sini: 3 cara menyensor data sensitif dengan agen AI dan MCP
- Terkait: Terapkan kebijakan penyensoran pengungkapan dengan alur kerja AI otomatis menggunakan MCP
- Terkait: Jangan percayakan penyensoran yang belum Anda verifikasi
- Model on‑premise dan keamanan: 3 arsitektur untuk pemrosesan dokumen AI, dan yang menjaga file tetap di dalam jaringan Anda
- Pertanyaan: Forum GroupDocs Redaction
- Sumber: GroupDocs.Redaction.Mcp di GitHub