تكامل Microsoft SharePoint

نظرة عامة

مكّن وكلاءك من الوصول إلى مواقع SharePoint والقوائم ومكتبات المستندات وإدارتها. استرجع معلومات المواقع، وأدر عناصر القوائم، وارفع الملفات ونظّمها، وبسّط سير عمل SharePoint باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.

المتطلبات الأساسية

قبل استخدام تكامل Microsoft SharePoint، تأكد من توفر ما يلي:

• حساب CrewAI AMP مع اشتراك فعّال
• حساب Microsoft 365 مع إمكانية الوصول إلى SharePoint
• ربط حساب Microsoft الخاص بك عبر صفحة التكاملات

إعداد تكامل Microsoft SharePoint

1. ربط حساب Microsoft الخاص بك

1. انتقل إلى تكاملات CrewAI AMP
2. ابحث عن Microsoft SharePoint في قسم تكاملات المصادقة
3. انقر على Connect وأكمل عملية OAuth
4. امنح الصلاحيات اللازمة للوصول إلى مواقع SharePoint ومحتوياتها
5. انسخ رمز المؤسسة من إعدادات التكامل

2. تثبيت الحزمة المطلوبة

uv add crewai-tools

3. إعداد متغير البيئة

Note

لاستخدام التكاملات مع Agent(apps=[]), يجب تعيين متغير البيئة CREWAI_PLATFORM_INTEGRATION_TOKEN برمز المؤسسة الخاص بك.

export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"

أو أضفه إلى ملف .env:

CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token

الإجراءات المتاحة

microsoft_sharepoint/get_sites

الوصف: الحصول على جميع مواقع SharePoint التي يمكن للمستخدم الوصول إليها.

المعاملات:

• search (string, اختياري): استعلام بحث لتصفية المواقع
• top (integer, اختياري): عدد العناصر المراد إرجاعها. الحد الأدنى: 1، الحد الأقصى: 999

microsoft_sharepoint/get_site

الوصف: الحصول على معلومات حول موقع SharePoint محدد.

المعاملات:

• site_id (string, مطلوب): معرّف موقع SharePoint

microsoft_sharepoint/get_drives

الوصف: عرض جميع مكتبات المستندات (drives) في موقع SharePoint.

المعاملات:

• site_id (string, مطلوب): معرّف موقع SharePoint الكامل

microsoft_sharepoint/get_site_lists

الوصف: الحصول على جميع القوائم في موقع SharePoint.

المعاملات:

• site_id (string, مطلوب): معرّف موقع SharePoint

microsoft_sharepoint/get_list_items

الوصف: الحصول على عناصر من قائمة SharePoint.

المعاملات:

• site_id (string, مطلوب): معرّف موقع SharePoint
• list_id (string, مطلوب): معرّف القائمة
• expand (string, اختياري): توسيع البيانات المرتبطة (مثال: ‘fields’)

microsoft_sharepoint/create_list_item

الوصف: إنشاء عنصر جديد في قائمة SharePoint.

المعاملات:

• site_id (string, مطلوب): معرّف موقع SharePoint
• list_id (string, مطلوب): معرّف القائمة
• fields (object, مطلوب): قيم الحقول للعنصر الجديد

microsoft_sharepoint/update_list_item

الوصف: تحديث عنصر في قائمة SharePoint.

المعاملات:

• site_id (string, مطلوب): معرّف موقع SharePoint
• list_id (string, مطلوب): معرّف القائمة
• item_id (string, مطلوب): معرّف العنصر المراد تحديثه
• fields (object, مطلوب): قيم الحقول المراد تحديثها

microsoft_sharepoint/delete_list_item

الوصف: حذف عنصر من قائمة SharePoint.

المعاملات:

• site_id (string, مطلوب): معرّف موقع SharePoint
• list_id (string, مطلوب): معرّف القائمة
• item_id (string, مطلوب): معرّف العنصر المراد حذفه

microsoft_sharepoint/upload_file_to_library

الوصف: رفع ملف إلى مكتبة مستندات SharePoint.

المعاملات:

• site_id (string, مطلوب): معرّف موقع SharePoint
• file_path (string, مطلوب): المسار حيث يتم رفع الملف
• content (string, مطلوب): محتوى الملف المراد رفعه

microsoft_sharepoint/list_files

الوصف: استرجاع الملفات والمجلدات من مكتبة مستندات SharePoint.

المعاملات:

• site_id (string, مطلوب): معرّف موقع SharePoint الكامل
• drive_id (string, مطلوب): معرّف مكتبة المستندات
• folder_id (string, اختياري): معرّف المجلد. الافتراضي: ‘root’
• top (integer, اختياري): الحد الأقصى لعدد العناصر. الافتراضي: 50

microsoft_sharepoint/search_files

الوصف: البحث عن الملفات والمجلدات في مكتبة مستندات SharePoint بالكلمات المفتاحية.

المعاملات:

• site_id (string, مطلوب): معرّف موقع SharePoint الكامل
• drive_id (string, مطلوب): معرّف مكتبة المستندات
• query (string, مطلوب): كلمات البحث المفتاحية

microsoft_sharepoint/delete_file

الوصف: حذف ملف أو مجلد من مكتبة مستندات SharePoint.

المعاملات:

• site_id (string, مطلوب): معرّف موقع SharePoint الكامل
• drive_id (string, مطلوب): معرّف مكتبة المستندات
• item_id (string, مطلوب): المعرّف الفريد للملف أو المجلد المراد حذفه

microsoft_sharepoint/create_folder

الوصف: إنشاء مجلد جديد في مكتبة مستندات SharePoint.

المعاملات:

• site_id (string, مطلوب): معرّف موقع SharePoint الكامل
• drive_id (string, مطلوب): معرّف مكتبة المستندات
• folder_name (string, مطلوب): اسم المجلد الجديد
• parent_id (string, اختياري): معرّف المجلد الأصلي. الافتراضي: ‘root’

microsoft_sharepoint/download_file

الوصف: تحميل محتوى ملف خام من مكتبة مستندات SharePoint.

المعاملات:

• site_id (string, مطلوب): معرّف موقع SharePoint الكامل
• drive_id (string, مطلوب): معرّف مكتبة المستندات
• item_id (string, مطلوب): المعرّف الفريد للملف المراد تحميله

microsoft_sharepoint/copy_file

الوصف: نسخ ملف أو مجلد إلى موقع جديد داخل SharePoint.

المعاملات:

• site_id (string, مطلوب): معرّف موقع SharePoint الكامل
• drive_id (string, مطلوب): معرّف مكتبة المستندات
• item_id (string, مطلوب): المعرّف الفريد للملف أو المجلد المراد نسخه
• destination_folder_id (string, مطلوب): معرّف مجلد الوجهة

microsoft_sharepoint/move_file

الوصف: نقل ملف أو مجلد إلى موقع جديد داخل SharePoint.

المعاملات:

• site_id (string, مطلوب): معرّف موقع SharePoint الكامل
• drive_id (string, مطلوب): معرّف مكتبة المستندات
• item_id (string, مطلوب): المعرّف الفريد للملف أو المجلد المراد نقله
• destination_folder_id (string, مطلوب): معرّف مجلد الوجهة

أمثلة الاستخدام

إعداد Agent أساسي لـ SharePoint

from crewai import Agent, Task, Crew

# Create an agent with SharePoint capabilities
sharepoint_agent = Agent(
    role="SharePoint Manager",
    goal="Manage SharePoint sites, lists, and documents efficiently",
    backstory="An AI assistant specialized in SharePoint content management and collaboration.",
    apps=['microsoft_sharepoint']  # All SharePoint actions will be available
)

# Task to organize SharePoint content
content_organization_task = Task(
    description="List all accessible SharePoint sites and organize content by department",
    agent=sharepoint_agent,
    expected_output="SharePoint sites listed and content organized by department"
)

# Run the task
crew = Crew(
    agents=[sharepoint_agent],
    tasks=[content_organization_task]
)

crew.kickoff()

استكشاف الأخطاء وإصلاحها

المشاكل الشائعة

أخطاء الصلاحيات

• تأكد من أن حساب Microsoft الخاص بك لديه الصلاحيات المناسبة لمواقع SharePoint
• تحقق من أن اتصال OAuth يتضمن النطاقات المطلوبة (Sites.Read.All, Sites.ReadWrite.All)

مشاكل معرّفات المواقع والقوائم

• تحقق من صحة معرّفات المواقع والقوائم وصيغتها الصحيحة
• استخدم إجراءات get_sites وget_site_lists لاكتشاف المعرّفات الصالحة

مشاكل الحقول والمخطط

• تأكد من تطابق أسماء الحقول تماماً مع مخطط قائمة SharePoint
• تحقق من تضمين الحقول المطلوبة عند إنشاء أو تحديث عناصر القوائم

الحصول على المساعدة

تحتاج مساعدة؟

تواصل مع فريق الدعم للحصول على المساعدة في إعداد تكامل Microsoft SharePoint أو استكشاف الأخطاء وإصلاحها.