ماذا تحصل عندما تستخرج التعليقات التوضيحية من ملف PDF؟

مستند مُعلَّم هو بيانات بالإضافة إلى الحبر. تُعيد أداة get_annotations كائن JSON يحتوي على found، وهو عدد التعليقات، وannotations، وهو مصفوفة. كل إدخال يحمل معرّف التعليق id، النوع type, الرسالة message, الصفحة page (مُرقَّمة من 1)، صندوق الإحاطة، المستخدم user وأي ردود replies. لا يوجد تحليل للمستند ولا OCR متضمن، لذا يعمل الوكيل مباشرةً من سجلات التعليقات التوضيحية نفسها.

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

الطريقة 1: طلب ملخص

استدعاء واحد، ثم استنتاج. اذكر اسم الملف وقل ما هو الغرض من الملخص.

لخص مراجعة contract_annotated.pdf: كم عدد التعليقات، من هم المعلقون، وما هي المواضيع الرئيسية.

يتصل الوكيل بـ get_annotations، يحسب عدد الإدخالات، يجمعها حسب user ويصف المواضيع التي يجدها في حقول message. العدد والمؤلفون مستمدون من البيانات. المواضيع هي قراءة النموذج للنص، لذا تستحق نظرة بشرية.

الطريقة 2: طلب جدول أو قائمة مُفلترة

نظرًا لأن البيانات مُهيكلة، فإن شكل التقرير يعتمد على المطالبة:

أعطني جدولًا: الصفحة، المؤلف، التعليق، تم الرد نعم/لا.

رتب التعليقات حسب المراجع وأخبرني من لديه أكبر عدد من العناصر المفتوحة.

قوِّم فقط الخطوط المشطوبة. أريد أن أرى ما يرغب الأشخاص في إزالته.

أي صفحات لا تحتوي على تعليقات على الإطلاق؟

السؤال الأخير هو سؤال يجيب عنه قارئ PDF بشكل ضعيف، بينما المصفوفة تجيب مباشرةً: “answered” هي قائمة replies غير فارغة، و"pages without comments" هي أرقام الصفحات التي لا تظهر في قيم page. يمكن دمجه مع get_document_info للحصول على عدد الصفحات.

الطريقة 3: أرشفة التعليقات كملف XML

صدّر التعليقات التوضيحية حتى نتمكن من الاحتفاظ بها مع ملف القضية.

export_annotations يكتب ملف XML يحتوي على التعليقات التوضيحية فقط. رسالة النجاح تكون على الشكل Exported N annotation(s) from <file> to <name>.annotations.xml. الملف صغير ويمكن مقارنة الفروقات، ويمكن لـ import_annotations تطبيقه على نسخة أخرى من المستند. يساعد ذلك عندما يكون المستند تحت قاعدة احتفاظ لا تشمل تعليقاته، أو عندما تريد مقارنة جولتين من المراجعة: تصديران لنفس المستند ينتجان ملفي نص، ويمكن للوكيل وصف ما تغير بينهما.

جلسة مثال (مختصرة)

هذا توضيح مبني على سلوك الأدوات الموثَّق، وليس لقطة شاشة مسجلة.

You:   Summarize the review of contract_annotated.pdf and group it by reviewer.

Agent: [calls get_annotations on contract_annotated.pdf]
       Found 5 annotations: 4 from Maria, 1 from Dana.
       Maria: payment terms (page 2), delivery date (page 5),
         liability cap (page 6), a missing signature block (page 6).
       Replies: Alex answered the page 2 payment terms comment.
       Dana: a strikeout on page 4 marking an outdated clause.
       Maria comments without a reply: page 5 and the two on page 6.

هل يمكن للوكيل اتخاذ إجراءات بناءً على التعليقات؟

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

كيف أشغّل الخادم لـ Claude أو Cursor أو Copilot؟

يعمل الخادم من صورة Docker ghcr.io/groupdocs-annotation/annotation-net-mcp أو من NuGet باستخدام dnx GroupDocs.Annotation.Mcp --yes (.NET 10 SDK)، ويُركّب المجلد الذي يحتوي على مستنداتك. صفحة المركز تُدرج التسجيل لـ Claude Desktop، Claude Code، VS Code مع GitHub Copilot، Cursor، Windsurf وغيرها من العملاء.

حدود صادقة

  • وضع التقييم. تُطبع شارة تجريبية في أعلى كل صفحة. لا تُغيّر بيانات التعليقات التوضيحية، لذا فإن التقارير المُنشأة بهذه الطريقة دقيقة دون ترخيص. تؤثر على ما يمكنك إرساله لاحقًا. إذا انتهت الخطة بعبارة “email the marked-up copy”، تحقق أولًا من get_license_status.
  • مستند واحد لكل استدعاء. مسح عدة ملفات يعني عدة استدعاءات، وكل استدعاء هو نداء أداة يجب على الوكيل إجراؤه والإبلاغ عنه.
  • التصدير بصيغة XML. get_annotations تُعيد JSON للوكيل لقراءته؛ export_annotations يكتب XML إلى التخزين.
  • لا حاجة للمعاينة. لا تُظهر أي من الطرق الثلاث صفحة، لذا فإن حد معاينة PDF في generate_pages_preview على Linux لا يؤثر عليها.

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

كيف أصدر جميع التعليقات من ملف PDF؟ اطلب من الوكيل تصدير التعليقات التوضيحية. سيتصل بـ export_annotations، الذي يكتب ملف XML بجوار مستنداتك، أو سيتصل بـ get_annotations إذا أردت قائمة التعليقات في الدردشة.

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

هل يتغير التقرير إذا لم يكن لدي ترخيص؟ بيانات التعليقات التوضيحية لا تتغير. فقط الصفحات المُعالجة أو المُحفظة تحمل شارة تجريبية.

تعمّق أكثر