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

نظرة عامة

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

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

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

الوصف: عرض الملفات والمجلدات في OneDrive.المعاملات:
  • top (integer, اختياري): عدد العناصر المراد استرجاعها (الحد الأقصى 1000). الافتراضي: 50.
  • orderby (string, اختياري): الترتيب حسب حقل (مثال: “name asc”, “lastModifiedDateTime desc”). الافتراضي: “name asc”.
  • filter (string, اختياري): تعبير فلتر OData.
الوصف: الحصول على معلومات حول ملف أو مجلد محدد.المعاملات:
  • item_id (string, مطلوب): معرّف الملف أو المجلد.
الوصف: تحميل ملف من OneDrive.المعاملات:
  • item_id (string, مطلوب): معرّف الملف المراد تحميله.
الوصف: رفع ملف إلى OneDrive.المعاملات:
  • file_name (string, مطلوب): اسم الملف المراد رفعه.
  • content (string, مطلوب): محتوى الملف بترميز Base64.
الوصف: إنشاء مجلد جديد في OneDrive.المعاملات:
  • folder_name (string, مطلوب): اسم المجلد المراد إنشاؤه.
الوصف: حذف ملف أو مجلد من OneDrive.المعاملات:
  • item_id (string, مطلوب): معرّف الملف أو المجلد المراد حذفه.
الوصف: نسخ ملف أو مجلد في OneDrive.المعاملات:
  • item_id (string, مطلوب): معرّف الملف أو المجلد المراد نسخه.
  • parent_id (string, اختياري): معرّف مجلد الوجهة (اختياري، الافتراضي هو الجذر).
  • new_name (string, اختياري): الاسم الجديد للعنصر المنسوخ (اختياري).
الوصف: نقل ملف أو مجلد في OneDrive.المعاملات:
  • item_id (string, مطلوب): معرّف الملف أو المجلد المراد نقله.
  • parent_id (string, مطلوب): معرّف مجلد الوجهة.
  • new_name (string, اختياري): الاسم الجديد للعنصر (اختياري).
الوصف: البحث عن الملفات والمجلدات في OneDrive.المعاملات:
  • query (string, مطلوب): سلسلة استعلام البحث.
  • top (integer, اختياري): عدد النتائج المراد إرجاعها (الحد الأقصى 1000). الافتراضي: 50.
الوصف: إنشاء رابط مشاركة لملف أو مجلد.المعاملات:
  • item_id (string, مطلوب): معرّف الملف أو المجلد المراد مشاركته.
  • type (string, اختياري): نوع رابط المشاركة. القيم: view, edit, embed. الافتراضي: view.
  • scope (string, اختياري): نطاق رابط المشاركة. القيم: anonymous, organization. الافتراضي: anonymous.
الوصف: الحصول على الملفات التي تم الوصول إليها مؤخراً من OneDrive.المعاملات:
  • top (integer, اختياري): عدد العناصر المراد استرجاعها (الحد الأقصى 200). الافتراضي: 25.
الوصف: الحصول على الملفات والمجلدات المشاركة مع المستخدم.المعاملات:
  • 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 أو استكشاف الأخطاء وإصلاحها.