إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
مهم
يجب أن تكون جزءًا من برنامج الإصدار الأولي Frontier للحصول على وصول مبكر إلى Microsoft Agent 365. يربطك Frontier مباشرةً بأحدث ابتكارات الذكاء الاصطناعي في Microsoft. تخضع الإصدارات الأولية في Frontier لشروط الإصدار الأولي الحالية لاتفاقيات العملاء. نظرًا لأن هذه الميزات لا تزال قيد التطوير، فقد يتغير توفرها وقدراتها بمرور الوقت.
نظرة عامة
| مُعرف خادم | اسم العرض | الوصف |
|---|---|---|
| mcp_SharePointListsTools | خادم MCP لقوائم Microsoft SharePoint | يوفر خادم MCP أدوات Microsoft Graph SharePoint للقوائم. يوفر خادم MCP أدوات Microsoft Graph SharePoint للقوائم. |
الأدوات المتوفرة
sharepoint_createList
إنشاء قائمة SharePoint جديدة على موقع.
معلمات مطلوبة
- siteId: المعرف الفريد للموقع
- displayName: الاسم المعروض للقائمة
- قائمة: معلومات القائمة مثل القالب (على سبيل المثال، genericList، documentLibrary، issueTracking)
sharepoint_createListColumn
إنشاء عمود جديد (columnDefinition) في قائمة SharePoint معينة. يجب توفير مُعرف الموقع الهدف ومُعرف القائمة، بالإضافة إلى تعريف عمود صالح يحدد اسم العمود والاسم المعروض ونوع عمود واحد بالضبط (مثل النص أو الرقم أو الاختيار أو التاريخ والوقت أو personOrGroup أو البحث أو القيمة المنطقية أو hyperlinkOrPicture).
المعلمات المطلوبة:
- siteId: المعرف الفريد للموقع
- listId: المُعرف الفريد للقائمة
- الاسم: API/اسم ثابت للعمود (بدون مسافات، 1-64 حرفًا)
المعلمات الاختيارية:
- displayName: الاسم المعروض المواجه للمستخدم
- الوصف: وصف العمود
- enforceUniqueValues: إذا كان صحيحًا، يجب أن تكون القيم فريدة
- مخفي: إذا كان صحيحًا، يتم إخفاء العمود
- مفهرس: إذا كان صحيحًا، تتم فهرسة القيم
- مطلوب: إذا كان صحيحًا، تكون القيمة مطلوبة
- readOnly: إذا كان صحيحًا، فلا يمكن تغيير القيم
- النص، الرقم، الاختيار، منطقي، dateTime، personOrGroup، البحث، hyperlinkOrPicture: إعدادات نوع العمود (مطلوب إعداد واحد)
sharepoint_createListItem
إنشاء مصطلح جديد في قائمة SharePoint.
المعلمات المطلوبة:
- siteId: المعرف الفريد للموقع
- listId: المُعرف الفريد للقائمة
- الحقول: قيم الحقول لعنصر القائمة (خريطة القيم/المفتاح)
sharepoint_deleteListColumn
حذف columnDefinition موجود من قائمة SharePoint معينة. توفير مُعرف الموقع ومُعرف القائمة ومُعرف العمود. يزيل هذا الإجراء العمود بشكل دائم من مخطط القائمة.
المعلمات المطلوبة:
- siteId: المُعرف الفريد للموقع
- listId: المُعرف الفريد للقائمة
- columnId: مُعرف فريد للعمود المراد حذفه
sharepoint_deleteListItem
حذف عنصر قائمة.
المعلمات المطلوبة:
- siteId: المعرف الفريد للموقع
- listId: المُعرف الفريد للقائمة
- itemId: المُعرف الفريد لعنصر القائمة
المعلمات الاختيارية:
- ifMatch: ETag اختياري للتحكم في التزامن (على سبيل المثال، "*")
sharepoint_editListColumn
تحديث columnDefinition موجود من قائمة SharePoint معينة. توفير مُعرف الموقع ومُعرف القائمة ومُعرف العمود. النص الأساسي جزئي - قم بتضمين الخصائص التي تريد تغييرها فقط (مثل displayName أو الوصف أو المخفية أو المطلوبة أو إعدادات البيانات الوصفية).
المعلمات المطلوبة:
- siteId: المُعرف الفريد للموقع
- listId: المُعرف الفريد للقائمة
- columnId: مُعرف فريد للعمود المراد تحديثه
المعلمات الاختيارية:
- displayName: الاسم المعروض المواجه للمستخدم
- الوصف: وصف العمود
- مخفي: إذا كان صحيحًا، يتم إخفاء العمود
- مطلوب: إذا كان صحيحًا، تكون القيمة مطلوبة
- enforceUniqueValues: إذا كان صحيحًا، يجب أن تكون القيم فريدة
- مفهرس: إذا كان صحيحًا، تتم فهرسة القيم
- readOnly: إذا كان صحيحًا، فلا يمكن تغيير القيم
- النص، الرقم، الاختيار، dateTime، personOrGroup، البحث، hyperlinkOrPicture: تحديث إعدادات نوع العمود
sharepoint_getSiteByPath
حل موقع SharePoint باستخدام اسم المضيف والمسار النسبي للخادم.
المعلمات المطلوبة:
- اسم المضيف: اسم المضيف لمستأجر SharePoint (على سبيل المثال، contoso.sharepoint.com)
- serverRelativePath: المسار النسبي للخادم إلى الموقع (على سبيل المثال، المواقع/التسويق)
sharepoint_listListColumns
سرد تعريفات الأعمدة (موارد columnDefinition) لقائمة SharePoint معينة. يتطلب siteId و listId. يدعم معلمات OData مثل $select $top $skiptoken.
المعلمات المطلوبة:
- siteId: المعرف الفريد للموقع
- listId: المُعرف الفريد للقائمة
المعلمات الاختيارية:
- تحديد: قائمة مفصولة بفواصل لخصائص المستخدم لإرجاعها
- عامل التصفية: تعبير عامل تصفية OData لتقييد النتائج
- orderBy: قائمة الخصائص المفصولة بفواصل للطلب حسب
- أعلى: حجم الورقة (1-999)
- skiptoken: رمز معتم للترحيل إلى المجموعة التالية
sharepoint_listListItems
سرد العناصر من قائمة SharePoint.
المعلمات المطلوبة:
- siteId: المعرف الفريد للموقع
- listId: المُعرف الفريد للقائمة
المعلمات الاختيارية:
- توسيع: توسيع OData اختياري (على سبيل المثال، الحقول)
- أعلى: حجم الورقة الاختياري
- عامل التصفية: تعبير عامل تصفية OData اختياري
- تحديد: عبارة تحديد OData اختياري
sharepoint_listLists
سرد كافة قوائم SharePoint على موقع.
المعلمات المطلوبة:
- siteId: المعرف الفريد للموقع
sharepoint_listSubsites
سرد المواقع التابعة (المواقع الفرعية) لموقع معين.
المعلمات المطلوبة:
- siteId: المعرف الفريد للموقع
sharepoint_search
البحث في SharePoint باستخدام Microsoft Graph Search API مع entityTypes=["الموقع"].
المعلمات المطلوبة:
- الطلبات: صفيف من كائنات searchRequest
المعلمات الاختيارية:
- entityTypes: يجب أن تكون ["الموقع"] لعمليات البحث في موقع SharePoint
- الاستعلام: كائن استعلام بسلسلة بحث على نمط KQL
- من: إزاحة النتيجة الأولى المستندة إلى الصفر
- الحجم: عدد النتائج التي يجب إرجاعها (1-50)
- الحقول: قائمة اختيارية بالحقول التي يجب تحديدها في الاستجابة
13. sharepoint_searchSitesByName
البحث في مواقع SharePoint حسب الاسم المعروض أو عنوان URL الجزئي (اللغة الطبيعية).
المعلمات المطلوبة:
- البحث: الاسم المعروض أو الاسم/عنوان URL الجزئي لموقع SharePoint للبحث عن
المعلمات الاختيارية:
- consistencyLevel: مطلوب من قبل Microsoft Graph (افتراضي: نهائي)
14. sharepoint_updateListItem
تحديث حقول عنصر قائمة موجود.
المعلمات المطلوبة:
- siteId: المعرف الفريد للموقع
- listId: المُعرف الفريد للقائمة
- itemId: المُعرف الفريد لعنصر القائمة
- الحقول: قيم الحقول المراد تحديثها (جزئي)
المعلمات الاختيارية:
- ifMatch: ETag اختياري للتحكم في التزامن (على سبيل المثال، "*" لفرضه)
الميزات الأساسية
إدارة القوائم
- إنشاء قوائم SharePoint جديدة باستخدام قوالب
- سرد كافة قوائم SharePoint على موقع
- دعم قوالب القوائم المختلفة (genericList، documentLibrary، issueTracking)
عمليات العمود
- إنشاء أعمدة مع أنواع بيانات متعددة (نص، رقم، اختيار، التاريخ والوقت، personOrGroup، البحث، منطقي، hyperlinkOrPicture)
- تحرير الأعمدة الموجودة
- حذف الأعمدة
- سرد كافة الأعمدة في قائمة
- قيود التحقق من صحة العمود وتفرده
عمليات العناصر
- إنشاء عناصر قائمة بقيم الحقول
- تحديث عناصر القائمة الموجودة (تحديثات جزئية)
- حذف عناصر القائمة
- سرد العناصر مع التصفية وفصل الصفحات
- التحكم في التزامن عبر ETag
اكتشاف الموقع
- البحث في المواقع حسب الاسم أو URL
- حل المواقع حسب اسم المضيف والمسار
- سرد المواقع الفرعية
- البحث بنمط KQL باستخدام Microsoft Graph Search API
دعم استعلام OData
- استخدم $select لاختيار الخصائص.
- استخدم $filter لتصفية النتائج.
- استخدم $expand لتضمين الكيانات ذات الصلة.
- استخدم $orderby لفرز النتائج.
- استخدم $top لفصل الصفحات.
- استخدم $skiptoken للصفحة عبر مجموعات النتائج الكبيرة.
دعم نوع العمود
- أعمدة النص (نص أحادي السطر أو متعدد الأسطر أو نص عادي أو منسق).
- أعمدة الأرقام (ذات القيم العشرية والحد الأدنى والحد الأقصى).
- أعمدة الاختيار (خانات الاختيار أو القائمة المنسدلة أو الأزرار التبادلية).
- أعمدة منطقية.
- أعمدة التاريخ والوقت (التاريخ فقط أو التاريخ والوقت).
- أعمدة الشخص أو المجموعة (تحديد واحد أو متعدد).
- أعمدة البحث (الرجوع إلى قوائم أخرى).
- ارتباط تشعبي أو أعمدة صورة.
ملاحظات
- تستخدم جميع العمليات Microsoft Graph API v1.0.
- يجب أن تكون أسماء الأعمدة مكونة من 1 إلى 64 حرفًا بدون مسافات.
- يجب أن يحدد كل عمود نوع عمود واحد بالضبط.
- يتوفر التحكم في التزامن من خلال عنوان
If-Match. - يتطلب عمليات البحث في الموقع
consistencyLevelتعيين إلىeventual. - تقتصر نتائج البحث على 50 عنصرًا لكل صفحة.
- يتم دعم التحديثات الجزئية للأعمدة وعناصر القائمة.