يمكنك تحويل “إرفاق الصفحة التي تُظهر المشكلة” إلى طلب واحد. يقوم خادم GroupDocs.Viewer.Mcp بتصوير الصفحات التي تحددها من ملف PDF أو Word أو Excel أو PowerPoint ويحفظ كل صفحة كملف PNG باسم ملف متوقع، محليًا على جهازك، بحيث يمكن لـ Claude أو Cursor أو GitHub Copilot إنتاج الصور لتقرير خطأ أو ملاحظة مراجعة أو شريحة:

صوّر الصفحات 1 و 4 و 9 من المواصفات وأخبرني بمكان الملفات.

الإصدار خطوة بخطوة مع الإعدادات واستكشاف الأخطاء موجود في الوثائق: How to create page images of documents for reports and tickets.

لماذا أتمتة صور الصفحات على الإطلاق؟

صورة الصفحة هي أدنى دليل يمكن تقديمه. يرفق مهندس الدعم صفحة الفاتورة التي تُظهر المجموع الخاطئ؛ يضع المراجع صورة مصغرة لكل صفحة تم تعديلها في ملاحظات المراجعة؛ يحتاج المقدم إلى مخطط واحد غير مُعاد تنسيقه. عند القيام بذلك يدويًا، يعني كل ذلك فتح الملف، العثور على الصفحة، أخذ لقطة شاشة وتسمية النتيجة. عدد الصفحات يختلف من ملف لآخر، لذا لا يمكن تجميع العمل بسهولة.

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

ما هو سير العمل؟

  1. ضع الملفات حيث يمكن للخادم رؤيتها. اربط المجلد الذي يحتوي على المستندات، سواء كان يحتوي على ملفات PDF أو Word، بحيث يعمل تصوير صورة صفحة DOCX بنفس الطريقة. يقرأ الخادم من مسار التخزين ويكتب الصور إلى مسار الإخراج، والذي يمكنك إبقاؤه منفصلًا باستخدام GROUPDOCS_MCP_OUTPUT_PATH.
  2. تحقق من عدد الصفحات. طلب: “كم عدد صفحات المواصفات؟” يستدعي الوكيل get_view_info ويقرأ pageCount. هذا مهم لأن render_page لا يرفض رقم صفحة يتجاوز نهاية المستند.
  3. سمّ الصفحات. طلب: “صوّر الصفحات 1 و 4 و 9 من المواصفات وأخبرني بمكان الملفات.” يستدعي الوكيل render_page ثلاث مرات، مرة لكل صفحة.
  4. اجمع أسماء الملفات. الملفات هي specification_page1.png و specification_page4.png و specification_page9.png في مجلد الإخراج. يبلّغ الوكيل عن المسارات.
  5. أرفقها. إذا كان عميلك متصلًا أيضًا بخادم تتبع مشكلات أو دردشة MCP، اطلب من الوكيل إرفاق الملفات بالتذكرة أو الرسالة. تلك الخطوة تستخدم أدوات الخادم الآخر، وليس هذا الخادم.

إذا كنت تريد الملفات فقط، فأخبر الوكيل بذلك حتى لا يصف كل صورة:

فقط احفظ الصور؛ لا تحتاج إلى وصفها.

ماذا يقرر الوكيل، وماذا يفعل المحرك؟

القرار أو الإجراء الوكيل المحرك
أي الصفحات ذات الصلة يطابق “الصفحات التي تحتوي على جدول الأسعار” بأرقام الصفحات، بعد التصوير أو الفحص لا شيء
ما إذا كانت الصفحة موجودة يستدعي get_view_info ويقارن يُعيد pageCount وأحجام الصفحات
التصوير يستدعي render_page مرة لكل صفحة ينتج ملف PNG
تسمية الملف يبلّغ عن المسار المحفوظ يحفظ كـ <source-stem>_page<N>.png
إرفاق إلى تذكرة يستخدم أداة خادم آخر لا شيء

جلسة مثال

توضيح مبني على أسماء الملفات الموثقة، وليس لقطة شاشة مسجلة.

أنت:   قم بتصوير الصفحات 1 و 4 و 9 من المواصفات وأخبرني بمكان
       الملفات. فقط احفظ الصور؛ لا حاجة لوصفها.

الوكيل: [calls render_page for page 1, page 4 and page 9]
       تم الحفظ:
         <output folder>/specification_page1.png
         <output folder>/specification_page4.png
         <output folder>/specification_page9.png

كيف أحافظ على صغر المجموعة؟

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

الاستخدامات النموذجية

  • تقارير الأخطاء. صفحة الدليل أو الفاتورة التي تُظهر المشكلة.
  • مراجعات المستندات. صورة واحدة لكل صفحة تم تعديلها في ملاحظات المراجعة.
  • الشرائح. صورة للمخطط الواحد الذي تريد، دون إعادة تنسيقه.

حدود صادقة

  • وضع التقييم. الصفحات المصورة تحمل علامة مائية للتقييم، وتفتح عملية الخادم ما لا يزيد عن 15 مستندًا. إذا خرجت الصور من فريقك، اسأل أولًا “هل خادم المشاهد مرخص؟” حتى يستدعي الوكيل get_license_status.
  • صفحة واحدة لكل استدعاء. لا توجد أداة متعددة الصفحات. الدفعة هي سلسلة من الاستدعاءات.
  • PNG فقط. الصيغة ثابتة؛ الدقة ليست معلمة يمكنك ضبطها عبر الأداة.
  • رقم صفحة خاطئ لا يزال ينتج صورة. الملف المسمى _page12.png هو الصفحة 12 فقط إذا كان المستند يحتوي على 12 صفحة. تحقق من العدد أولًا.

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

كيف أحول صفحة PDF إلى صورة باستخدام وكيل ذكاء اصطناعي؟ اربط خادم GroupDocs.Viewer.Mcp بعميلك واطلب الصفحة برقمها. يستدعي الوكيل render_page وتُحفظ صورة PNG في مجلد الإخراج باسم <name>_page<N>.png.

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

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

تعمق أكثر