نظرة عامة
مكّن وكلاءك من الوصول إلى مواقع SharePoint والقوائم ومكتبات المستندات وإدارتها. استرجع معلومات المواقع، وأدر عناصر القوائم، وارفع الملفات ونظّمها، وبسّط سير عمل SharePoint باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.
المتطلبات الأساسية
قبل استخدام تكامل Microsoft SharePoint، تأكد من توفر ما يلي:
حساب CrewAI AMP مع اشتراك فعّال
حساب Microsoft 365 مع إمكانية الوصول إلى SharePoint
ربط حساب Microsoft الخاص بك عبر صفحة التكاملات
إعداد تكامل Microsoft SharePoint
1. ربط حساب Microsoft الخاص بك
انتقل إلى تكاملات CrewAI AMP
ابحث عن Microsoft SharePoint في قسم تكاملات المصادقة
انقر على Connect وأكمل عملية OAuth
امنح الصلاحيات اللازمة للوصول إلى مواقع SharePoint ومحتوياتها
انسخ رمز المؤسسة من إعدادات التكامل
2. تثبيت الحزمة المطلوبة
3. إعداد متغير البيئة
لاستخدام التكاملات مع 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
أو استكشاف الأخطاء وإصلاحها.