crewAI/docs/ar/enterprise/integrations/microsoft_sharepoint.mdx

---
title: تكامل Microsoft SharePoint
description: "إدارة المواقع والقوائم والمستندات مع تكامل Microsoft SharePoint لـ CrewAI."
icon: "folder-tree"
mode: "wide"
---

## نظرة عامة

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

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

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

- حساب [CrewAI AMP](https://app.crewai.com) مع اشتراك فعّال
- حساب Microsoft 365 مع إمكانية الوصول إلى SharePoint
- ربط حساب Microsoft الخاص بك عبر [صفحة التكاملات](https://app.crewai.com/crewai_plus/connectors)

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

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

1. انتقل إلى [تكاملات CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)
2. ابحث عن **Microsoft SharePoint** في قسم تكاملات المصادقة
3. انقر على **Connect** وأكمل عملية OAuth
4. امنح الصلاحيات اللازمة للوصول إلى مواقع SharePoint ومحتوياتها
5. انسخ رمز المؤسسة من [إعدادات التكامل](https://app.crewai.com/crewai_plus/settings/integrations)

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

```bash
uv add crewai-tools
```

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

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

```bash
export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"
```

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

```
CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
```

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

<AccordionGroup>
  <Accordion title="microsoft_sharepoint/get_sites">
    **الوصف:** الحصول على جميع مواقع SharePoint التي يمكن للمستخدم الوصول إليها.

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

  </Accordion>

  <Accordion title="microsoft_sharepoint/get_site">
    **الوصف:** الحصول على معلومات حول موقع SharePoint محدد.

    **المعاملات:**
    - `site_id` (string, مطلوب): معرّف موقع SharePoint

  </Accordion>

  <Accordion title="microsoft_sharepoint/get_drives">
    **الوصف:** عرض جميع مكتبات المستندات (drives) في موقع SharePoint.

    **المعاملات:**
    - `site_id` (string, مطلوب): معرّف موقع SharePoint الكامل

  </Accordion>

  <Accordion title="microsoft_sharepoint/get_site_lists">
    **الوصف:** الحصول على جميع القوائم في موقع SharePoint.

    **المعاملات:**
    - `site_id` (string, مطلوب): معرّف موقع SharePoint

  </Accordion>

  <Accordion title="microsoft_sharepoint/get_list_items">
    **الوصف:** الحصول على عناصر من قائمة SharePoint.

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

  </Accordion>

  <Accordion title="microsoft_sharepoint/create_list_item">
    **الوصف:** إنشاء عنصر جديد في قائمة SharePoint.

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

  </Accordion>

  <Accordion title="microsoft_sharepoint/update_list_item">
    **الوصف:** تحديث عنصر في قائمة SharePoint.

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

  </Accordion>

  <Accordion title="microsoft_sharepoint/delete_list_item">
    **الوصف:** حذف عنصر من قائمة SharePoint.

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

  </Accordion>

  <Accordion title="microsoft_sharepoint/upload_file_to_library">
    **الوصف:** رفع ملف إلى مكتبة مستندات SharePoint.

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

  </Accordion>

  <Accordion title="microsoft_sharepoint/list_files">
    **الوصف:** استرجاع الملفات والمجلدات من مكتبة مستندات SharePoint.

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

  </Accordion>

  <Accordion title="microsoft_sharepoint/search_files">
    **الوصف:** البحث عن الملفات والمجلدات في مكتبة مستندات SharePoint بالكلمات المفتاحية.

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

  </Accordion>

  <Accordion title="microsoft_sharepoint/delete_file">
    **الوصف:** حذف ملف أو مجلد من مكتبة مستندات SharePoint.

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

  </Accordion>

  <Accordion title="microsoft_sharepoint/create_folder">
    **الوصف:** إنشاء مجلد جديد في مكتبة مستندات SharePoint.

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

  </Accordion>

  <Accordion title="microsoft_sharepoint/download_file">
    **الوصف:** تحميل محتوى ملف خام من مكتبة مستندات SharePoint.

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

  </Accordion>

  <Accordion title="microsoft_sharepoint/copy_file">
    **الوصف:** نسخ ملف أو مجلد إلى موقع جديد داخل SharePoint.

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

  </Accordion>

  <Accordion title="microsoft_sharepoint/move_file">
    **الوصف:** نقل ملف أو مجلد إلى موقع جديد داخل SharePoint.

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

  </Accordion>
</AccordionGroup>

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

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

```python
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
- تحقق من تضمين الحقول المطلوبة عند إنشاء أو تحديث عناصر القوائم

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

<Card title="تحتاج مساعدة؟" icon="headset" href="mailto:support@crewai.com">
  تواصل مع فريق الدعم للحصول على المساعدة في إعداد تكامل Microsoft SharePoint
  أو استكشاف الأخطاء وإصلاحها.
</Card>