به‌صورت خودکار اسناد را برند کنید؛ یک دستور ثابت به یک عامل هوش مصنوعی بدهید و اجازه دهید برای هر فایل در پوشه خروجی، ابزار علامت‌گذاری تصویر را به‌صورت محلی فراخوانی کند. با سرور GroupDocs.Watermark.Mcp این دستور می‌تواند یک خط در فایل قوانین، یک دستور پروژه در Claude Code یا یک پرامپت که در Cursor می‌چسبانید، باشد:

لوگو.png را با شفافیت ۲۵٪ روی هر صفحه از هر فایلی در پوشه خروجی قرار دهید، سپس فایلی که تولید کردید را فهرست کنید.

نسخه گام‌به‌گام همراه با پیکربندی و عیب‌یابی در مستندات موجود است: چگونه اسناد را با یک واترمارک لوگو به‌وسیله هوش مصنوعی برند کنیم.

چرا برندینگ دستی دچار انحراف می‌شود؟

برندینگ دستی بسته به شخص متفاوت است: یک تیم لوگو را در فایل منبع می‌چسباند، تیم دیگر PDF را با شدت کامل مهر می‌زند، تیم سومی فراموش می‌کند. یک LLM که «لوگو اضافه می‌کند» با ویرایش محتوای سند نیز مکان ثابت‌تری ندارد. ابزار add_image_watermark لوگو را به‌عنوان یک شیء واترمارک اعمال می‌کند، با مقادیر صریح opacity و rotation، بنابراین ورودی‌های یکسان همان شدت و زاویه را تولید می‌کنند. چون این یک شیء است و نه محتوای چسبانده‌شده، می‌توان بعداً لوگو را پیدا و حذف کرد وقتی برند تغییر می‌کند.

عامل چه تصمیمی می‌گیرد و موتور چه کاری انجام می‌دهد؟

گام عامل تصمیم می‌گیرد موتور انجام می‌دهد
کدام فایل‌ها در محدوده هستند پوشه و دستور شما را می‌خواند هیچ‌چیز
کدام ابزار فراخوانی شود add_image_watermark برای لوگو، add_watermark برای وضعیت هیچ‌چیز
شدت و زاویه opacity و rotation را از استاندارد شما می‌گیرد علامت را دقیقاً با آن مقادیر می‌کشد
خروجی فایل‌های تولید شده را گزارش می‌دهد فایل جدیدی می‌نویسد؛ فایل اصلی تغییر نمی‌کند

استاندارد در پرامپت شما زندگی می‌کند. سرور خود را زمان‌بندی نمی‌کند و سیاست برند داخلی ندارد؛ بخش قابل تکرار، دستوری است که ذخیره و دوباره استفاده می‌کنید.

چگونه استاندارد را در پنج گام اعمال کنید؟

  1. لوگو را در کنار اسناد نگه دارید. هر دو، سند و تصویر، بر اساس نام از پوشه ذخیره‌سازی (GROUPDOCS_MCP_STORAGE_PATH) حل می‌شوند. از PNG شفاف استفاده کنید؛ لوگویی روی یک مستطیل سفید، همان مستطیل را روی صفحه نشان می‌دهد.
  2. فایل‌های خروجی را جدا کنید. اگر می‌خواهید نسخه‌های برند شده از منابع جدا بمانند، GROUPDOCS_MCP_OUTPUT_PATH را به پوشه‌ای متفاوت تنظیم کنید. اگر تنظیم نشود، خروجی به پوشه ذخیره‌سازی می‌رود.
  3. مجوز را بررسی کنید. بپرسید: «وضعیت مجوز سرور واترمارک چیست؟» عامل get_license_status را فراخوانی می‌کند.
  4. پرامپت استاندارد را اجرا کنید. شفافیت بین ۰.۲ تا ۰.۴ بازه‌ای است که مستندات برای برندینگ توصیه می‌کند؛ بالای ۰.۶ لوگو بر صفحه غلبه می‌کند.
  5. تأیید کنید. برای هر فایل تولید شده یک پاس search_watermarks درخواست کنید و تعداد را با آنچه انتظار دارید مقایسه کنید.

آیا می‌توان علامت همچنین وضعیت را بیان کرد؟

بله، با یک فراخوانی زنجیره‌ای دوم. برند و وضعیت را در یک درخواست ترکیب کنید:

لوگو را با شفافیت ۲۵٪ اضافه کنید، سپس یک واترمارک متنی CONFIDENTIAL به نتیجهٔ آن اضافه کنید.

هر فراخوانی یک فایل جدید می‌نویسد، بنابراین «به نتیجهٔ آن» همان چیزی است که هر دو علامت را حفظ می‌کند.

جلسهٔ نمونه (مختصر)

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.

تکرار این روش ایمن است چون هر تلاش یک فایل جدید است. پس از آن فایل‌های ردشده را حذف کنید.

کدام کانال تحویل برای استقرار تیمی مناسب است؟

برای یک تنظیمات مشترک، تصویر Docker نیاز به نصب چیزی روی هر ماشین را از بین می‌برد، زیرا زمان اجرا و وابستگی‌های بومی داخل آن قرار دارند:

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

کانال NuGet (dnx GroupDocs.Watermark.Mcp --yes) به SDK .NET 10 نیاز دارد. هر دو بر روی Windows، Linux و macOS اجرا می‌شوند (dnx روی Linux/macOS همچنین به libgdiplus نیاز دارد) و هر دو از همان شش ابزار استفاده می‌کنند، بنابراین پرامپت برند بین آن‌ها تغییری نمی‌کند.

محدودیت‌ها چیستند؟

دو محدودیت اصلی وجود دارد. اول، ابزار فقط opacity و rotation را در دسترس می‌گذارد: موقعیت، اندازه یا تنظیم حاشیه وجود ندارد. دوم، حالت ارزیابی: صفحهٔ مجوز سرور می‌گوید خروجی بدون مجوز محدودیت‌های ارزیابی دارد (محدودیت‌های دقیق در صفحهٔ مجوز کتابخانه)، بنابراین نسخه‌های برند شده بدون مجوز توزیع‌پذیر نیستند. قبل از استقرار برند، get_license_status را اجرا کنید. تحت مجوز متری، هر فایل پردازش‌شده هزینه می‌شود، و تحت مجوز فایل، سرور به‌صورت آفلاین کار می‌کند. همچنین به یاد داشته باشید که واترمارک فقط یک برچسب بر روی سند است؛ محتوای زیر آن را محافظت نمی‌کند.

پرسش‌های متداول

آیا هوش مصنوعی می‌تواند لوگوی شرکت ما را به تمام PDFها اضافه کند؟
بله. لوگو را با نام فایل درخواست کنید و شفافیتی تعیین کنید؛ عامل add_image_watermark را برای هر فایل یک‌بار فراخوانی می‌کند. همان فراخوانی برای Word، PowerPoint، Excel و فایل‌های تصویری نیز کار می‌کند.

آیا می‌توانم از همان لوگو برای تصاویر و اسناد استفاده کنم؟
بله. تصاویر نیز هدف‌های معتبر هستند، بنابراین برندینگ عکس‌های محصول همانند برندینگ PDF عمل می‌کند.

وقتی برند تغییر می‌کند چه می‌شود؟
remove_watermarks می‌تواند لوگوی قدیمی را حذف کند، چون به‌عنوان شیء واترمارک اعمال شده بود. textFilter فقط متن واترمارک را مطابقت می‌دهد، بنابراین حذف یک لوگوی تصویری به معنای حذف تمام واترمارک‌ها، شامل علامت‌های متنی نیز می‌شود. ابتدا جستجو کنید تا بدانید چه چیزی وجود دارد، سپس لوگوی جدید را اضافه کنید.

بیشتر بخوانید