Tek bir komutla bir klasördeki belgelerin üzerine filigran ekleyebilirsiniz: bir AI ajanı dosyaları listeler, her dosya için filigran aracını bir kez çağırır ve ürettiği şeyleri raporlar, tümü yerel olarak ve hiçbir yükleme yapılmadan. Claude Desktop, Claude Code, Cursor veya Windsurf’ta istek şu şekilde okunur:

Belgeler klasörümdeki her PDF’ye çapraz bir DRAFT filigranı ekle, ardından ürettiğin dosyaları listele.

Yapılandırma ve sorun giderme adımlarıyla birlikte adım adım sürüm dokümantasyonda bulunur: AI ajan ile bir klasördeki belgeleri toplu olarak filigranlamak.

Neden bir kez yerine yaşam döngüsü aşamasına göre damga ekleyelim?

Bir teklif paketi nadiren tek seferde işaretlenir. Önce DRAFT olarak başlar, bir meslektaşa gönderildiğinde FOR REVIEW olur ve onaylandığında işaretini kaybeder. Bunu otuz dosya üzerinde elle yapmak, bir son tarih altında atlanan bir iş türüdür. GroupDocs.Watermark.Mcp ile her aşama tek bir cümledir ve ajan, bir betik olarak yazmanız gereken döngüyü sağlar. Motor formatı yönetir, böylece aynı komut PDF, Word, Excel, PowerPoint ve görüntü dosyalarını tek bir klasörde kapsar.

Aşama 1: Tüm dosyalara taslak filigranı nasıl eklersiniz?

GROUPDOCS_MCP_STORAGE_PATH değişkenini klasöre yönlendirin. Dosyalar isimle çözümlenir, bu yüzden ajan proposal-01.pdf gönderir, makinenizden bir yol göndermez. Sonra:

Belgeler klasörümdeki her PDF’ye çapraz bir DRAFT filigranı ekle, ardından ürettiğin dosyaları listele.

Ajan her dosya için add_watermark komutunu çağırır. Her çağrı yeni bir filigranlı kopya kaydeder ve orijinali yerinde bırakır, böylece kaynak klasör işaretlenmemiş sürümlerin kaydı olarak kalır.

Aşama 2: İnceleme damgasına nasıl geçilir?

Aşama 1’den sonra her dosya DRAFT işaretini taşır, bu yüzden işareti değiştirin: eski işareti metinle kaldırın, ardından sonucu damgalayın.

Bu klasördeki her dosyadan DRAFT filigranını kaldır, ardından her sonuca FOR REVIEW filigranı ekle.

Ajan textFilter DRAFT olarak ayarlanmış remove_watermarks komutunu çağırır, ardından temizlenmiş her kopyaya add_watermark uygular. Bazı dosyalar işaretli, bazıları işaretsiz karışık bir klasör için, ajanı önce bakması için şu şekilde yönlendirin:

Zaten bir filigranı olanlar dışındaki her dosyayı FOR REVIEW olarak işaretle.

Her dosyada search_watermarks çalıştırır ve bir işaret döndürenleri atlar. Format başına farklı bir işaret için şöyle söyleyin:

Slayt sunumlarına logo ekleyin ve PDF’lere metin işareti koyun.

Aşama 3: İş onaylandığında işaretleri nasıl temizlersiniz?

Onay, gereksinimi tersine çevirir. Aynı klasörde, kendi belgelerinizle:

Bu klasördeki her dosyadan DRAFT filigranını kaldır ve diğer işaretleri koru.

Bu, “DRAFT” textFilter ile remove_watermarks komutudur. Filtre, büyük/küçük harfe duyarsız bir alt dize eşleşmesidir; filtre olmadan motorun tanıyabildiği her filigran kaldırılır. Sonuçlar <name>_unwatermarked.<ext> olarak kaydedilir. Ayrıntılar, kaldırmadan önce arama yapma konulu eşlik eden gönderide, aşağıda bağlantısı verilmiştir.

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

Sen:    Belgeler klasörümdeki her PDF'ye çapraz bir DRAFT filigranı ekle, ardından ürettiğin dosyaları listele.
Ajan:  [add_watermark x 3: text "DRAFT", rotation -45]
        Metin filigranı "DRAFT" "proposal-01.pdf" dosyasına eklendi
        Metin filigranı "DRAFT" "proposal-02.pdf" dosyasına eklendi
        Metin filigranı "DRAFT" "proposal-03.pdf" dosyasına eklendi
        3 filigranlı kopya üretildi. 0 hata.
        Orijinaller değişmedi.

Orijinaller ve çıktı klasörü ne olacak?

Varsayılan olarak, giriş ve çıkış aynı klasörü paylaşır, bu yüzden filigranlı kopyalar kaynaklarının yanına yerleştirilir. Temiz bir ayrım tercih ediyorsanız, GROUPDOCS_MCP_OUTPUT_PATH değişkenini ayrı bir klasöre ayarlayın ve oradan gönderin. Her iki durumda da orijinaller asla üzerine yazılmaz, böylece bir kaynak dosya değiştiğinde aşamayı yeniden çalıştırabilirsiniz; yeniden işlenmesini istediğiniz dosyaları adlandırın.

Bir toplu işlemi doğru tutmak nasıl yapılır?

  • Üretilen dosyaların listesini isteyin. Sadece “done” (tamam) raporlayan bir çalıştırma, hangi kopyaların gönderileceği konusunda tahmin yürütmenize neden olur.
  • Hataları açıkça isteyin. Karışık bir klasör, motorun filigran ekleyemediği bir format içerebilir. Çağrı, sessizce atlamak yerine bir mesajla başarısız olur, bu yüzden hataların listesini talep edin.
  • Ölçülen kullanıma dikkat edin. Ölçülen lisanslama altında her dosya işleme olarak faturalandırılır.
  • Önce lisansı kontrol edin. Değerlendirme modundaki bir toplu işlem boşa bir çalıştırmadır.

Sınırlamalar nelerdir?

Değerlendirme modu ana sınırlamadır: sunucunun lisans sayfası, lisanssız çıktının değerlendirme sınırlamaları taşıdığını belirtir; kesin sınırlamalar kütüphanenin lisans sayfasında yer alır. Değerlendirme-modunda kopyalar içeren bir klasör, dağıtamayacağınız taslakların bulunduğu bir klasördür. Ajanı çalıştırmadan önce get_license_status komutunu çağırmasını isteyin; mode değerini değerlendirme, lisanslı veya ölçülen olarak raporlar. Ayrıca yerleşik bir zamanlayıcı yoktur: sunucu, ajanınız istediğinde çalışır, bu yüzden yinelenen bir iş bir istemci ya da komut gönderici bir görev çalıştırıcı gerektirir.

SSS

AI birden fazla PDF’ye aynı anda filigran ekleyebilir mi?
Evet. Ajan klasörü döner ve her dosya için bir kez add_watermark çağırır, ardından ürettiği kopyaları listeler. Her dosya ayrı ayrı işlenir.

Bir klasördeki her belgeye CONFIDENTIAL ekleyebilir miyim?
Evet. İstekte DRAFT yerine CONFIDENTIAL kullanın. Zaten bir işaret taşıyan dosyaların atlanıp atlanmayacağını belirtin.

Toplu filigran ekleme yerel olarak, yükleme yapmadan mümkün mü?
Evet. Sunucu, istemciniz tarafından başlatılan yerel bir süreçtir ve yapılandırdığınız klasörü okur ve yazar.

Daha derine inin