می‌توانید یک پوشه از اسناد را با یک درخواست علامت‌گذاری کنید: یک عامل هوش مصنوعی فایل‌ها را فهرست می‌کند، ابزار علامت‌گذاری را برای هر فایل یک بار فراخوانی می‌کند و آنچه تولید کرده است گزارش می‌دهد، همه به‌صورت محلی و بدون بارگذاری. در Claude Desktop، Claude Code، Cursor یا Windsurf درخواست به این شکل است:

یک علامت آبکی مورب DRAFT به هر PDF در پوشه اسناد من اضافه کنید، سپس فایل‌هایی که تولید کردید را فهرست کنید.

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

چرا به‌جای یک‌بار علامت‌گذاری، بر اساس مرحله‌ٔ چرخهٔ حیات علامت بزنیم؟

یک بستهٔ پیشنهادی به‌ندرت یک‌بار علامت‌گذاری می‌شود. ابتدا به‌صورت DRAFT شروع می‌شود، وقتی به همکار می‌رسد به FOR REVIEW تبدیل می‌شود و وقتی تأیید می‌شود علامت خود را از دست می‌دهد. انجام این کار به‌صورت دستی برای سی فایل کاری است که تحت فشار زمان کنار گذاشته می‌شود. با GroupDocs.Watermark.Mcp هر مرحله یک جمله است و عامل حلقه‌ای را فراهم می‌کند که در غیر این صورت باید به‌صورت اسکریپت می‌نوشتید. موتور فرمت را مدیریت می‌کند، بنابراین همان درخواست می‌تواند PDF، Word، Excel، PowerPoint و فایل‌های تصویری در یک پوشه را پوشش دهد.

مرحلهٔ ۱: چگونه یک علامت آبکی پیش‌نویس (draft) به تمام فایل‌ها اضافه کنیم؟

متغیر GROUPDOCS_MCP_STORAGE_PATH را به پوشهٔ موردنظر اشاره دهید. فایل‌ها بر اساس نام حل می‌شوند، بنابراین عامل proposal-01.pdf را می‌فرستد، نه مسیر کامل از دستگاه شما. سپس:

یک علامت آبکی مورب DRAFT به هر PDF در پوشه اسناد من اضافه کنید، سپس فایل‌هایی که تولید کردید را فهرست کنید.

عامل برای هر فایل add_watermark را فراخوانی می‌کند. هر فراخوانی یک نسخهٔ جدید علامت‌گذاری‌شده ذخیره می‌کند و نسخهٔ اصلی را دست‌نخورده می‌گذارد، بنابراین پوشهٔ منبع به‌عنوان رکورد نسخه‌های بدون علامت باقی می‌ماند.

مرحلهٔ ۲: چگونه به علامت بازبینی (review) سوئیچ کنیم؟

پس از مرحلهٔ ۱ هر فایل DRAFT دارد، بنابراین علامت را عوض کنید: علامت قدیمی را با متن حذف کنید، سپس نتیجه را علامت بزنید.

علامت آبکی DRAFT را از هر فایل در این پوشه حذف کنید، سپس یک علامت آبکی FOR REVIEW به هر نتیجه اضافه کنید.

عامل remove_watermarks را با textFilter تنظیم‌شده بر روی DRAFT فراخوانی می‌کند، سپس add_watermark را بر روی هر نسخهٔ پاک‌شده اجرا می‌کند. برای پوشه‌ای که حالت ترکیبی دارد، یعنی برخی فایل‌ها علامت‌گذاری شده‌اند و برخی نه، از عامل بخواهید ابتدا بررسی کند:

هر فایل را FOR REVIEW علامت بزنید به‌جز آن‌هایی که قبلاً علامت آبکی دارند.

این کار search_watermarks را بر روی هر فایل اجرا می‌کند و آن‌هایی را که علامت دارند رد می‌کند. برای علامت متفاوت بر حسب فرمت، این‌گونه بگویید:

لوگو را روی اسلایدها بگذارید و یک علامت متنی روی PDFها.

مرحلهٔ ۳: چگونه هنگام تأیید کار، علامت‌ها را پاک کنیم؟

تأیید نیاز را معکوس می‌کند. در همان پوشه، با اسناد خودتان:

علامت آبکی DRAFT را از هر فایل در این پوشه حذف کنید و بقیهٔ علامت‌ها را نگه دارید.

این همان remove_watermarks با textFilter برابر با “DRAFT” است. فیلتر به‌صورت جستجوی زیررشتهٔ بدون حساسیت به حروف بزرگ/کوچک عمل می‌کند؛ بدون آن، هر علامت آبکی‌ای که موتور می‌تواند شناسایی کند حذف می‌شود. نتایج به شکل <name>_unwatermarked.<ext> ذخیره می‌شوند. جزئیات بیشتر در پست همراه دربارهٔ جستجو قبل از حذف، که در زیر لینک شده است، آمده است.

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

You:    Add a diagonal DRAFT watermark to every PDF in my documents
        folder, then list the files you produced.
Agent:  [add_watermark x 3: text "DRAFT", rotation -45]
        Added text watermark "DRAFT" to "proposal-01.pdf"
        Added text watermark "DRAFT" to "proposal-02.pdf"
        Added text watermark "DRAFT" to "proposal-03.pdf"
        Produced 3 watermarked copies. 0 failures.
        Originals are unchanged.

دربارهٔ نسخه‌های اصلی و پوشهٔ خروجی چه می‌شود؟

به‌صورت پیش‌فرض، ورودی و خروجی یک پوشه را به‌اشتراک می‌گذارند، بنابراین نسخه‌های علامت‌گذاری‌شده کنار منابع خود قرار می‌گیرند. اگر ترجیح می‌دهید جداسازی تمیزی داشته باشید، GROUPDOCS_MCP_OUTPUT_PATH را به یک پوشهٔ جداگانه تنظیم کنید و از آنجا ارسال کنید. به هر حال نسخه‌های اصلی هرگز بازنویسی نمی‌شوند، بنابراین می‌توانید پس از تغییر یک فایل منبع، مرحله‌ای را دوباره اجرا کنید؛ فقط نام فایل‌هایی را که می‌خواهید دوباره پردازش شوند، بدهید.

چگونه یک دستهٔ کاری را صادقانه نگه داریم؟

  • از فهرست فایل‌های تولید شده بخواهید. اجرای کاری که فقط «done» را گزارش می‌دهد، شما را در حدس زدن اینکه کدام نسخه‌ها را باید ارسال کنید، می‌گذارد.
  • به‌صورت صریح از خطاها بپرسید. یک پوشهٔ ترکیبی ممکن است فرمت‌هایی داشته باشد که موتور نتواند علامت‌گذاری کند. فراخوانی به‌جای عبور ساکت، با پیامی خطا می‌دهد، بنابراین فهرست خطاها را درخواست کنید.
  • به مصرف متره‌ای توجه کنید. تحت لایسنس متره‌ای هر فایل به‌عنوان پردازش هزینه‌بر است.
  • ابتدا لایسنس را بررسی کنید. یک دستهٔ کاری در حالت ارزیابی یک اجرای بی‌فایده است.

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

حالت ارزیابی اصلی‌ترین محدودیت است: صفحهٔ لایسنس سرور می‌گوید خروجی بدون لایسنس دارای محدودیت‌های ارزیابی است؛ محدودیت‌های دقیق در صفحهٔ لایسنس کتابخانه آمده است. یک پوشه از نسخه‌های حالت ارزیابی در واقع یک پوشه از پیش‌نویس‌هاست که نمی‌توانید توزیع کنید. از عامل بخواهید قبل از اجرا get_license_status را فراخوانی کند؛ این فراخوانی mode را به‌صورت evaluation، licensed یا metered گزارش می‌دهد. همچنین زمان‌بند داخلی وجود ندارد: سرور زمانی عمل می‌کند که عامل شما درخواست کند، بنابراین یک کار دوره‌ای نیاز به یک کلاینت یا رانندهٔ وظیفه دارد که درخواست را ارسال کند.

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

آیا هوش مصنوعی می‌تواند چندین PDF را همزمان علامت‌گذاری کند؟
بله. عامل پوشه را پیمایش می‌کند و برای هر فایل یک بار add_watermark را فراخوانی می‌کند، سپس نسخه‌های تولید شده را فهرست می‌کند. هر فایل به‌صورت جداگانه پردازش می‌شود.

آیا می‌توانم کلمه CONFIDENTIAL را به هر سند در یک پوشه اضافه کنم؟
بله. در درخواست DRAFT را با CONFIDENTIAL جایگزین کنید. مشخص کنید آیا فایل‌هایی که قبلاً علامت دارند باید نادیده گرفته شوند یا نه.

آیا علامت‌گذاری دسته‌ای به‌صورت محلی و بدون بارگذاری امکان‌پذیر است؟
بله. سرور یک فرآیند محلی است که توسط کلاینت شما شروع می‌شود و پوشه‌ای را که پیکربندی کرده‌اید می‌خواند و می‌نویسد.

عمیق‌تر بروید