تكامل Microsoft OneDrive

نظرة عامة

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

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

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

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

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

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

1. انتقل إلى تكاملات CrewAI AMP
2. ابحث عن Microsoft OneDrive في قسم تكاملات المصادقة
3. انقر على Connect وأكمل عملية OAuth
4. امنح الصلاحيات اللازمة للوصول إلى الملفات
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_onedrive/list_files

الوصف: عرض الملفات والمجلدات في OneDrive.

المعاملات:

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

microsoft_onedrive/get_file_info

الوصف: الحصول على معلومات حول ملف أو مجلد محدد.

المعاملات:

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

microsoft_onedrive/download_file

الوصف: تحميل ملف من OneDrive.

المعاملات:

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

microsoft_onedrive/upload_file

الوصف: رفع ملف إلى OneDrive.

المعاملات:

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

microsoft_onedrive/create_folder

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

المعاملات:

• folder_name (string, مطلوب): اسم المجلد المراد إنشاؤه.

microsoft_onedrive/delete_item

الوصف: حذف ملف أو مجلد من OneDrive.

المعاملات:

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

microsoft_onedrive/copy_item

الوصف: نسخ ملف أو مجلد في OneDrive.

المعاملات:

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

microsoft_onedrive/move_item

الوصف: نقل ملف أو مجلد في OneDrive.

المعاملات:

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

microsoft_onedrive/search_files

الوصف: البحث عن الملفات والمجلدات في OneDrive.

المعاملات:

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

microsoft_onedrive/share_item

الوصف: إنشاء رابط مشاركة لملف أو مجلد.

المعاملات:

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

microsoft_onedrive/get_recent_files

الوصف: الحصول على الملفات التي تم الوصول إليها مؤخراً من OneDrive.

المعاملات:

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

microsoft_onedrive/get_shared_with_me

الوصف: الحصول على الملفات والمجلدات المشاركة مع المستخدم.

المعاملات:

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

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

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

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.
• تحقق من وجود مجلدات الوجهة وإمكانية الوصول إليها.

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

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

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