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

---
title: تكامل Microsoft Excel
description: "إدارة المصنفات والبيانات مع تكامل Microsoft Excel لـ CrewAI."
icon: "table"
mode: "wide"
---

## نظرة عامة

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

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

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

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

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

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

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

    **المعاملات:**
    - `file_path` (string, مطلوب): المسار حيث يتم إنشاء المصنف (مثال: 'MyWorkbook.xlsx')
    - `worksheets` (array, اختياري): أوراق العمل الأولية المراد إنشاؤها

  </Accordion>

  <Accordion title="microsoft_excel/get_workbooks">
    **الوصف:** الحصول على جميع مصنفات Excel من OneDrive أو SharePoint.

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

  </Accordion>

  <Accordion title="microsoft_excel/get_worksheets">
    **الوصف:** الحصول على جميع أوراق العمل في مصنف Excel.

    **المعاملات:**
    - `file_id` (string, مطلوب): معرّف ملف Excel

  </Accordion>

  <Accordion title="microsoft_excel/create_worksheet">
    **الوصف:** إنشاء ورقة عمل جديدة في مصنف Excel.

    **المعاملات:**
    - `file_id` (string, مطلوب): معرّف ملف Excel
    - `name` (string, مطلوب): اسم ورقة العمل الجديدة

  </Accordion>

  <Accordion title="microsoft_excel/get_range_data">
    **الوصف:** الحصول على البيانات من نطاق محدد في ورقة عمل Excel.

    **المعاملات:**
    - `file_id` (string, مطلوب): معرّف ملف Excel
    - `worksheet_name` (string, مطلوب): اسم ورقة العمل
    - `range` (string, مطلوب): عنوان النطاق (مثال: 'A1:C10')

  </Accordion>

  <Accordion title="microsoft_excel/update_range_data">
    **الوصف:** تحديث البيانات في نطاق محدد في ورقة عمل Excel.

    **المعاملات:**
    - `file_id` (string, مطلوب): معرّف ملف Excel
    - `worksheet_name` (string, مطلوب): اسم ورقة العمل
    - `range` (string, مطلوب): عنوان النطاق (مثال: 'A1:C10')
    - `values` (array, مطلوب): مصفوفة ثنائية الأبعاد من القيم لتعيينها في النطاق

  </Accordion>

  <Accordion title="microsoft_excel/add_table">
    **الوصف:** إنشاء جدول في ورقة عمل Excel.

    **المعاملات:**
    - `file_id` (string, مطلوب): معرّف ملف Excel
    - `worksheet_name` (string, مطلوب): اسم ورقة العمل
    - `range` (string, مطلوب): النطاق للجدول (مثال: 'A1:D10')
    - `has_headers` (boolean, اختياري): ما إذا كان الصف الأول يحتوي على ترويسات. الافتراضي: true

  </Accordion>

  <Accordion title="microsoft_excel/add_table_row">
    **الوصف:** إضافة صف جديد إلى جدول Excel.

    **المعاملات:**
    - `file_id` (string, مطلوب): معرّف ملف Excel
    - `worksheet_name` (string, مطلوب): اسم ورقة العمل
    - `table_name` (string, مطلوب): اسم الجدول
    - `values` (array, مطلوب): مصفوفة من القيم للصف الجديد

  </Accordion>

  <Accordion title="microsoft_excel/create_chart">
    **الوصف:** إنشاء رسم بياني في ورقة عمل Excel.

    **المعاملات:**
    - `file_id` (string, مطلوب): معرّف ملف Excel
    - `worksheet_name` (string, مطلوب): اسم ورقة العمل
    - `chart_type` (string, مطلوب): نوع الرسم البياني (مثال: 'ColumnClustered', 'Line', 'Pie')
    - `source_data` (string, مطلوب): نطاق البيانات للرسم البياني (مثال: 'A1:B10')
    - `series_by` (string, اختياري): كيفية تفسير البيانات ('Auto', 'Columns', 'Rows'). الافتراضي: Auto

  </Accordion>

  <Accordion title="microsoft_excel/get_cell">
    **الوصف:** الحصول على قيمة خلية واحدة في ورقة عمل Excel.

    **المعاملات:**
    - `file_id` (string, مطلوب): معرّف ملف Excel
    - `worksheet_name` (string, مطلوب): اسم ورقة العمل
    - `row` (integer, مطلوب): رقم الصف (قائم على الصفر)
    - `column` (integer, مطلوب): رقم العمود (قائم على الصفر)

  </Accordion>

  <Accordion title="microsoft_excel/get_used_range">
    **الوصف:** الحصول على النطاق المستخدم لورقة عمل Excel (يحتوي على جميع البيانات).

    **المعاملات:**
    - `file_id` (string, مطلوب): معرّف ملف Excel
    - `worksheet_name` (string, مطلوب): اسم ورقة العمل

  </Accordion>

  <Accordion title="microsoft_excel/get_tables">
    **الوصف:** الحصول على جميع الجداول في ورقة عمل Excel.

    **المعاملات:**
    - `file_id` (string, مطلوب): معرّف ملف Excel
    - `worksheet_name` (string, مطلوب): اسم ورقة العمل

  </Accordion>

  <Accordion title="microsoft_excel/get_table_data">
    **الوصف:** الحصول على البيانات من جدول محدد في ورقة عمل Excel.

    **المعاملات:**
    - `file_id` (string, مطلوب): معرّف ملف Excel
    - `worksheet_name` (string, مطلوب): اسم ورقة العمل
    - `table_name` (string, مطلوب): اسم الجدول

  </Accordion>

  <Accordion title="microsoft_excel/delete_worksheet">
    **الوصف:** حذف ورقة عمل من مصنف Excel.

    **المعاملات:**
    - `file_id` (string, مطلوب): معرّف ملف Excel
    - `worksheet_name` (string, مطلوب): اسم ورقة العمل المراد حذفها

  </Accordion>

  <Accordion title="microsoft_excel/delete_table">
    **الوصف:** حذف جدول من ورقة عمل Excel.

    **المعاملات:**
    - `file_id` (string, مطلوب): معرّف ملف Excel
    - `worksheet_name` (string, مطلوب): اسم ورقة العمل
    - `table_name` (string, مطلوب): اسم الجدول المراد حذفه

  </Accordion>

  <Accordion title="microsoft_excel/list_names">
    **الوصف:** الحصول على جميع النطاقات المسماة في مصنف Excel.

    **المعاملات:**
    - `file_id` (string, مطلوب): معرّف ملف Excel

  </Accordion>
</AccordionGroup>

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

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

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

# Create an agent with Excel capabilities
excel_agent = Agent(
    role="Excel Data Manager",
    goal="Manage Excel workbooks and data efficiently",
    backstory="An AI assistant specialized in Excel data management and analysis.",
    apps=['microsoft_excel']  # All Excel actions will be available
)

# Task to create and populate a workbook
data_management_task = Task(
    description="Create a new sales report workbook with data analysis and charts",
    agent=excel_agent,
    expected_output="Excel workbook created with sales data, analysis, and visualizations"
)

# Run the task
crew = Crew(
    agents=[excel_agent],
    tasks=[data_management_task]
)

crew.kickoff()
```

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

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

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

- تأكد من أن حساب Microsoft الخاص بك لديه الصلاحيات المناسبة لـ Excel وOneDrive/SharePoint
- تحقق من أن اتصال OAuth يتضمن النطاقات المطلوبة (Files.Read.All, Files.ReadWrite.All)

**مشاكل النطاق وورقة العمل**

- تحقق من وجود أسماء أوراق العمل في المصنف المحدد
- تأكد من صحة تنسيق عناوين النطاقات (مثال: 'A1:C10')

**مشاكل الرسوم البيانية**

- تحقق من دعم أنواع الرسوم البيانية (ColumnClustered, Line, Pie، إلخ.)
- تأكد من أن نطاقات بيانات المصدر تحتوي على بيانات مناسبة لنوع الرسم البياني

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

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