الانتقال إلى المحتوى الرئيسي

نظرة عامة

مكّن وكلاءك من الوصول إلى مواقع 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. إعداد متغير البيئة

لاستخدام التكاملات مع Agent(apps=[]), يجب تعيين متغير البيئة CREWAI_PLATFORM_INTEGRATION_TOKEN برمز المؤسسة الخاص بك.
export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"
أو أضفه إلى ملف .env:
CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token

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

الوصف: الحصول على جميع مواقع SharePoint التي يمكن للمستخدم الوصول إليها.المعاملات:
  • search (string, اختياري): استعلام بحث لتصفية المواقع
  • top (integer, اختياري): عدد العناصر المراد إرجاعها. الحد الأدنى: 1، الحد الأقصى: 999
الوصف: الحصول على معلومات حول موقع SharePoint محدد.المعاملات:
  • site_id (string, مطلوب): معرّف موقع SharePoint
الوصف: عرض جميع مكتبات المستندات (drives) في موقع SharePoint.المعاملات:
  • site_id (string, مطلوب): معرّف موقع SharePoint الكامل
الوصف: الحصول على جميع القوائم في موقع SharePoint.المعاملات:
  • site_id (string, مطلوب): معرّف موقع SharePoint
الوصف: الحصول على عناصر من قائمة SharePoint.المعاملات:
  • site_id (string, مطلوب): معرّف موقع SharePoint
  • list_id (string, مطلوب): معرّف القائمة
  • expand (string, اختياري): توسيع البيانات المرتبطة (مثال: ‘fields’)
الوصف: إنشاء عنصر جديد في قائمة SharePoint.المعاملات:
  • site_id (string, مطلوب): معرّف موقع SharePoint
  • list_id (string, مطلوب): معرّف القائمة
  • fields (object, مطلوب): قيم الحقول للعنصر الجديد
الوصف: تحديث عنصر في قائمة SharePoint.المعاملات:
  • site_id (string, مطلوب): معرّف موقع SharePoint
  • list_id (string, مطلوب): معرّف القائمة
  • item_id (string, مطلوب): معرّف العنصر المراد تحديثه
  • fields (object, مطلوب): قيم الحقول المراد تحديثها
الوصف: حذف عنصر من قائمة SharePoint.المعاملات:
  • site_id (string, مطلوب): معرّف موقع SharePoint
  • list_id (string, مطلوب): معرّف القائمة
  • item_id (string, مطلوب): معرّف العنصر المراد حذفه
الوصف: رفع ملف إلى مكتبة مستندات SharePoint.المعاملات:
  • site_id (string, مطلوب): معرّف موقع SharePoint
  • file_path (string, مطلوب): المسار حيث يتم رفع الملف
  • content (string, مطلوب): محتوى الملف المراد رفعه
الوصف: استرجاع الملفات والمجلدات من مكتبة مستندات SharePoint.المعاملات:
  • site_id (string, مطلوب): معرّف موقع SharePoint الكامل
  • drive_id (string, مطلوب): معرّف مكتبة المستندات
  • folder_id (string, اختياري): معرّف المجلد. الافتراضي: ‘root’
  • top (integer, اختياري): الحد الأقصى لعدد العناصر. الافتراضي: 50
الوصف: البحث عن الملفات والمجلدات في مكتبة مستندات SharePoint بالكلمات المفتاحية.المعاملات:
  • site_id (string, مطلوب): معرّف موقع SharePoint الكامل
  • drive_id (string, مطلوب): معرّف مكتبة المستندات
  • query (string, مطلوب): كلمات البحث المفتاحية
الوصف: حذف ملف أو مجلد من مكتبة مستندات SharePoint.المعاملات:
  • site_id (string, مطلوب): معرّف موقع SharePoint الكامل
  • drive_id (string, مطلوب): معرّف مكتبة المستندات
  • item_id (string, مطلوب): المعرّف الفريد للملف أو المجلد المراد حذفه
الوصف: إنشاء مجلد جديد في مكتبة مستندات SharePoint.المعاملات:
  • site_id (string, مطلوب): معرّف موقع SharePoint الكامل
  • drive_id (string, مطلوب): معرّف مكتبة المستندات
  • folder_name (string, مطلوب): اسم المجلد الجديد
  • parent_id (string, اختياري): معرّف المجلد الأصلي. الافتراضي: ‘root’
الوصف: تحميل محتوى ملف خام من مكتبة مستندات SharePoint.المعاملات:
  • site_id (string, مطلوب): معرّف موقع SharePoint الكامل
  • drive_id (string, مطلوب): معرّف مكتبة المستندات
  • item_id (string, مطلوب): المعرّف الفريد للملف المراد تحميله
الوصف: نسخ ملف أو مجلد إلى موقع جديد داخل SharePoint.المعاملات:
  • site_id (string, مطلوب): معرّف موقع SharePoint الكامل
  • drive_id (string, مطلوب): معرّف مكتبة المستندات
  • item_id (string, مطلوب): المعرّف الفريد للملف أو المجلد المراد نسخه
  • destination_folder_id (string, مطلوب): معرّف مجلد الوجهة
الوصف: نقل ملف أو مجلد إلى موقع جديد داخل 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 أو استكشاف الأخطاء وإصلاحها.