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

​
نظرة عامة

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

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

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

الوصف: إنشاء مصنف Excel جديد في OneDrive أو SharePoint.المعاملات:
  • file_path (string, مطلوب): المسار حيث يتم إنشاء المصنف (مثال: ‘MyWorkbook.xlsx’)
  • worksheets (array, اختياري): أوراق العمل الأولية المراد إنشاؤها
الوصف: الحصول على جميع مصنفات Excel من OneDrive أو SharePoint.المعاملات:
  • select (string, اختياري): اختيار خصائص محددة للإرجاع
  • filter (string, اختياري): تصفية النتائج باستخدام صيغة OData
  • top (integer, اختياري): عدد العناصر المراد إرجاعها. الحد الأدنى: 1، الحد الأقصى: 999
الوصف: الحصول على جميع أوراق العمل في مصنف Excel.المعاملات:
  • file_id (string, مطلوب): معرّف ملف Excel
الوصف: إنشاء ورقة عمل جديدة في مصنف Excel.المعاملات:
  • file_id (string, مطلوب): معرّف ملف Excel
  • name (string, مطلوب): اسم ورقة العمل الجديدة
الوصف: الحصول على البيانات من نطاق محدد في ورقة عمل Excel.المعاملات:
  • file_id (string, مطلوب): معرّف ملف Excel
  • worksheet_name (string, مطلوب): اسم ورقة العمل
  • range (string, مطلوب): عنوان النطاق (مثال: ‘A1:C10’)
الوصف: تحديث البيانات في نطاق محدد في ورقة عمل Excel.المعاملات:
  • file_id (string, مطلوب): معرّف ملف Excel
  • worksheet_name (string, مطلوب): اسم ورقة العمل
  • range (string, مطلوب): عنوان النطاق (مثال: ‘A1:C10’)
  • values (array, مطلوب): مصفوفة ثنائية الأبعاد من القيم لتعيينها في النطاق
الوصف: إنشاء جدول في ورقة عمل Excel.المعاملات:
  • file_id (string, مطلوب): معرّف ملف Excel
  • worksheet_name (string, مطلوب): اسم ورقة العمل
  • range (string, مطلوب): النطاق للجدول (مثال: ‘A1:D10’)
  • has_headers (boolean, اختياري): ما إذا كان الصف الأول يحتوي على ترويسات. الافتراضي: true
الوصف: إضافة صف جديد إلى جدول Excel.المعاملات:
  • file_id (string, مطلوب): معرّف ملف Excel
  • worksheet_name (string, مطلوب): اسم ورقة العمل
  • table_name (string, مطلوب): اسم الجدول
  • values (array, مطلوب): مصفوفة من القيم للصف الجديد
الوصف: إنشاء رسم بياني في ورقة عمل 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
الوصف: الحصول على قيمة خلية واحدة في ورقة عمل Excel.المعاملات:
  • file_id (string, مطلوب): معرّف ملف Excel
  • worksheet_name (string, مطلوب): اسم ورقة العمل
  • row (integer, مطلوب): رقم الصف (قائم على الصفر)
  • column (integer, مطلوب): رقم العمود (قائم على الصفر)
الوصف: الحصول على النطاق المستخدم لورقة عمل Excel (يحتوي على جميع البيانات).المعاملات:
  • file_id (string, مطلوب): معرّف ملف Excel
  • worksheet_name (string, مطلوب): اسم ورقة العمل
الوصف: الحصول على جميع الجداول في ورقة عمل Excel.المعاملات:
  • file_id (string, مطلوب): معرّف ملف Excel
  • worksheet_name (string, مطلوب): اسم ورقة العمل
الوصف: الحصول على البيانات من جدول محدد في ورقة عمل Excel.المعاملات:
  • file_id (string, مطلوب): معرّف ملف Excel
  • worksheet_name (string, مطلوب): اسم ورقة العمل
  • table_name (string, مطلوب): اسم الجدول
الوصف: حذف ورقة عمل من مصنف Excel.المعاملات:
  • file_id (string, مطلوب): معرّف ملف Excel
  • worksheet_name (string, مطلوب): اسم ورقة العمل المراد حذفها
الوصف: حذف جدول من ورقة عمل Excel.المعاملات:
  • file_id (string, مطلوب): معرّف ملف Excel
  • worksheet_name (string, مطلوب): اسم ورقة العمل
  • table_name (string, مطلوب): اسم الجدول المراد حذفه
الوصف: الحصول على جميع النطاقات المسماة في مصنف 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 أو استكشاف الأخطاء وإصلاحها.