نظرة عامة
مكّن وكلاءك من رفع وتحميل وإدارة الملفات والمجلدات في Microsoft OneDrive. أتمت عمليات الملفات، ونظّم المحتوى، وأنشئ روابط المشاركة، وبسّط سير عمل التخزين السحابي باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.المتطلبات الأساسية
قبل استخدام تكامل Microsoft OneDrive، تأكد من توفر ما يلي:- حساب CrewAI AMP مع اشتراك فعّال
- حساب Microsoft مع إمكانية الوصول إلى OneDrive
- ربط حساب Microsoft الخاص بك عبر صفحة التكاملات
إعداد تكامل Microsoft OneDrive
1. ربط حساب Microsoft الخاص بك
- انتقل إلى تكاملات CrewAI AMP
- ابحث عن Microsoft OneDrive في قسم تكاملات المصادقة
- انقر على Connect وأكمل عملية OAuth
- امنح الصلاحيات اللازمة للوصول إلى الملفات
- انسخ رمز المؤسسة من إعدادات التكامل
2. تثبيت الحزمة المطلوبة
3. إعداد متغير البيئة
لاستخدام التكاملات مع
Agent(apps=[]), يجب تعيين متغير البيئة
CREWAI_PLATFORM_INTEGRATION_TOKEN برمز المؤسسة الخاص بك..env:
الإجراءات المتاحة
microsoft_onedrive/list_files
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
microsoft_onedrive/get_file_info
الوصف: الحصول على معلومات حول ملف أو مجلد محدد.المعاملات:
item_id(string, مطلوب): معرّف الملف أو المجلد.
microsoft_onedrive/download_file
microsoft_onedrive/download_file
الوصف: تحميل ملف من OneDrive.المعاملات:
item_id(string, مطلوب): معرّف الملف المراد تحميله.
microsoft_onedrive/upload_file
microsoft_onedrive/upload_file
الوصف: رفع ملف إلى OneDrive.المعاملات:
file_name(string, مطلوب): اسم الملف المراد رفعه.content(string, مطلوب): محتوى الملف بترميز Base64.
microsoft_onedrive/create_folder
microsoft_onedrive/create_folder
الوصف: إنشاء مجلد جديد في OneDrive.المعاملات:
folder_name(string, مطلوب): اسم المجلد المراد إنشاؤه.
microsoft_onedrive/delete_item
microsoft_onedrive/delete_item
الوصف: حذف ملف أو مجلد من OneDrive.المعاملات:
item_id(string, مطلوب): معرّف الملف أو المجلد المراد حذفه.
microsoft_onedrive/copy_item
microsoft_onedrive/copy_item
الوصف: نسخ ملف أو مجلد في OneDrive.المعاملات:
item_id(string, مطلوب): معرّف الملف أو المجلد المراد نسخه.parent_id(string, اختياري): معرّف مجلد الوجهة (اختياري، الافتراضي هو الجذر).new_name(string, اختياري): الاسم الجديد للعنصر المنسوخ (اختياري).
microsoft_onedrive/move_item
microsoft_onedrive/move_item
الوصف: نقل ملف أو مجلد في OneDrive.المعاملات:
item_id(string, مطلوب): معرّف الملف أو المجلد المراد نقله.parent_id(string, مطلوب): معرّف مجلد الوجهة.new_name(string, اختياري): الاسم الجديد للعنصر (اختياري).
microsoft_onedrive/search_files
microsoft_onedrive/search_files
الوصف: البحث عن الملفات والمجلدات في OneDrive.المعاملات:
query(string, مطلوب): سلسلة استعلام البحث.top(integer, اختياري): عدد النتائج المراد إرجاعها (الحد الأقصى 1000). الافتراضي:50.
microsoft_onedrive/share_item
microsoft_onedrive/share_item
microsoft_onedrive/get_recent_files
microsoft_onedrive/get_recent_files
الوصف: الحصول على الملفات التي تم الوصول إليها مؤخراً من OneDrive.المعاملات:
top(integer, اختياري): عدد العناصر المراد استرجاعها (الحد الأقصى 200). الافتراضي:25.
microsoft_onedrive/get_shared_with_me
microsoft_onedrive/get_shared_with_me
أمثلة الاستخدام
إعداد Agent أساسي لـ Microsoft OneDrive
استكشاف الأخطاء وإصلاحها
المشاكل الشائعة
أخطاء المصادقة- تأكد من أن حساب Microsoft الخاص بك لديه الصلاحيات اللازمة للوصول إلى الملفات (مثال:
Files.Read,Files.ReadWrite). - تحقق من أن اتصال OAuth يتضمن جميع النطاقات المطلوبة.
- تأكد من توفير
file_nameوcontentلعمليات رفع الملفات. - يجب أن يكون المحتوى بترميز Base64 للملفات الثنائية.
- لـ
move_item، تأكد من توفير كل منitem_idوparent_id. - تحقق من وجود مجلدات الوجهة وإمكانية الوصول إليها.
الحصول على المساعدة
تحتاج مساعدة؟
تواصل مع فريق الدعم للحصول على المساعدة في إعداد تكامل Microsoft OneDrive
أو استكشاف الأخطاء وإصلاحها.
