می‌توانید با استفاده از یک عامل هوش مصنوعی که یک پوشه کامل اسناد را در یک درخواست به‌صورت محلی بررسی می‌کند، یک سیاست امضای دیجیتال را اعمال کنید و یک جدول واحد از استثناها برگردانید. این عامل در Claude Desktop، Claude Code، Cursor یا GitHub Copilot اجرا می‌شود و سرور GroupDocs.Signature.Mcp بررسی‌ها را انجام می‌دهد. درخواست اولیه‌ای که اسکن را آغاز می‌کند:

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

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

چرا یک سیاست امضای دیجیتال به یک اسکن خودکار نیاز دارد؟

سیاستی مانند «هر قرارداد در آرشیو دارای امضای دیجیتال معتبر است» تنها زمانی یک سیاست محسوب می‌شود که چیزی آن را تست کند. بررسی‌های دستی فایل‌ها را یکی‌یکی باز می‌کنند، بنابراین به‌ندرت انجام می‌شوند و تنها نمونه‌ای را پوشش می‌دهند. سؤالاتی که بخش انطباق می‌پرسد درباره کل آرشیو است: کدام قراردادها امضا نشده‌اند، گواهی‌نامهٔ چه کسی منقضی شده است، کدام فایل‌ها پس از امضا تغییر کرده‌اند.

یک عامل هوش مصنوعی به تنهایی نمی‌تواند به این سؤالات پاسخ دهد، زیرا مدلی که یک PDF را می‌خواند نمی‌تواند ساختار امضای آن را ببیند. عامل حلقه و خلاصه را فراهم می‌کند. موتور، حقایق را برای هر فایل ارائه می‌دهد.

جریان کار، گام به گام

  1. سرور را به پوشه اشاره دهید. مقدار GROUPDOCS_MCP_STORAGE_PATH را به پوشه اسناد تنظیم کنید. فایل‌ها بر اساس نام حل می‌شوند، بنابراین عامل contract-042.pdf را می‌فرستد، نه مسیر کامل از دستگاه شما.
  2. حالت مجوز را بررسی کنید. از عامل بخواهید get_license_status را فراخوانی کند. در حالت ارزیابی تنها دو صفحهٔ اول پردازش می‌شوند، بنابراین یک گزارش «تمیز» ممکن است نادرست باشد (به محدودیت‌های زیر مراجعه کنید).
  3. اجرای اسکن. از درخواست بالا استفاده کنید. برای هر فایل، عامل search_digital_signatures را فراخوانی می‌کند و جدول را می‌سازد. فایلی که امضای دیجیتال پیدا نشود به‌عنوان بدون امضا گزارش می‌شود.
  4. خواندن استثناها. جدول را بر اساس وضعیت مرتب کنید و با سه گروه زیر کار کنید.
  5. دوباره اجرا کردن به‌صورت زمان‌بندی‌شده. همان درخواست در ماه بعد بر روی همان پوشه کار می‌کند، بنابراین بررسی به یک روتین تبدیل می‌شود نه یک پروژه.

چه چیزی توسط عامل تصمیم‌گیری می‌شود و موتور چه کاری انجام می‌دهد

مرحله تصمیم عامل کار موتور
کدام فایل‌ها بررسی شوند فهرست PDFهای موجود در پوشه را بر اساس درخواست شما می‌دهد هر فایل را بر اساس نام از ذخیره‌سازی حل می‌کند
آیا امضا شده، معتبر است و توسط چه کسی فایل‌ها را انتخاب می‌کند امضاکننده، صادرکننده، شماره سریال، دورهٔ اعتبار، زمان‌مهر و isValid را برمی‌گرداند (search_digital_signatures)
گزارش جدول را می‌سازد و استثناها را گروه‌بندی می‌کند هیچ‌چیز؛ موتور خلاصه‌سازی نمی‌کند

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

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

عامل:  [get_license_status]  حالت: دارای مجوز
        [search_digital_signatures] x N
        | فایل             | امضاکننده      | امضا شده     | وضعیت   |
        | contract-041.pdf | Dana Whitfield | 2026-09-14 | معتبر    |
        | contract-042.pdf | -              | -          | بدون امضا |
        | contract-043.pdf | Omar Haddad    | 2026-08-02 | نامعتبر  |
        استثناها: 1 بدون امضا، 1 نامعتبر. نامعتبر معمولاً به این معنی است که فایل پس از امضا تغییر کرده است.

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

سه استثنای مهم

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

چگونه اسکن را ارزان نگه دارید و گزارش را قابل اعتماد کنید؟

  • در هر فایل search_digital_signatures را اجرا کنید. verify را فقط به‌عنوان یک صفحه‌نمایش سریع اختیاری اضافه کنید و رکورد جزئیات را به‌عنوان منبع حقیقت در نظر بگیرید.
  • در حالت دسته‌ای search_image_signatures را نادیده بگیرید. این متد برای هر نتیجه تصویر base64 برمی‌گرداند و بدون دلیل زمان اجرا را افزایش می‌دهد.
  • returnImage را در جستجوهای کد غیرفعال بگذارید.
  • در مجوزهای مبتنی بر متر، هر فراخوانی هزینه استفاده دارد، بنابراین یک اسکن هدفمند هزینه کمتری دارد و سریع‌تر اجرا می‌شود.
  • جزئیات گواهی‌نامه برای هر فایل (امضاکننده، صادرکننده، سریال، زمان‌مهر) را به‌عنوان رکورد خود نگه دارید. خلاصهٔ متنی عامل یک گزارش است، نه یک گواهی‌نامه، و عمل اسناد رسمی نیست.

سپس بر روی استثناها اقدام کنید

همان جلسه می‌تواند آنچه اسکن پیدا می‌کند را اصلاح کند، برای مثال با اعمال یک علامت مرجع به فایل‌های بدون امضا:

سه فایل بدون امضا را با مرجع QR استاندارد ما امضا کنید و آنچه انجام دادید را فهرست کنید.

دقیق باشید که این کار چه تأثیری دارد. یک کد QR یک علامت بصری است، نه امضای مبتنی بر گواهی‌نامه، بنابراین جایگزین امضای دیجیتال مورد نیاز نمی‌شود. برای فایل‌هایی که به امضا نیاز دارند، آن را در آخر با sign و type: "digital" اعمال کنید.

محدودیت‌هایی که باید در فرآیند خود بیان کنید

حالت ارزیابی تنها دو صفحهٔ اول هر سند را پردازش می‌کند و یک نشان آزمایشی بر هر صفحه می‌گذارد. امضایی که در صفحهٔ ۴ باشد نمایش داده نمی‌شود، بنابراین یک بررسی دسته‌ای بدون مجوز می‌تواند برای فایلی که امضا ندارد، «تمیز» گزارش کند. هر بار ابتدا get_license_status را بررسی کنید. سرور همچنین داده‌های امضا را از فایل می‌خواند؛ سیاست شما را نمی‌داند، بنابراین تعریف گواهی‌نامهٔ قابل قبول با شماست.

سؤالات متداول

کدام یک از قراردادهای من امضا نشده‌اند؟
از عامل بخواهید پوشه را بررسی کند و فایل‌هایی که امضای دیجیتال ندارند فهرست کند. برای هر فایل یک فراخوانی search_digital_signatures انجام می‌شود؛ فایلی که هیچ امضایی یافت نشود به‌عنوان بدون امضا فهرست می‌شود. نتیجه یک جدول است.

آیا هوش مصنوعی می‌تواند بررسی دسته‌ای امضاهای PDF را انجام دهد؟
بله، در یک درخواست بر روی یک پوشه، به‌صورت محلی. بدون داشتن مجوز تنها دو صفحهٔ اول هر فایل بررسی می‌شوند.

آیا گزارش می‌تواند به‌عنوان مدرک انطباق استفاده شود؟
جزئیات گواهی‌نامه برای هر فایل که توسط موتور بازگردانده می‌شود را به‌عنوان مدرک نگه دارید. خلاصهٔ عامل صرفاً یک تسهیل است، نه یک گواهی.

برای اطلاعات بیشتر