crewAI/docs/edge/ar/enterprise/integrations/microsoft_onedrive.mdx

---
title: تكامل Microsoft OneDrive
description: "إدارة الملفات والمجلدات مع تكامل Microsoft OneDrive لـ CrewAI."
icon: "cloud"
mode: "wide"
---

## نظرة عامة

مكّن وكلاءك من رفع وتحميل وإدارة الملفات والمجلدات في Microsoft OneDrive. أتمت عمليات الملفات، ونظّم المحتوى، وأنشئ روابط المشاركة، وبسّط سير عمل التخزين السحابي باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.

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

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

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

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

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

1. انتقل إلى [تكاملات CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)
2. ابحث عن **Microsoft OneDrive** في قسم تكاملات المصادقة
3. انقر على **Connect** وأكمل عملية OAuth
4. امنح الصلاحيات اللازمة للوصول إلى الملفات
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_onedrive/list_files">
    **الوصف:** عرض الملفات والمجلدات في OneDrive.

    **المعاملات:**
    - `top` (integer, اختياري): عدد العناصر المراد استرجاعها (الحد الأقصى 1000). الافتراضي: `50`.
    - `orderby` (string, اختياري): الترتيب حسب حقل (مثال: "name asc", "lastModifiedDateTime desc"). الافتراضي: "name asc".
    - `filter` (string, اختياري): تعبير فلتر OData.

  </Accordion>

  <Accordion title="microsoft_onedrive/get_file_info">
    **الوصف:** الحصول على معلومات حول ملف أو مجلد محدد.

    **المعاملات:**
    - `item_id` (string, مطلوب): معرّف الملف أو المجلد.

  </Accordion>

  <Accordion title="microsoft_onedrive/download_file">
    **الوصف:** تحميل ملف من OneDrive.

    **المعاملات:**
    - `item_id` (string, مطلوب): معرّف الملف المراد تحميله.

  </Accordion>

  <Accordion title="microsoft_onedrive/upload_file">
    **الوصف:** رفع ملف إلى OneDrive.

    **المعاملات:**
    - `file_name` (string, مطلوب): اسم الملف المراد رفعه.
    - `content` (string, مطلوب): محتوى الملف بترميز Base64.

  </Accordion>

  <Accordion title="microsoft_onedrive/create_folder">
    **الوصف:** إنشاء مجلد جديد في OneDrive.

    **المعاملات:**
    - `folder_name` (string, مطلوب): اسم المجلد المراد إنشاؤه.

  </Accordion>

  <Accordion title="microsoft_onedrive/delete_item">
    **الوصف:** حذف ملف أو مجلد من OneDrive.

    **المعاملات:**
    - `item_id` (string, مطلوب): معرّف الملف أو المجلد المراد حذفه.

  </Accordion>

  <Accordion title="microsoft_onedrive/copy_item">
    **الوصف:** نسخ ملف أو مجلد في OneDrive.

    **المعاملات:**
    - `item_id` (string, مطلوب): معرّف الملف أو المجلد المراد نسخه.
    - `parent_id` (string, اختياري): معرّف مجلد الوجهة (اختياري، الافتراضي هو الجذر).
    - `new_name` (string, اختياري): الاسم الجديد للعنصر المنسوخ (اختياري).

  </Accordion>

  <Accordion title="microsoft_onedrive/move_item">
    **الوصف:** نقل ملف أو مجلد في OneDrive.

    **المعاملات:**
    - `item_id` (string, مطلوب): معرّف الملف أو المجلد المراد نقله.
    - `parent_id` (string, مطلوب): معرّف مجلد الوجهة.
    - `new_name` (string, اختياري): الاسم الجديد للعنصر (اختياري).

  </Accordion>

  <Accordion title="microsoft_onedrive/search_files">
    **الوصف:** البحث عن الملفات والمجلدات في OneDrive.

    **المعاملات:**
    - `query` (string, مطلوب): سلسلة استعلام البحث.
    - `top` (integer, اختياري): عدد النتائج المراد إرجاعها (الحد الأقصى 1000). الافتراضي: `50`.

  </Accordion>

  <Accordion title="microsoft_onedrive/share_item">
    **الوصف:** إنشاء رابط مشاركة لملف أو مجلد.

    **المعاملات:**
    - `item_id` (string, مطلوب): معرّف الملف أو المجلد المراد مشاركته.
    - `type` (string, اختياري): نوع رابط المشاركة. القيم: `view`, `edit`, `embed`. الافتراضي: `view`.
    - `scope` (string, اختياري): نطاق رابط المشاركة. القيم: `anonymous`, `organization`. الافتراضي: `anonymous`.

  </Accordion>

  <Accordion title="microsoft_onedrive/get_recent_files">
    **الوصف:** الحصول على الملفات التي تم الوصول إليها مؤخراً من OneDrive.

    **المعاملات:**
    - `top` (integer, اختياري): عدد العناصر المراد استرجاعها (الحد الأقصى 200). الافتراضي: `25`.

  </Accordion>

  <Accordion title="microsoft_onedrive/get_shared_with_me">
    **الوصف:** الحصول على الملفات والمجلدات المشاركة مع المستخدم.

    **المعاملات:**
    - `top` (integer, اختياري): عدد العناصر المراد استرجاعها (الحد الأقصى 200). الافتراضي: `50`.

  </Accordion>
</AccordionGroup>

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

### إعداد Agent أساسي لـ Microsoft OneDrive

```python
from crewai import Agent, Task, Crew

# Create an agent with Microsoft OneDrive capabilities
onedrive_agent = Agent(
    role="File Manager",
    goal="Manage files and folders in OneDrive efficiently",
    backstory="An AI assistant specialized in Microsoft OneDrive file operations and organization.",
    apps=['microsoft_onedrive']  # All OneDrive actions will be available
)

# Task to list files and create a folder
organize_files_task = Task(
    description="List all files in my OneDrive root directory and create a new folder called 'Project Documents'.",
    agent=onedrive_agent,
    expected_output="List of files displayed and new folder 'Project Documents' created."
)

# Run the task
crew = Crew(
    agents=[onedrive_agent],
    tasks=[organize_files_task]
)

crew.kickoff()
```

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

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

**أخطاء المصادقة**

- تأكد من أن حساب Microsoft الخاص بك لديه الصلاحيات اللازمة للوصول إلى الملفات (مثال: `Files.Read`, `Files.ReadWrite`).
- تحقق من أن اتصال OAuth يتضمن جميع النطاقات المطلوبة.

**مشاكل رفع الملفات**

- تأكد من توفير `file_name` و`content` لعمليات رفع الملفات.
- يجب أن يكون المحتوى بترميز Base64 للملفات الثنائية.

**عمليات الملفات (النسخ/النقل)**

- لـ `move_item`، تأكد من توفير كل من `item_id` و`parent_id`.
- تحقق من وجود مجلدات الوجهة وإمكانية الوصول إليها.

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

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