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

نظرة عامة

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

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

قبل استخدام تكامل Google Drive، تأكد من توفر ما يلي:
  • حساب CrewAI AMP مع اشتراك فعّال
  • حساب Google مع إمكانية الوصول إلى Google Drive
  • ربط حساب Google الخاص بك عبر صفحة التكاملات

إعداد تكامل Google Drive

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

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

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

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

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

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

الوصف: الحصول على ملف بواسطة المعرّف من Google Drive.المعاملات:
  • file_id (string, مطلوب): معرّف الملف المراد استرجاعه.
الوصف: عرض قائمة الملفات في Google Drive.المعاملات:
  • q (string, اختياري): سلسلة استعلام لتصفية الملفات (مثال: “name contains ‘report’”).
  • page_size (integer, اختياري): الحد الأقصى لعدد الملفات المُرجعة (الافتراضي: 100، الحد الأقصى: 1000).
  • page_token (string, اختياري): رمز لاسترجاع الصفحة التالية من النتائج.
  • order_by (string, اختياري): ترتيب الفرز (مثال: “name”, “createdTime desc”, “modifiedTime”).
  • spaces (string, اختياري): قائمة مفصولة بفواصل للمساحات المراد الاستعلام عنها (drive, appDataFolder, photos).
الوصف: رفع ملف إلى Google Drive.المعاملات:
  • name (string, مطلوب): اسم الملف المراد إنشاؤه.
  • content (string, مطلوب): محتوى الملف المراد رفعه.
  • mime_type (string, اختياري): نوع MIME للملف (مثال: “text/plain”, “application/pdf”).
  • parent_folder_id (string, اختياري): معرّف المجلد الأصلي حيث يجب إنشاء الملف.
  • description (string, اختياري): وصف الملف.
الوصف: تحميل ملف من Google Drive.المعاملات:
  • file_id (string, مطلوب): معرّف الملف المراد تحميله.
  • mime_type (string, اختياري): نوع MIME للتصدير (مطلوب لمستندات Google Workspace).
الوصف: إنشاء مجلد جديد في Google Drive.المعاملات:
  • name (string, مطلوب): اسم المجلد المراد إنشاؤه.
  • parent_folder_id (string, اختياري): معرّف المجلد الأصلي حيث يجب إنشاء المجلد الجديد.
  • description (string, اختياري): وصف المجلد.
الوصف: حذف ملف من Google Drive.المعاملات:
  • file_id (string, مطلوب): معرّف الملف المراد حذفه.
الوصف: مشاركة ملف في Google Drive مع مستخدمين محددين أو جعله عاماً.المعاملات:
  • file_id (string, مطلوب): معرّف الملف المراد مشاركته.
  • role (string, مطلوب): الدور الممنوح بهذا الإذن (reader, writer, commenter, owner).
  • type (string, مطلوب): نوع المستفيد (user, group, domain, anyone).
  • email_address (string, اختياري): عنوان البريد الإلكتروني للمستخدم أو المجموعة المراد المشاركة معهم (مطلوب لأنواع user/group).
  • domain (string, اختياري): النطاق المراد المشاركة معه (مطلوب لنوع domain).
  • send_notification_email (boolean, اختياري): ما إذا كان يجب إرسال بريد إلكتروني إشعاري (الافتراضي: true).
  • email_message (string, اختياري): رسالة نصية مخصصة لتضمينها في البريد الإلكتروني الإشعاري.
الوصف: تحديث ملف موجود في Google Drive.المعاملات:
  • file_id (string, مطلوب): معرّف الملف المراد تحديثه.
  • name (string, اختياري): الاسم الجديد للملف.
  • content (string, اختياري): المحتوى الجديد للملف.
  • mime_type (string, اختياري): نوع MIME الجديد للملف.
  • description (string, اختياري): الوصف الجديد للملف.
  • add_parents (string, اختياري): قائمة مفصولة بفواصل لمعرّفات المجلدات الأصلية المراد إضافتها.
  • remove_parents (string, اختياري): قائمة مفصولة بفواصل لمعرّفات المجلدات الأصلية المراد إزالتها.

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

إعداد Agent أساسي لـ Google Drive

تصفية أدوات Google Drive المحددة

إدارة الملفات المتقدمة