Bir AI ajanına taranmış bir sayfayı kırpmasını istediğinizde ve metin kırpma hiçbir şey bulamadığında, sayfa temiz değildir, arama yapılacak bir metin katmanı yoktur. Bir taramayı yerel olarak kırpmak için ajan, kelimeleri eşleştirmek yerine redact_image_area ile koordinatlar aracılığıyla bir bölgeyi kapatır. Claude Desktop veya Cursor ile bağlanmış GroupDocs.Redaction.Mcp ile istek şu şekilde görünür:

scan.png dosyasının alt üçte birini siyah bir kutuyla kapat.

Yapılandırma ve sorun giderme adımlarıyla birlikte adım adım sürüm belgelerde bulunabilir: AI ajanı ile taranmış belgeleri ve görüntüleri nasıl kırparım.

Metin kırpma bir taramada neden hiçbir şey bulamıyor?

Bir tarama, bir belgenin resmidir. Üzerindeki kelimeler piksellerdir, bu yüzden bir düzenli ifade eşleşecek bir şey bulamaz. redact_text, taranmış bir sayfada değiştirecek bir şey bulamaz ve hiçbir şey bulamamak, hassas bir şeyin olmadığı anlamına gelmez. Görüntü‑only dosyada boş bir sonuç alındığında bunu “metin katmanı yok” olarak değerlendirin, ardından aracı değiştirin. Aynı durum fotoğraflar, damgalar ve dijital bir sözleşmenin arkasındaki taranmış imza sayfası için de geçerlidir.

Hangi araç bir sayfanın bölgesini kapatır?

redact_image_area, bir sayfanın dikdörtgenini katı renkli bir kutu ile kapatır ve altındaki görüntü içeriğini kalıcı olarak gizler; örneğin yüzler, imzalar ve damgalar. Sayfanın sol‑üst köşesinden ölçülen piksel cinsinden x, y, width ve height değerlerini alır ve isteğe bağlı bir color (varsayılan Siyah, ya da #FF0000 gibi bir hex değeri) alabilir. Araç sayfa argümanı almaz, yalnızca dosya ve dikdörtgeni alır, bu yüzden çıktıyı açıp kutunun nereye düştüğünü doğrulayın. Sayılar piksel olduğu için bir dikdörtgen seçmeden önce görüntünün veya sayfanın boyutunu bilmeniz gerekir.

Koordinatları nasıl alırsınız?

Sayfa boyutuyla başlayın. get_document_info dosya tipini, sayfa sayısını ve sayfa başına genişlik ve yüksekliği döndürür; bu da “alt üçte bir” ifadesini gerçek sayılara dönüştürür.

scan.png dosyasının boyutu ne kadar?

Ardından ajana bölgeyi verin:

scan.png dosyasının alt üçte birini siyah bir kutuyla kapat.

İmza veya yüz gibi belirli bir öğe için konumuna ihtiyacınız vardır. İki pratik yol çalışır. Sayfayı herhangi bir görüntüleyicide açıp koordinatları kendiniz okuyun. Ya da ajanın sayfayı, sayfa görüntüleri döndüren bir sunucu ile render etmesine izin verin: GroupDocs.Viewer.Mcp render_page aracı tek bir sayfayı PNG olarak render eder ve satır içinde döndürür, ve GroupDocs.Annotation.Mcp sunucusu sayfa ön izlemeleri döndürebilir (ön izleme aracı şu anda Linux ve Docker’da PDF dosyaları için başarısız olur; Word ve diğer Office belgeleri render edilir, ve Windows’ta dnx ile her format render edilir). Görüntü‑yeteneği olan bir model daha sonra kutuyu tahmin edebilir ve kırpma çalıştırılmadan önce siz onaylarsınız.

Yarı metin yarı tarama olan belgeler hakkında ne yapılmalı?

Dijital olarak oluşturulmuş bir sözleşmenin taranmış imza sayfası her iki araca da ihtiyaç duyar ve redact_image_area bir argümanla tek bir sayfaya yönlendirilemez. Parçaları ayrı tutun: önce metni kırpın ve taranmış sayfaları kendi alan kırpması alacak görüntüler olarak ele alın.

contract.docx dosyasındaki e‑posta adreslerini kırp, ardından bir sonraki adım için hangi kaydedilmiş dosyayı kullanmam gerektiğini söyle.

Son çıktının her sayfasını gözle kontrol edin.

Tipik bir tarama iş akışı nasıldır?

İşleyen sıralama şudur: sayfa boyutunu okuyun, bölgeyi belirleyin, kapatın, ardından sonucu inceleyin. Bölge açık değilse, önce sayfayı render edin ve görüntü‑yeteneği olan bir modelin bir kutu önermesine izin verin. Teklif ve son koordinatları transkriptte tutun, böylece dosyayı inceleyen herkes neyin ve neden kapatıldığını görebilsin. Bölgeye göre kırpma kasıtlı olarak basittir: bir dikdörtgeni kapatır ve başka bir şey eklemez.

Bu sunucu görüntülerdeki metni okur mu (OCR)?

Hayır. GroupDocs.Redaction.Mcp kırpar; görüntülerdeki metni tanımaz. Bu, davranışın öngörülebilir olmasını sağlar, çünkü bir güven eşiği sessizce bulanık bir ismin isim olmadığını karar vermez. İş akışınız taramalardan metin çıkarmayı gerektiriyorsa, önce bunu bu iş için tasarlanmış bir araçla çıkarın, hassas olanı belirleyin, ardından alanla kırpın. Sunucu bir ismin bir resimde nerede olduğunu size söyleyemez.

Örnek oturum (kısaltılmış)

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.

Bir alan kırpmasını nasıl kontrol edersiniz?

Çıktının her sayfasına bakın, sadece hedeflediğiniz sayfaya değil. 20 piksel eksik bir alan kırpması başarısız bir kırpmadır ve hiçbir yanıt metni size bunu söylemez. Bu, doğrulamanın bir deseni yeniden çalıştırarak otomatikleştirilemediği tek durumdur: kontrol gözlerinizle yapılır, ya da ajanın görebileceği render edilmiş bir ön izleme ile. Doğrulama kendi gönderisinde ele alınmıştır, Doğrulamadığınız hiçbir kırpma güvenmeyin.

Değerlendirme modunun sınırlamaları nelerdir?

Lisans olmadan sunucu, işlem başına bir belge ve bir kırpma izni verir, en fazla 4 değiştirme ile sınırlıdır, ayrıca deneme rozetleri bulunur. Taramalar için bu, bir kutu anlamına gelir: üç bölgeyi kapatması gereken bir sayfa sadece bir kutu alır ve hâlâ işlenmiş gibi görünür. Önce get_license_status komutunu çalıştırın. Bu sınırlama araçları denemek içindir, gerçek iş için değildir.

  • Linux’ta PDF. Linux’ta, Docker imajı dahil, redact_image_area ve erase_metadata şu anda PDF dosyalarında başarısız olur (PDF motorunun görüntü işleme kısmı System.Drawing‘e dayanır, .NET bunu yalnızca Windows’ta destekler); her ikisi de Word belgelerinde çalışır ve redact_text PDF’de çalışır. PDF alan kırpmasını ve meta veri silmeyi Windows’ta dnx ile çalıştırın.

SSS

Bir AI ajanı taranmış bir belgeyi kırpebilir mi? Evet, alanla. redact_image_area ile tanımladığınız bir dikdörtgeni kapatır, çünkü eşleşecek bir metin yoktur.

Claude bir taranmış görüntüden imzayı kaldırabilir mi? İmzanın konumu bir görüntüleyiciden veya render edilmiş sayfa ön izlemelerinden bilindiğinde Claude kırpmayı yönlendirebilir. Sunucu daha sonra o dikdörtgeni katı bir kutuyla kapatır.

Bir tarama veya görüntüdeki bir bölgeyi otomatik olarak nasıl karartırım? Ajana dosyayı ve dikdörtgeni verin, o da redact_image_area çağırır. Araç sayfa argümanı almaz, bu yüzden sonucu gözle her sayfada kontrol edin.

Metin kırpma taramamda neden hiçbir şey değiştirmiyor? Tarama veya görüntü piksellerden oluşur, metinden değil, bu yüzden değiştirilecek bir şey yoktur. Alan kırpmasını kullanın ve sonucu gözle kontrol edin.

Daha fazla bilgi