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

في ملف budget.xlsx، في ورقة العمل 2 (Q3)، اضبط قيمة السفر إلى 12,500 وأعد تسمية التدريب إلى “Training (external)”. اترك الأوراق الأخرى كما هي.

الإصدار خطوة بخطوة موجود في الوثائق: كيفية تحرير ورقة عمل أو شريحة واحدة وإعادتها إلى الأصل.

لماذا لا نسلم الوكيل الملف بالكامل؟

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

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

الرحلة ذهابًا وإيابًا

budget.xlsx  (3 worksheets: Summary, Q3, Q4)
   |-- extract_html {"file":{...},"worksheet":2} --> budget_worksheet2.html
   |        agent edits the HTML: Travel 9000 -> 12500,
   |        "Training" -> "Training (external)"
   '-- save_from_html {"htmlFile":{"filePath":"budget_worksheet2.html"},
                       "format":"xlsx",
                       "sourceFile":{"filePath":"budget.xlsx"},
                       "worksheet":2}
         --> budget-q3-revised.xlsx : worksheet 2 replaced, 1 and 3 untouched
evaluation mode: worksheets/slides 1-2 can be edited; the server refuses 3+

ما أعاده الخادم

تم التقاطه من GroupDocs.Editor.Mcp 26.10.0 ضد ميزانية اصطناعية:

-> extract_html {"file":{"filePath":"budget.xlsx"},"worksheet":2}
<- Extracted worksheet 2 of 3 of 'budget.xlsx' as editable HTML
   Saved to: …/budget_worksheet2.html
   Next: edit the saved .html and call save_from_html to write it back
   as DOCX, XLSX, PPTX, PDF or another format.
   Preview (plain text): ... Cost centre Planned (EUR) Owner Hosting
   57600 IT Support 14400 IT Travel 9000 Sales Training 6000 HR

-> save_from_html {"htmlFile":{"filePath":"budget_worksheet2.html"},
     "format":"xlsx","sourceFile":{"filePath":"budget.xlsx"},
     "worksheet":2,"outputName":"budget-q3-revised.xlsx"}
<- Saved 'budget_worksheet2.html' into a copy of 'budget.xlsx',
   replacing worksheet 2 of 3 (XLSX)
   Saved to: …/budget-q3-revised.xlsx

فتح النتيجة يؤكد النطاق: في Q3، السفر أصبح 12500 والصف يقرأ “Training (external)"؛ الاستضافة والدعم لم يتغيرا؛ ملخص و Q4 كما كانا. لم يتم تعديل ملف budget.xlsx الأصلي.

الأدوات تتعامل مع أوراق العمل والشرائح حسب الرقم، لا حسب الاسم؛ get_document_info يُعيد عدد الأوراق، وهذا هو السبب في أن الموجه يقول “worksheet 2 (Q3)”. استجابة الاستخراج تتضمن معاينة نصية بسيطة، بحيث يمكن للوكيل التحقق من أنه يمتلك الورقة الصحيحة قبل أن يجرى أي تعديل، وتحتوي على سطر “Next:” يوضح أي استدعاء يأتي بعده. يتبع الوكلاء هذه الإشارات جيدًا. بالنسبة للشريحة، قد تبدأ المعاينة بنص العنصر النائب للماستر (“Click to edit Master title style”)، لذا يجب على الوكيل فحص الـ HTML نفسه.

الشرائح، والقاعدة الوحيدة للعروض التقديمية

نفس الزوج يعمل على مجموعة شرائح: extract_html مع "slide": 2، تعديل، ثم save_from_html مع "slide": 2 والمستند الأصلي كـ sourceFile. في تجربتنا، خرجت الشريحة 2 من مجموعة مراجعة مكوّنة من ثلاث شرائح كـ HTML، تحولت “12 percent” إلى “14 percent”، وعادت كملف review-revised.pptx مع الحفاظ على الشرائح 1 و 3.

بالنسبة إلى PowerPoint، يكون sourceFile غير اختياري. HTML وحده لا يحمل ماستر الشريحة، والخادم يوضح ذلك بدلاً من إنتاج مجموعة مكسورة:

-> save_from_html {"htmlFile":{"filePath":"review_slide2.html"},
                   "format":"pptx"}
<- Save from HTML failed for 'review_slide2.html' (-> pptx): 'pptx' output
   cannot be created from HTML alone; pass the original document as
   'sourceFile'.

الرسالة تسمي الوسيط المفقود، فيقوم الوكيل بتصحيح الاستدعاء بنفسه.

عندما تتفوق الرحلة ذهابًا وإيابًا على البحث والاستبدال

replace_text هو المسار الأقصر لكلمة أو اسم. الرحلة ذهابًا وإيابًا مخصصة لكل ما هو آخر: تعديل عدة خلايا مرة واحدة، إعادة صياغة تسمية ورقم معًا، إعادة هيكلة جدول في شريحة، أو عبارة لا يستطيع replace_text رؤيتها لأنها مقسمة عبر تشغيلين تنسيقيين. كما أنها الطريقة التي يقرأ بها الوكيل جزءًا قبل أن يقرر ما سيعدله.

القراءة قبل الكتابة

النصف الأول من الرحلة ذهابًا وإيابًا مفيد بحد ذاته. يمكن لوكيل يُسأل “ما المخطط للسفر في Q3، ومن المسؤول عنه؟” استخراج ورقة Q3 والإجابة من الـ HTML دون لمس أي شيء، ويجب على الوكيل الذي سيقوم بالتعديل أن يفعل ذلك أولًا: يقرأ الجزء، يذكر التغيير الذي ينوي إجراؤه، ثم يكتب. ضع هذا الترتيب في تعليمات مشروعك ليصبح الافتراضي:

To change a worksheet or slide, use the groupdocs-editor MCP server:
extract_html for that one part, edit the HTML, save_from_html with the
original as sourceFile and the same worksheet/slide number. Never rebuild
the whole workbook or deck. Say which cells or text you changed.

السطر الأخير هو الأهم. “قمت بتغيير Travel من 9000 إلى 12500 وأعدت تسمية Training في Q3” هو رد يمكن للمراجِع التحقق منه مقابل الملف في ثوانٍ.

حدود صريحة

  • وضع التقييم يسمح بتعديل أول ورقتين عمل أو شريحتين فقط، ويُرفض تعديل الثالثة مع توضيح السبب: “Evaluation mode edits only the first 2 visible worksheets of a workbook; worksheet 3 is beyond them.”
  • عمليات الحفظ غير المرخصة تكون مسودات: تُضاف صف بانر في أعلى الورقة المعدلة وتُضاف ورقة “Evaluation Warning” إلى المصنف.
  • الـ HTML المستخرج من تشغيل غير مرخص يبدأ بنفس سطر التقييم (المعاينة أعلاه تُظهره)، لذا يجب على الوكيل تعديل الخلايا، وليس ذلك السطر.
  • أرقام الأوراق والشرائح تبدأ من 1، وتُحسب المخفية أيضًا. الشريحة المخفية تحتاج showHidden: true؛ الورقة المخفية تُرفض مهما كان قيمة showHidden، لذا يجب إظهارها في المصنف أولًا.

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

هل تعديل ورقة واحدة يغيّر الأخرى؟
لا. الـ HTML المعدل يستبدل فقط الورقة التي تحددها، في نسخة من الأصل؛ البقية تُنقل من الملف المصدر.

هل يمكنني فعل ذلك مع شرائح PowerPoint؟
نعم، باستخدام "slide" بدلًا من "worksheet"، وتمرير الأصل كـ sourceFile، وهو ما يتطلبه إخراج PowerPoint.

أين يُحفظ الناتج؟
في ملف جديد داخل مجلد التخزين، budget-q3-revised.xlsx هنا لأننا مررنا outputName؛ الأصل يبقى دون تعديل.

تعمق أكثر