لتحرير خصائص المستندات بشكل جماعي، قدم للوكيل الذكي معيارًا ومجلدًا، ودعه يقرأ ويكتب ويتحقق عبر GroupDocs.Metadata.Mcp الذي يعمل محليًا. يكفي طلب واحد للبدء:

لكل مستند في مجلدي، اضبط Company إلى “Acme Ltd” و Author إلى “Research Team”، ثم أخبرني أي الملفات تم تعديلها.

الإصدار خطوة بخطوة مع الإعدادات واستكشاف الأخطاء موجود في الوثائق: How to correct document properties in bulk with an AI agent.

لماذا تنحرف معايير البيانات الوصفية في المقام الأول؟

القوالب تترك اسم الشركة السابقة في كل ملف جديد. إعادة تسمية الفريق تترك الاسم القديم في حقل المؤلف. عملية الترحيل تترك طوابع زمنية لا معنى لها. لا أحد يحرر الخصائص يدويًا عبر 200 ملف، لذا يبقى الانحراف. وكيل مع حلقة هو الأداة المناسبة لذلك، ولكن فقط إذا تم التعديل بواسطة محرك: نموذج لغة يقوم بـ “إعادة كتابة” المستند لتغيير المؤلف يعيد توليد المحتوى، بينما write_metadata يغيّر حقلًا واحدًا ويترك النص كما هو.

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

يتكون سير العمل من أربع خطوات، ولكل خطوة طلب واحد. نفّذها في Claude Desktop أو Claude Code أو Cursor أو GitHub Copilot أو أي عميل آخر لديه الخادم مسجلاً.

  1. تحقق من الترخيص. اسأل: “ما هو حالة ترخيص خادم البيانات الوصفية؟” الوكيل يستدعي get_license_status. قم بذلك قبل تشغيل جماعي، وليس بعد.
  2. قراءة القيم الحالية. اسأل: “أولاً قوّم المؤلف والشركة الحاليين لكل ملف.” الوكيل يستدعي search_metadata مع nameContains، والذي يُرجع فقط الخصائص المطابقة.
  3. اكتب فقط ما هو خاطئ. اسأل: “غيّر فقط ما هو خاطئ.” الوكيل يستدعي write_metadata لكل ملف ولكل خاصية.
  4. تحقق. اسأل: “اقرأ المؤلف والشركة مرة أخرى في الملفات الجديدة وقم بإدراج أي منها لا يزال مختلفًا، مع السبب.” اطلب الفشل كقائمة بدلاً من عدد.

من يقرر ماذا: الوكيل أم المحرك؟

القرار من يقرر
أي الملفات ضمن النطاق، وأي القيم خاطئة الوكيل، وفقًا لمعيارك
أي اسم خاصية يطابق أي حقل في PDF أو DOCX أو JPEG المحرك: write_metadata يطابق الاسم الودي حسب التنسيق
ما إذا كانت الخاصية موجودة في تنسيق معين المحرك: عملية كتابة لا تنطبق تُبلغ عن 0 تغيّر أو تفشل برسالة، ولا نجاح صامت أبداً
ما تم حفظه وأين الأداة: تُعيد رسالة مسار الحفظ وعدد الحقول التي تم تعديلها
ما إذا كانت الحالة النهائية تطابق المعيار الوكيل، عبر القراءة مرة أخرى

write_metadata يقبل property كواحد من Author, Title, Subject, Keywords, Comments, Copyright, Company أو Manager. mode هو set (استبدال، الافتراضي) أو add (إضافة، للحقول القائمة مثل Keywords).

ما هي القاعدة التي تحافظ على كل تعديل؟

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

طبق التغيير الثاني على الملف الناتج من الأول، وليس على الأصل.

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

You:    Set Company to "Acme Ltd" on every .docx in the folder. List current values first.
Agent:  [calls search_metadata: nameContains = "Company", per file]
Agent:  proposal-q1.docx   Company = "Contoso GmbH"   -> will change
        handbook.docx      Company = "Acme Ltd"       -> already correct
        notes.docx         (no Company property)      -> will add
You:    Go ahead. Name each file you produced.
Agent:  [calls write_metadata: property = Company, value = "Acme Ltd", mode = set]
Agent:  2 files changed, 1 unchanged. Each saved copy is named in the tool reply.

هذه توضيح للتدفق، وليس لقطة شاشة مسجلة.

لماذا لا يتم إصلاح المجلد بالكامل في خطوة واحدة؟

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

التنسيقات تختلف. الخاصية التي لا يوجد لها مكان في تنسيق ما تُبلغ عنها كـ 0 تغيّر أو تفشل برسالة بدلاً من التظاهر بالنجاح، وهذا السلوك الصحيح لكنه يعني أن مجلدًا مختلطًا قد يعطي نتيجة جزئية. اطلب الفشل كقائمة.

ما هي الحدود في وضع التقييم؟

في وضع التقييم يمكن قراءة أول 5 خصائص للمستند فقط، وXMP وEXIF غير متاحين جزئيًا. الكتابة محدودة بنفس الطريقة. سير عمل “تحقق، ثم اكتب” في وضع التقييم يتحقق من قائمة مختصرة، لذا قد يفوت الخاصية التي تحاول تصحيحها. أكد باستخدام get_license_status وطبق ملف ترخيص أو مفاتيح مقاسة قبل الاعتماد على النتيجة. ترخيص مؤقت مجاني لمدة 30 يومًا متاح.

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

هل يمكنني تغيير المؤلف في 100 مستند Word مرة واحدة؟
نعم، باستخدام طلب يحدد المجلد والقيمة. الوكيل يقوم باستدعاء write_metadata واحد لكل ملف للخاصية Author، لذا 100 ملف يعني 100 استدعاء كتابة.

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

هل يمكن للوكيل ضبط خاصية مخصصة غير موجودة في القائمة؟
القيم الموثقة للخاصية property هي Author, Title, Subject, Keywords, Comments, Copyright, Company و Manager. أي شيء آخر خارج ما تصفه الأداة.

تعمق أكثر