نظرة عامة
مكّن وكلاءك من إدارة الملفات والمجلدات عبر Google Drive. ارفع الملفات وحمّلها ونظّمها وشاركها، وأنشئ المجلدات، وبسّط سير عمل إدارة المستندات باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.المتطلبات الأساسية
قبل استخدام تكامل Google Drive، تأكد من توفر ما يلي:- حساب CrewAI AMP مع اشتراك فعّال
- حساب Google مع إمكانية الوصول إلى Google Drive
- ربط حساب Google الخاص بك عبر صفحة التكاملات
إعداد تكامل Google Drive
1. ربط حساب Google الخاص بك
- انتقل إلى تكاملات CrewAI AMP
- ابحث عن Google Drive في قسم تكاملات المصادقة
- انقر على Connect وأكمل عملية OAuth
- امنح الصلاحيات اللازمة لإدارة الملفات والمجلدات
- انسخ رمز المؤسسة من إعدادات التكامل
2. تثبيت الحزمة المطلوبة
3. إعداد متغير البيئة
لاستخدام التكاملات مع
Agent(apps=[]), يجب تعيين متغير البيئة
CREWAI_PLATFORM_INTEGRATION_TOKEN برمز المؤسسة الخاص بك..env:
الإجراءات المتاحة
google_drive/get_file
google_drive/get_file
الوصف: الحصول على ملف بواسطة المعرّف من Google Drive.المعاملات:
file_id(string, مطلوب): معرّف الملف المراد استرجاعه.
google_drive/list_files
google_drive/list_files
الوصف: عرض قائمة الملفات في 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/upload_file
google_drive/upload_file
الوصف: رفع ملف إلى Google Drive.المعاملات:
name(string, مطلوب): اسم الملف المراد إنشاؤه.content(string, مطلوب): محتوى الملف المراد رفعه.mime_type(string, اختياري): نوع MIME للملف (مثال: “text/plain”, “application/pdf”).parent_folder_id(string, اختياري): معرّف المجلد الأصلي حيث يجب إنشاء الملف.description(string, اختياري): وصف الملف.
google_drive/download_file
google_drive/download_file
الوصف: تحميل ملف من Google Drive.المعاملات:
file_id(string, مطلوب): معرّف الملف المراد تحميله.mime_type(string, اختياري): نوع MIME للتصدير (مطلوب لمستندات Google Workspace).
google_drive/create_folder
google_drive/create_folder
الوصف: إنشاء مجلد جديد في Google Drive.المعاملات:
name(string, مطلوب): اسم المجلد المراد إنشاؤه.parent_folder_id(string, اختياري): معرّف المجلد الأصلي حيث يجب إنشاء المجلد الجديد.description(string, اختياري): وصف المجلد.
google_drive/delete_file
google_drive/delete_file
الوصف: حذف ملف من Google Drive.المعاملات:
file_id(string, مطلوب): معرّف الملف المراد حذفه.
google_drive/share_file
google_drive/share_file
google_drive/update_file
google_drive/update_file
الوصف: تحديث ملف موجود في Google Drive.المعاملات:
file_id(string, مطلوب): معرّف الملف المراد تحديثه.name(string, اختياري): الاسم الجديد للملف.content(string, اختياري): المحتوى الجديد للملف.mime_type(string, اختياري): نوع MIME الجديد للملف.description(string, اختياري): الوصف الجديد للملف.add_parents(string, اختياري): قائمة مفصولة بفواصل لمعرّفات المجلدات الأصلية المراد إضافتها.remove_parents(string, اختياري): قائمة مفصولة بفواصل لمعرّفات المجلدات الأصلية المراد إزالتها.
