نموذج Word يحتوي على صناديق نصية، قائمة منسدلة للقسم، ومربع اختيار لمدونة السلوك، بالإضافة إلى جدول بيانات يضم ثلاثين موظفًا جديدًا: هذا يمثل صباحًا من النسخ واللصق، أو طلبًا واحدًا. مع تشغيل خادم GroupDocs.Editor MCP محليًا، يطلب Claude أو Cursor أو Copilot أولاً من النموذج الحقول التي يحتويها، ثم يملأ نسخة واحدة لكل صف ويحفظ كل نسخة باسم الشخص. يبقى تخطيط النموذج دون تغيير، وأي قيمة لا يوجد لها حقل مطابق يتم الإبلاغ عنها بدلاً من إهمالها صامتًا:

اقرأ new-employee-form.docx، ثم املأ نسخة واحدة لكل صف من new‑hires.csv وسمِّ كل ملف باسم الموظف.

الإصدار خطوة بخطوة موجود في الوثائق: كيفية ملء حقول نموذج Word من البيانات باستخدام وكيل ذكاء اصطناعي.

من يقرأ جدول البيانات؟

الوكيل هو من يقرأه، ومن المهم أن نكون صريحين حيال ذلك. يعمل خادم Editor على نموذج Word؛ لا يقرأ ملف CSV أو المصنف الخاص بك. يقرأ الوكيل الصفوف بأدواته الخاصة للملفات، أو تقوم أنت بلصقها، ثم يقوم بإنشاء استدعاء fill_form_fields واحد لكل صف مع outputName لكل شخص. هذا الفصل هو ميزة: لا تحتاج البيانات أبدًا إلى أن تكون بتنسيق يفهمه الخادم، ويمكن للوكيل تنظيفها أثناء الطريق (تقسيم الاسم الكامل، توحيد التاريخ) قبل أن تدخل النموذج.

اسأل النموذج أولاً

أسماء الحقول في نماذج Word نادرًا ما تكون هي نفسها النص الظاهر على الصفحة. النص يقرأ “Full name:"، بينما قد يُسمى الحقل FullName أو Text1 أو Name_Employee. التخمين هو ما يجعل النماذج تعود نصف فارغة. تُعيد get_form_fields الأسماء الحقيقية، الأنواع والقيم الحالية. تم التقاطها من GroupDocs.Editor.Mcp 26.10.0 ضد نموذج توظيف اصطناعي (تم تقصير المخرجات):

-> get_form_fields {"file":{"filePath":"new-employee-form.docx"}}
<- { "count": 6, "fields": [
     { "name": "FullName",   "type": "Text",     "value": "" },
     { "name": "Email",      "type": "Text",     "value": "" },
     { "name": "StartDate",  "type": "Text",     "value": "" },
     { "name": "Department", "type": "DropDown",
       "value": { "options": [ "Engineering", "Finance", "Sales",
                               "Operations" ], "selected": "Engineering" } },
     { "name": "Agree",      "type": "CheckBox", "value": false },
     { "name": "Newsletter", "type": "CheckBox", "value": false } ] }

تأتي القائمة المنسدلة مع خياراتها، لذا يمكن للوكيل ربط “finance” في جدول البيانات بالمدخل الدقيق “Finance” بدلاً من اختراع قسم سادس.

ثم ملء صف واحد

-> fill_form_fields {"file":{"filePath":"new-employee-form.docx"},
     "values":{"FullName":"Amara Okafor",
               "Email":"amara.okafor@northwind.example",
               "StartDate":"2026-12-01","Department":"Finance",
               "Agree":"true","Phone":"+31 10 555 0100"}}
<- Updated 5 field(s) in 'new-employee-form.docx': FullName, Email,
   StartDate, Department, Agree.
   Not found: Phone. Call get_form_fields for the exact names.
   Saved to: …/new-employee-form_edited.docx

كان لجدول البيانات عمود هاتف لا يمتلك النموذج حقلًا مقابلاً له. قام الخادم بملء الحقول الخمسة الموجودة وسمي الحقل غير الموجود. قراءة النسخة المملوءة مرة أخرى باستخدام get_form_fields تُظهر القيم في موضعها، بما في ذلك "selected": "Finance" و "Agree": true، ولا يزال Newsletter غير محدد لأن الصف لم يذكر غير ذلك.

الدفعة الكاملة

new-hires.csv (agent reads it)          new-employee-form.docx
  Amara Okafor, Finance, ...  ---+
  Tomas Varga, Sales, ...     ---+      get_form_fields (once)
  ...                            |        -> FullName, Email, StartDate,
                                 |           Department, Agree, ...
                                 v
  fill_form_fields {"values":{...row...},
                    "outputName":"form-amara-okafor.docx"}   x one per row
     -> "Updated 5 field(s) ... Not found: Phone"
     -> form-amara-okafor.docx, form-tomas-varga.docx, ...

ثلاث تعليمات تجعل الدفعة موثوقة: استدعِ get_form_fields مرة واحدة واربط الأعمدة بأسماء الحقول قبل أول ملء؛ أعطِ كل صف outputName خاصًا به، وإلا ستتراكم النسخ كـ new-employee-form_edited.docx، new-employee-form_edited (1).docx وهكذا، دون اسم أي شخص؛ وجمع سطور “Not found” في تقرير واحد في النهاية بدلاً من التوقف عند الأولى.

طلب يعمل على الصف الأول

معظم فشل الدفعات يحدث في الصف الأول ثم يتكرر ثلاثين مرة. اطلب تشغيلًا تجريبيًا أولًا:

اقرأ حقول new‑employee‑form.docx ورأسية new‑hires.csv. أرني أي عمود يذهب إلى أي حقل، وأي أعمدة لا تمتلك حقلًا. ثم املأ الصف الأول فقط وتوقف.

يجيب الوكيل بجدول ربط صغير، Name -> FullName، Dept -> Department، Phone -> (no field)، ويقدم نموذجًا مملوءًا يمكنك فتحه. إذا كان تهجئة القسم أو تنسيق التاريخ خاطئًا، تراه مرة واحدة، تصلح التعليمات، ثم تطلب البقية. هذه خطوة المراجعة تكلف دقيقة واحدة وتُحدث الفارق بين ثلاثين نموذجًا صحيحًا وثلاثين نموذجًا يحتاج إلى تدقيق يدوي.

كما يوضح الأسئلة التي لا يستطيع جدول البيانات الإجابة عنها بنفسه. هل يجب أن يعني الخلية الفارغة في “Agree” عدم تحديد المربع، أم يجب تخطي الصف؟ هل يُدخل “2026-12-01” في حقل التاريخ كما هو مكتوب، أم كـ “1 ديسمبر 2026”؟ سيتبع الوكيل ما تقوله، لكن يجب إبلاغه بذلك.

ما الذي تتعامل معه أدوات النموذج أيضًا

يتم ملء حقول النص والرقم والتاريخ بسلاسل؛ تأخذ مربعات الاختيار "true" أو "false"؛ وتختار القوائم المنسدلة أحد خياراتها. format يحفظ النسخة المملوءة كـ DOC أو RTF أو ODT بدلاً من DOCX؛ النموذج المملوء هو دائمًا مستند Word، لذا فإن PDF للموظف الجديد يكون تحويلًا منفصلًا لاحقًا. يُفتح النموذج المحمي بكلمة مرور باستخدام password ويظل محميًا. تُكتب النسخة المملوءة بواسطة محرك حقول النموذج وليس عبر HTML، لذا تُحافظ رؤوس وتذييلات الصفحات وأرقام الصفحات على ما كانت عليه. تدعم الأدوات نماذج DOCX، DOC، DOCM، DOT، DOTX، RTF و ODT.

حدود صريحة

  • نماذج Word فقط، وحقول النماذج القديمة فقط: الحقول النصية، مربعات الاختيار والقوائم المنسدلة التي يضيفها Word من Developer → Legacy Tools. لا تُدرج أو تُملأ عناصر التحكم بالمحتوى. نماذج PDF (AcroForms) ليست ضمن نطاق هذا الخادم.
  • الخادم لا يقرأ جدول البيانات؛ الوكيل يزود القيم، لذا تحقق من ربط الأعمدة في الصف الأول قبل السماح له بالمعالجة عبر جميع الصفوف.
  • استدعاء واحد يملأ نموذجًا واحدًا. دفعة من ثلاثين استدعاءً تعني ثلاثين نموذجًا.
  • وضع التقييم يضيف سطر بانر في أعلى كل نسخة مملوءة، لذا فإن المخرجات غير المرخصة تكون مسودة، ليست شيئًا يُرسل إلى الموظفين الجدد.

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

كيف يعرف الوكيل أسماء الحقول؟
يسأل: get_form_fields تُعيد اسم كل حقل، نوعه والقيمة الحالية، بالإضافة إلى خيارات كل قائمة منسدلة.

ماذا يحدث للقيمة التي لا يمتلك النموذج حقلًا لها؟
يتم تخطيها وتُذكر في الاستجابة (“Not found: Phone”)، حتى يتمكن الوكيل من الإبلاغ عنها.

هل يتغير النموذج الأصلي؟
لا. كل عملية ملء تُكتب في ملف جديد؛ يبقى القالب فارغًا للصف التالي.

تعمق أكثر