تكامل Microsoft Excel

نظرة عامة

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

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

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

• حساب CrewAI AMP مع اشتراك فعّال
• حساب Microsoft 365 مع إمكانية الوصول إلى Excel وOneDrive/SharePoint
• ربط حساب Microsoft الخاص بك عبر صفحة التكاملات

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

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

1. انتقل إلى تكاملات CrewAI AMP
2. ابحث عن Microsoft Excel في قسم تكاملات المصادقة
3. انقر على Connect وأكمل عملية OAuth
4. امنح الصلاحيات اللازمة للوصول إلى الملفات ومصنفات Excel
5. انسخ رمز المؤسسة من إعدادات التكامل

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

uv add crewai-tools

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

Note

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

export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"

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

CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token

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

microsoft_excel/create_workbook

الوصف: إنشاء مصنف Excel جديد في OneDrive أو SharePoint.

المعاملات:

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

microsoft_excel/get_workbooks

الوصف: الحصول على جميع مصنفات Excel من OneDrive أو SharePoint.

المعاملات:

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

microsoft_excel/get_worksheets

الوصف: الحصول على جميع أوراق العمل في مصنف Excel.

المعاملات:

• file_id (string, مطلوب): معرّف ملف Excel

microsoft_excel/create_worksheet

الوصف: إنشاء ورقة عمل جديدة في مصنف Excel.

المعاملات:

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

microsoft_excel/get_range_data

الوصف: الحصول على البيانات من نطاق محدد في ورقة عمل Excel.

المعاملات:

• file_id (string, مطلوب): معرّف ملف Excel
• worksheet_name (string, مطلوب): اسم ورقة العمل
• range (string, مطلوب): عنوان النطاق (مثال: ‘A1:C10’)

microsoft_excel/update_range_data

الوصف: تحديث البيانات في نطاق محدد في ورقة عمل Excel.

المعاملات:

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

microsoft_excel/add_table

الوصف: إنشاء جدول في ورقة عمل Excel.

المعاملات:

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

microsoft_excel/add_table_row

الوصف: إضافة صف جديد إلى جدول Excel.

المعاملات:

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

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

microsoft_excel/get_cell

الوصف: الحصول على قيمة خلية واحدة في ورقة عمل Excel.

المعاملات:

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

microsoft_excel/get_used_range

الوصف: الحصول على النطاق المستخدم لورقة عمل Excel (يحتوي على جميع البيانات).

المعاملات:

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

microsoft_excel/get_tables

الوصف: الحصول على جميع الجداول في ورقة عمل Excel.

المعاملات:

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

microsoft_excel/get_table_data

الوصف: الحصول على البيانات من جدول محدد في ورقة عمل Excel.

المعاملات:

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

microsoft_excel/delete_worksheet

الوصف: حذف ورقة عمل من مصنف Excel.

المعاملات:

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

microsoft_excel/delete_table

الوصف: حذف جدول من ورقة عمل Excel.

المعاملات:

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

microsoft_excel/list_names

الوصف: الحصول على جميع النطاقات المسماة في مصنف Excel.

المعاملات:

• file_id (string, مطلوب): معرّف ملف Excel

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

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

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، إلخ.)
• تأكد من أن نطاقات بيانات المصدر تحتوي على بيانات مناسبة لنوع الرسم البياني

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

تحتاج مساعدة؟

تواصل مع فريق الدعم للحصول على المساعدة في إعداد تكامل Microsoft Excel أو استكشاف الأخطاء وإصلاحها.