لتحويل مجلد دفعةً باستخدام وكيل ذكاء اصطناعي، وجه خادم GroupDocs.Conversion.Mcp إلى المجلد ووصف المهمة بجملة واحدة. يعمل الوكيل عبر الملفات، يستدعي محرك التحويل مرةً واحدة لكل مستند، ويبلغ عما تم إنتاجه، كل ذلك محليًا في Claude أو Cursor أو GitHub Copilot. إنها معالجة دفعية تُقَدَّم بواسطة جملة:

Convert every DOCX in my documents folder to PDF, keep the originals

الإصدار خطوة بخطوة مع الإعدادات واستكشاف الأخطاء موجود في الوثائق: How to batch-convert a folder of documents with an AI agent. هذه المقالة تستعرض نفس المهمة كجلسة قصيرة، من الموجه الأول إلى التعامل مع الفشل.

من أين تبدأ: مجلد التخزين أم الموجه؟

ابدأ بمجلد التخزين. تنجح أو تفشل مهمة الدفعة بناءً على تعيين المجلد، ويتم تعيين هذا التعيين مرة واحدة في إدخال الخادم، وليس في كل موجه. متغيرا بيئة اثنان يتحكمان بذلك:

{
  "mcpServers": {
    "groupdocs-conversion": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Conversion.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/invoices",
        "GROUPDOCS_MCP_OUTPUT_PATH": "/path/to/invoices/converted"
      }
    }
  }
}

GROUPDOCS_MCP_STORAGE_PATH هو المجلد الذي يمكن للوكيل قراءته. GROUPDOCS_MCP_OUTPUT_PATH هو المكان الذي تُحفظ فيه الملفات المحوَّلة. عندما يُضبط كلا المتغيرين، يبقى مجلد المصدر دون تعديل وتذهب كل النتيجة إلى converted. هذا هو التخطيط الأنظف للدفعة. أمر dnx يحتاج إلى .NET 10 SDK؛ صورة Docker ghcr.io/groupdocs-conversion/conversion-net-mcp:latest تُركّب المجلد كـ /data. أعد تشغيل Claude Desktop أو Claude Code أو VS Code أو Cursor بعد تسجيل الخادم.

ماذا يفعل الموجه الأول؟

قدِّم للوكيل الحالة البسيطة أولًا:

Convert everything in this folder from DOCX to PDF.

يقوم الوكيل بإحصاء محتويات المجلد ويستدعي أداة convert لكل ملف مع format: "pdf". كل استدعاء يأخذ اسم ملف من التخزين ويعيد اسم الملف المحفوظ. تشغيله مرتين سيؤدي إلى إنشاء ملفات جديدة ذات أسماء مميزة بجوار الأولى.

كيف تضيف مرشحًا أو قاعدة؟

الموجه هو طبقة التنسيق. الترشيح، الترتيب، وسياسة الأخطاء هي لغة طبيعية:

Turn all the PDFs into Markdown; skip files that are already converted.
Convert the invoices to PDF/A for archiving, and list any file that failed.
Make PNG previews of every presentation.

للتسلسل، يمكن للوكيل أولًا استدعاء get_document_info، الذي يُعيد نوع الملف، عدد الصفحات، والخصائص الأساسية دون تحويل:

Check the page count of each PDF first, and only convert the ones with more than 10 pages.

القرار “أكثر من 10 صفحات” هو للوكيل. التحويل يبقى مسؤولية المحرك.

ماذا يحدث عندما يفشل ملف واحد؟

عندما لا يستطيع المحرك تحويل ملف، على سبيل المثال لأن تنسيق المصدر غير مدعوم أو كلمة المرور خاطئة، يبدأ نص الاستجابة لذلك الملف بعملية التحويل والسبب. اسم ملف غير موجود يُعيد قائمة بالملفات التي يستطيع الخادم رؤيتها حتى يتمكن الوكيل من تصحيح نفسه. للملفات المحمية، تقبل convert معاملًا اختياريًا password.

لهذا السبب تُدرج سياسة الفشل في الموجه: “list any file that failed” يطلب من الوكيل تقريرًا في نهاية التنفيذ، بحيث لا يمر الفشل دون ملاحظة. اقرأ التقرير وأعد تشغيل الملفات الفاشلة فقط.

جلسة مثال

هذه جلسة مختصرة توضيحية. أسماء الملفات مختلقة والرد مبني على السلوك الموثق، وليس على لقطة شاشة.

You:    Convert the invoices to PDF/A for archiving, and list any file that failed.
Agent:  [enumerates the invoice files]
Agent:  [calls convert for each file, one at a time]
Agent:  Converted 11 files to the output folder.
        Failed: invoice-0412.docx (password-protected, no password given).

كيف تتابع التقدم في مجلد كبير؟

عادةً ما يعالج الوكيل الملفات واحدًا تلو الآخر، لذا يزداد وقت التشغيل مع عدد الملفات وحجمها. لتقارير التقدم، اطلب ذلك في الموجه: “tell me after every ten files” أو “summarize at the end”. بضع مئات من المستندات تعمل بشكل جيد، ويُظهر التقرير النهائي ما حدث. ابدأ بنسخة من مجموعة فرعية صغيرة، تحقق من مخرجات اثنين أو ثلاثة يدويًا، ثم نفّذ المجلد بالكامل.

ماذا لو كان يجب تشغيل الدفعة دون مراقبة؟

جلسة الوكيل تحتاج إلى شخص لتشغيلها. للخطوط المجدولة، يُظهر دليل n8n طريقة تشغيل أداة سير عمل تدير نفس الخادم، ويمكن أيضًا تشغيل المحرك عبر مكتبة GroupDocs.Conversion لـ .NET. استخدم الدردشة للدفعات العشوائية التي تريد قراءة التقرير لها.

ما هي الحدود؟

  • وضع التقييم يحد الدفعة إلى 15 مستندًا. بدون ترخيص، يمكن لعملية خادم واحدة فتح ما لا يزيد عن 15 مستندًا وتُضاف علامة مائية تقييمية إلى الناتج. بعد ذلك، تفشل الاستدعاءات الإضافية حتى يُعاد تشغيل الخادم. تحقق من الوضع باستخدام get_license_status قبل بدء دفعة حقيقية، أو اسأل “what is the license status of the conversion server?”.
  • الترخيص القائم على الاستهلاك يحتاج إلى اتصال خارجي. مع مفاتيح الاستهلاك، يُرسل الاستخدام إلى خوادم GroupDocs، لذا يجب على الجهاز المحجوب استخدام ملف ترخيص. لا يُرسل محتوى المستند أبدًا.
  • المسح يبقى صورة. OCR ليس جزءًا من الخادم، لذا دفعة من ملفات PDF التي تحتوي على صور فقط لن تحصل على طبقة نصية.

الأسئلة المتكررة

كيف أحول جميع ملفات DOCX في مجلد إلى PDF باستخدام الذكاء الاصطناعي؟
حدد مجلد التخزين، ثم اطلب من الوكيل ذلك بجملة واحدة. يحول الملفات واحدةً تلو الأخرى عبر الخادم المحلي ولا يتم رفع أي شيء.

هل يمكن لوكيل الذكاء الاصطناعي معالجة مجلد كامل محليًا؟
نعم. يعمل الوكيل وخادم التحويل على جهازك، وتُقرأ الملفات وتُكتب إلى مجلداتك الخاصة.

ما هي أفضل طريقة لأتمتة خط أنابيب تحويل المستندات؟
استخدم الدردشة للدفعات العشوائية التي تريد مراجعتها. للخط المجدول، قُد الخادم نفسه من أداة سير عمل مثل n8n، أو برمج مكتبة .NET.

تعمق أكثر