Belge markalamayı otomatikleştirmek için, bir AI ajanına tek bir kalıcı talimat verin ve çıkış klasöründeki her dosya için yerel bir görüntü‑filigran aracını çağırmasına izin verin. GroupDocs.Watermark.Mcp sunucusuyla bu talimat bir kurallar dosyasında tek satır, Claude Code’da bir proje talimatı veya Cursor’a yapıştırdığınız bir istem olabilir:

Çıkış klasöründeki her dosyanın her sayfasına logo.png dosyasını %25 opaklıkta yerleştir, ardından ürettiğiniz dosyaları listele.

Yapılandırma ve sorun giderme ile adım adım sürüm belgelerde bulunabilir: AI kullanarak logo filigranı ile belgeleri markalama.

Neden manuel markalama sapma gösterir?

Elle uygulanan markalama kişiden kişiye değişir: bir ekip logoyu kaynak dosyaya yapıştırır, bir diğeri PDF’yi tam güçte damgalamış olur, bir başkası unutabilir. Belge içeriğini düzenleyerek “logo ekleyen” bir LLM de sabit bir konum sağlamaz. add_image_watermark aracı logoyu bir filigran nesnesi olarak uygular, açık opacity ve rotation değerleriyle, böylece aynı girdiler aynı güç ve açı verir. Nesne olduğu ve yapıştırılmış içerik olmadığı için logo, marka değiştiğinde daha sonra bulunup kaldırılabilir.

Ajan ne karar verir, motor ne yapar?

Adım Ajan karar verir Motor yapar
Kapsamdaki dosyalar Klasörü ve talimatınızı okur Hiçbir şey
Hangi araç çağrılacak add_image_watermark logo için, add_watermark durum için Hiçbir şey
Güç ve açı Standartınızdan opacity ve rotation değerlerini geçirir İşareti tam olarak bu değerlerle çizer
Çıktı Üretilen dosyaları rapor eder Yeni bir dosya yazar; orijinal değiştirilmez

Standart, isteminizde bulunur. Sunucu kendini zamanlamaz ve yerleşik bir marka politikası yoktur; tekrarlanabilir kısım, kaydedip yeniden kullandığınız talimattır.

Standartı beş adımda nasıl uygularsınız?

  1. Logoyu belgelerin yanına tutun. Hem belge hem de görüntü, depolama klasöründen (GROUPDOCS_MCP_STORAGE_PATH) isimle çözülür. Şeffaf bir PNG kullanın; beyaz bir dikdörtgen üzerindeki logo, sayfa üzerinde o dikdörtgeni gösterir.
  2. Çıkış dosyalarını ayırın. Markalı kopyaların kaynaklardan ayrı tutulmasını istiyorsanız GROUPDOCS_MCP_OUTPUT_PATH değişkenini farklı bir klasöre ayarlayın. Ayarlanmamışsa çıktı depolama klasörüne gider.
  3. Lisansı kontrol edin. Şu soruyu sorun: “Watermark sunucusunun lisans durumu nedir?” Ajan get_license_status çağırır.
  4. Standart istemi çalıştırın. Belgeleri markalamak için dokümantasyonun önerdiği aralık %0.2‑%0.4 arasındadır; %0.6’nın üzerindeki opaklık logo sayfayı bastırır.
  5. Doğrulayın. Her üretilen dosyada bir search_watermarks geçişi isteyin ve sayıyı beklentinizle karşılaştırın.

İşaret aynı zamanda bir durum belirtebilir mi?

Evet, ikinci bir zincirlenmiş çağrıyla. Tek bir istek içinde marka ve durumu ekleyin:

Logoyu %25 opaklıkta ekle, ardından o sonuca CONFIDENTIAL metin filigranı ekle.

Her çağrı yeni bir dosya yazar, bu yüzden “o sonuca” ifadesi her iki işareti de korur.

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

You:    Put logo.png on report.pdf at 30% opacity.
Agent:  [add_image_watermark: watermarkImage logo.png, opacity 0.3]
        Added image watermark from "logo.png" to "report.pdf"
You:    That is too strong - redo it at 0.2.
Agent:  [add_image_watermark: opacity 0.2, from the original report.pdf]
        Added image watermark from "logo.png" to "report.pdf"
        Two branded copies exist. Delete the 0.3 copy if you do not need it.

Bu şekilde yinelemek güvenlidir çünkü her deneme yeni bir dosyadır. Reddedilenleri sonradan silin.

Hangi dağıtım kanalı bir ekip yayılımına uygundur?

Paylaşımlı bir kurulum için Docker görüntüsü, her makinede başka bir şey kurmayı önler; çünkü çalışma zamanı ve yerel bağımlılıklar içinde bulunur:

docker run --rm -i -v $(pwd)/documents:/data \
  ghcr.io/groupdocs-watermark/watermark-net-mcp:latest

NuGet kanalı (dnx GroupDocs.Watermark.Mcp --yes) .NET 10 SDK’sını gerektirir. İkisi de Windows, Linux ve macOS’ta çalışır (dnx Linux/macOS’ta ayrıca libgdiplus gerekir) ve aynı altı aracı kullanır, bu yüzden marka istemi aralarında değişmez.

Sınırlamalar nelerdir?

İki sınırlama etrafında plan yapın. İlk olarak, araç yalnızca opacity ve rotation değerlerini açığa çıkar: konum, boyut veya kenar boşluğu ayarı yoktur. İkinci olarak, değerlendirme modu: sunucunun lisans sayfası, lisanssız çıktının değerlendirme sınırlamaları taşıdığını belirtir (tam sınırlamalar kütüphanenin lisans sayfasında bulunur), bu yüzden lisans olmadan üretilen markalı kopyalar dağıtılamaz. Marka yayılımından önce get_license_status çalıştırın. Ölçülen lisanslama altında her işlenen dosya faturalandırılır, lisanslı dosya altında sunucu çevrim dışı çalışır. Ayrıca bir filigranın bir belgeyi etiketlediğini, içeriği korumadığını unutmayın.

SSS

AI şirket logosunu tüm PDF’lere ekleyebilir mi?
Evet. Logoyu dosya adıyla isteyin ve bir opaklık verin; ajan her dosya için bir kez add_image_watermark çağırır. Aynı çağrı Word, PowerPoint, Excel ve görüntü dosyalarında da çalışır.

Aynı logoyu görüntülerde ve belgelerde kullanabilir miyim?
Evet. Görüntüler geçerli hedeflerdir, bu yüzden ürün fotoğraflarını markalamak bir PDF’yi markalamak gibi çalışır.

Marka değiştiğinde ne olur?
remove_watermarks eski logoyu kaldırabilir, çünkü logo bir filigran nesnesi olarak uygulanmıştır. textFilter yalnızca metin filigranlarını eşleştirir, bu yüzden bir görüntü logosunu kaldırmak tüm filigranları, metin işaretlerini de kaldırır. Önce arama yaparak neler olduğunu öğrenin, ardından yeni logoyu ekleyin.

Daha derine inin