عندما يكون المستند كبيرًا جدًا بالنسبة لنافذة السياق، قم بتحويل الجزء الذي تحتاجه فقط. يتيح GroupDocs.Markdown.Mcp للوكيل الذكي تحويل الصفحات أو أوراق العمل المحددة إلى Markdown محليًا، من Claude Desktop، Claude Code، Cursor أو GitHub Copilot، بحيث يقرأ نموذج اللغة الكبيرة فصلًا واحدًا وليس الكتاب بأكمله:
Convert pages 40 to 52 of handbook.pdf to Markdown.
الإصدار خطوة بخطوة مع الإعدادات واستكشاف الأخطاء موجود في الوثائق: كيفية تحويل جزء واحد فقط من مستند إلى Markdown.
ما الذي توفره التحويل المحدد النطاق؟
كل كلمة تضعها في الموجه تُقرأ، وتُفوتر من قبل مزود النموذج وتتنافس على الانتباه مع كل كلمة أخرى. معظم الأسئلة حول مستند طويل تتعلق بجزء صغير منه. تحويل كل شيء أولاً، ثم طلب من النموذج تجاهل معظم المحتوى، يعني أنك تدفع مقابل المستند بالكامل في كل سؤال.
التوفير سهل القياس على مستند تملكه. إليك قياس حقيقي واحد، مع طريقة القياس موضحة. الملف هو مصدر Markdown لصفحة الترخيص الخاصة بهذا الخادم في الوثائق. قمنا بتقسيمه بعد الـ front matter وعددنا الكلمات المفصولة بمسافات، وكتل الشيفرة، وعلامات Hugo shortcode المتضمنة (الصفحة بالكامل تحتوي على 810 كلمة بدون الـ shortcodes). الجدول يوضح النسبة بين قسم والصفحة؛ وهو ليس نتيجة مقاسة لخيار pages، الذي يختار الصفحات وليس العناوين:
| قسم الصفحة | كلمات |
|---|---|
| المقدمة والأنماط الثلاثة للترخيص | 167 |
| قيود وضع التقييم | 93 |
| تطبيق الترخيص | 78 |
| الترخيص القائم على العداد (الدفع حسب الاستخدام) | 366 |
| تأكيد أي وضع نشط | 113 |
| الحصول على ترخيص | 27 |
| الصفحة كاملة | 844 |
سؤال حول أي وضع ترخيص نشط يحتاج فقط إلى القسم المكوّن من 113 كلمة. هذا يمثل حوالي 13 ٪ من الصفحة، أو ما يقرب من 7.5 مرة أقصر من الكل. العدّ يتم بالكلمات لأن الرموز (tokens) تعتمد على محلل النموذج؛ عدد الرموز يتحرك مع عدد الكلمات، ولم نضع رقم رموز هنا لم نقم بقياسه. الصفحة قصيرة عن قصد. دليل الاستخدام الخاص بك سيكون أكبر، والنسبة لك لتحديدها.
الطريقة 1: ما الصفحات التي يمكنني تسميتها مباشرة؟
إذا كنت تعرف الصفحات، فأخبرنا بذلك. المتغيّر pages في convert_to_markdown يأخذ قائمة مفصولة بفواصل من أرقام تبدأ من 1، مثل "40,41,42". لا توجد صيغة نطاق في المعامل؛ الوكيل يوسّع “40 إلى 52” إلى القائمة لك. إذا تركت pages فارغًا، سيتم تحويل المستند بالكامل.
Convert pages 40 to 52 of handbook.pdf to Markdown.
النتيجة هي ملف .md محفوظ والمحتوى يُعاد داخل السطر. الإخراج الطويل يُقَصّ داخل السطر، والملف المحفوظ يحتوي على النص الكامل.
الطريقة 2: كيف أحول الفصل 3 فقط؟
الأداة لا تملك خيارًا يحدّد العناوين، لذا يجب تحويل “الفصل 3” إلى أرقام صفحات أولًا. قم بذلك في خطوتين صغيرتين:
كم عدد صفحات handbook.pdf وما هو عنوانه؟
get_document_info يجيب من الملف دون تحويله: pageCount، title، author، fileFormat و isEncrypted. كما يخبرك مبكرًا إذا كانت كلمة مرور مطلوبة. بعد ذلك، حوّل صفحات جدول المحتويات، اقرأها، واطلب النطاق الذي تُحدده.
مثال جلسة (مختصر):
You: How many pages does handbook.pdf have, and what is its title?
Agent: get_document_info -> pageCount: 212, title: "Operations Handbook".
You: Convert pages 3 to 4 (the table of contents), then convert chapter 3.
Agent: convert_to_markdown (pages: "3,4") -> contents read: chapter 3 runs pages 61 to 64.
convert_to_markdown (pages: "61,62,63,64") -> saved chapter 3 as Markdown.
تحويلان صغيران يحلان محل تحويل واحد ضخم.
الطريقة 3: كيف آخذ ورقة عمل واحدة من مصنف؟
في ملفات XLSX، XLS و ODS الأرقام تختار أوراق العمل، وليس الصفحات المطبوعة:
تحويل ورقة العمل 2 من النموذج إلى Markdown.
هذا يضع جدولًا واحدًا في المستند دون الأوراق الأخرى الموجودة في نفس المصنف.
متى يكون التحويل المحدد النطاق يستحق الخطوة الإضافية؟
- السياق. يحصل نموذج اللغة الكبيرة على الجزء الذي يجيب على السؤال، وتبقى المستندات الطويلة داخل النافذة.
- تكلفة الاستخدام القائم على العداد. تحت الترخيص القائم على العداد تُفوتر فقط ما تعالجه، لذا عدد أقل من الصفحات يعني فاتورة أقل.
- جودة الاسترجاع. الفهرس الذي يحتوي على الملحق ذي الصلة لا يُخفّف بوجود باقي الكتالوج في كل استعلام.
إذا كان المستند بالكامل هو المطلوب، لا تقم بتحديد النطاق. حوّله مرة واحدة واحتفظ بـ Markdown.
حدود صادقة: الصفحات في وضع التقييم
بدون ترخيص يعمل الخادم في وضع التقييم: تُعالج فقط الصفحات الثلاث الأولى، مع علامة مائية للتقييم على كل منها. هذا يتجاوز pages. طلب الصفحات من 40 إلى 52 في وضع التقييم يُعيد الصفحات 1 إلى 3 دون خطأ، لذا لا يمكن اختبار فصل من وسط كتاب بدون ترخيص. إذا لم يبدأ الإخراج من حيث توقعت، استدعِ get_license_status أولًا.
يمكن لجدول المحتويات أن يستخدم تسميات الصفحات المطبوعة. إذا لم تبدأ الصفحات المحوّلة عند العنوان المتوقع، اطلب من الوكيل تحويل الصفحات المجاورة وتعديل القائمة؛ get_document_info يعطي العدد الكلي للصفحات، وهو ما يحدّ القائمة.
الأسئلة المتكررة
كيف أحول الفصل 3 فقط إلى Markdown؟
اعثر أولًا على أرقام صفحات الفصل، ثم مرّرها في pages. اطلب من الوكيل تحويل صفحات جدول المحتويات، اقرأها، واطلب النطاق الذي تُحدده.
ماذا أفعل عندما يكون المستند كبيرًا جدًا بالنسبة لنافذة السياق؟
حوّل جزءًا من المستند، لا كله. استخدم pages لاختيار الصفحات أو أوراق العمل التي تجيب على سؤالك، وتحقق من عدد الصفحات باستخدام get_document_info قبل البدء.
هل يمكنني تحويل صفحات PDF من 10 إلى 20 إلى Markdown باستخدام الذكاء الاصطناعي؟
نعم. اسأل بلغة بسيطة، “Convert pages 10 to 20 of report.pdf to Markdown”، وسيُرسل الوكيل القائمة الموسعة لأرقام الصفحات. بدون ترخيص، تُعالج فقط الصفحات الثلاث الأولى.
تعمق أكثر
- الوثائق، الطريقة الرسمية: كيفية تحويل جزء واحد فقط من مستند إلى Markdown
- محور الوثائق: GroupDocs.Markdown MCP Server
- ابدأ هنا: يبدأ خط أنابيب RAG الخاص بك بـ Markdown — احتفظ بهذه الخطوة محليًا
- متعلق: أتمتة ترحيل المستندات ككود: الوكيل يقوم بالتحويل، أنت تراجع
- متعلق: من المستندات إلى موقع ثابت: Hugo أو Docusaurus أو MkDocs عبر وكيل ذكاء اصطناعي
- النموذج المحلي وأمان: 3 بنى لمعالجة المستندات بالذكاء الاصطناعي، والواحدة التي تحتفظ بالملفات داخل شبكتك
- الأسئلة: منتدى GroupDocs Markdown
- المصدر: GroupDocs.Markdown.Mcp على GitHub