إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
ملحوظة
الميزات في هذا المقال مدعومة بالحزام القياسي، الذي يستخدم خيارات الفوترة الموضحة في الترخيص للوكلاء المدعومين بالحزام القياسي. تعلم كيفية الوصول إلى الميزات القياسية في وكلاء Access القياسيين وتدفقات الوكلاء.
Important
هذه ميزة إصدار أولي.
- Microsoft إصدارات ميزات المعاينة قبل إصدار رسمي بحيث يمكن للعملاء الوصول المبكر وتقديم الملاحظات.
- تحتوي ميزات المعاينة على وظائف مقيدة ولا يقصد بها استخدام الإنتاج.
- قد تُجري مايكروسوفت تغييرات على أسماء ومعلمات أدوات المعاينة MCP. تجنب التبعيات المشفرة. يحتفظ Microsoft بدعم السيناريو.
- تخضع ميزات المعاينة لشروط الاستخدام الإضافية Microsoft.
نظرة عامة
| مُعرف خادم | عنوان URL على مستوى المستأجر | اسم العرض | الوصف |
|---|---|---|---|
mcp_WordServer |
https://agent365.svc.cloud.microsoft/agents/tenants/{tenantId}/servers/mcp_WordServer |
كلمة | أدوات للعمل مع مستندات Microsoft Word |
الأدوات المتوفرة
WordCreateNewDocument
إنشاء مستند Word جديد في جذر OneDrive المستخدم. قم بتوفير اسم الملف المطلوب (يمكن أن يكون فارغا) ومحتوى HTML أو نص عادي لملء نص المستند الأساسي. إذا fileName كان فارغا، يتم توليد اسم مثل Document_yyyyMMdd_HHmms.docx . إرجاع DriveItem JSON الذي تم إنشاؤه من Microsoft Graph.
المعلمات المطلوبة:
- اسم الملف: اسم الملف المطلوب (يمكن أن يكون فارغا للاسم المولد تلقائيا)
- contentInHtml: محتوى HTML أو نص عادي لنص المستند الأساسي
WordGetDocumentContent
يجلب المحتوى الخام لمستند Word (DOCX) من OneDrive أو SharePoint باستخدام عنوان URL لمشاركة SharePoint. يعيد حمولة JSON تحتوي على اسم الملف، الحجم، driveId، ، documentIdمحتوى النص العادي، وجميع التعليقات في ذلك المستند. يجب أن يكون الإدخال رابط المشاركة (عنوان URL لـ SharePoint أو OneDrive).
المعلمات المطلوبة:
- url: عنوان URL لمشاركة SharePoint أو OneDrive للمستند
إنشاء تعليق جديد في Word
إضافة تعليق جديد في مستند Word. قدم driveId، documentId، ونص التعليق.
المعلمات المطلوبة:
- معرف محرك الأقراص: معرف محرك الأقراص للمستند
- معرف المستند: معرف المستند
- newComment: نص التعليق المراد إضافته
الرد على التعليق في وورد
الرد على تعليق في المستند Word. قدم commentId، driveId، documentId، ورسالة الرد.
المعلمات المطلوبة:
- معرف التعليق: معرف التعليق للرد عليه
- معرف محرك الأقراص: معرف محرك الأقراص للمستند
- معرف المستند: معرف المستند
- newComment: نص الرد
الميزات الأساسية
إنشاء مستند
- إنشاء مستندات Word مباشرة في OneDrive.
- دعم HTML ومحتوى النص العادي.
- أسماء الملفات التي تم إنشاؤها تلقائيا باستخدام
timestamp. - يُرجع بيانات تعريف Microsoft Graph
DriveItem.
استرداد المستند
- إحضار محتوى المستند باستخدام عناوين URL SharePoint أو OneDrive.
- استخراج محتوى النص العادي من ملفات DOCX.
- استرجاع جميع تعليقات المستند.
- احصل على بيانات تعريف المستند، مثل اسم الملف وحجمه ومعرفاته.
إدارة التعليقات
- إضافة تعليقات جديدة إلى المستندات.
- الرد على التعليقات الموجودة.
- دعم كامل لسلسلة التعليقات.
الملاحظات
- إنشاء مستندات في المجلد الجذر في OneDrive الخاص بالمستخدم.
- استخدم عناوين المشاركة لـ SharePoint أو OneDrive لاسترداد المستندات.
- نفذ عمليات التعليق باستخدام driveId ومن
documentIdخلال استرجاع المستندات. - دعم محتوى HTML لتنسيق المستندات الثرية.
- استخدم أسماء الملفات المولدة تلقائيا تتبع هذا التنسيق:
Document_yyyyMMdd_HHmms.docx.