نظرة عامة
مكّن وكلاءك من إدارة رسائل البريد الإلكتروني وجهات الاتصال والمسودات عبر Gmail. أرسل رسائل البريد الإلكتروني، وابحث في الرسائل، وأدر جهات الاتصال، وأنشئ المسودات، وبسّط اتصالات البريد الإلكتروني باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.المتطلبات الأساسية
قبل استخدام تكامل Gmail، تأكد من توفر ما يلي:- حساب CrewAI AMP مع اشتراك فعّال
- حساب Gmail بالصلاحيات المناسبة
- ربط حساب Gmail الخاص بك عبر صفحة التكاملات
إعداد تكامل Gmail
1. ربط حساب Gmail الخاص بك
- انتقل إلى تكاملات CrewAI AMP
- ابحث عن Gmail في قسم تكاملات المصادقة
- انقر على Connect وأكمل عملية OAuth
- امنح الصلاحيات اللازمة لإدارة البريد الإلكتروني وجهات الاتصال
- انسخ رمز المؤسسة من إعدادات التكامل
2. تثبيت الحزمة المطلوبة
3. إعداد متغير البيئة
لاستخدام التكاملات مع
Agent(apps=[]), يجب تعيين متغير البيئة
CREWAI_PLATFORM_INTEGRATION_TOKEN برمز المؤسسة الخاص بك..env:
الإجراءات المتاحة
gmail/fetch_emails
gmail/fetch_emails
الوصف: استرجاع قائمة بالرسائل.المعاملات:
userId(string, مطلوب): عنوان البريد الإلكتروني للمستخدم أو ‘me’ للمستخدم المصادق عليه. (الافتراضي: “me”)q(string, اختياري): استعلام بحث لتصفية الرسائل (مثال: ‘from:someone@example.com is:unread’).maxResults(integer, اختياري): الحد الأقصى لعدد الرسائل المُرجعة (1-500). (الافتراضي: 100)pageToken(string, اختياري): رمز الصفحة لاسترجاع صفحة محددة من النتائج.labelIds(array, اختياري): إرجاع الرسائل ذات التصنيفات التي تطابق جميع معرّفات التصنيف المحددة فقط.includeSpamTrash(boolean, اختياري): تضمين رسائل البريد العشوائي والمحذوفات في النتائج. (الافتراضي: false)
gmail/send_email
gmail/send_email
الوصف: إرسال بريد إلكتروني.المعاملات:
to(string, مطلوب): عنوان البريد الإلكتروني للمستلم.subject(string, مطلوب): سطر موضوع البريد الإلكتروني.body(string, مطلوب): محتوى رسالة البريد الإلكتروني.userId(string, اختياري): عنوان البريد الإلكتروني للمستخدم أو ‘me’ للمستخدم المصادق عليه. (الافتراضي: “me”)cc(string, اختياري): عناوين نسخة كربونية (مفصولة بفواصل).bcc(string, اختياري): عناوين نسخة كربونية مخفية (مفصولة بفواصل).from(string, اختياري): عنوان المرسل (إذا كان مختلفاً عن المستخدم المصادق عليه).replyTo(string, اختياري): عنوان الرد.threadId(string, اختياري): معرّف السلسلة إذا كان الرد على محادثة موجودة.
gmail/delete_email
gmail/delete_email
الوصف: حذف بريد إلكتروني بواسطة المعرّف.المعاملات:
userId(string, مطلوب): عنوان البريد الإلكتروني للمستخدم أو ‘me’ للمستخدم المصادق عليه.id(string, مطلوب): معرّف الرسالة المراد حذفها.
gmail/create_draft
gmail/create_draft
الوصف: إنشاء مسودة بريد إلكتروني جديدة.المعاملات:
userId(string, مطلوب): عنوان البريد الإلكتروني للمستخدم أو ‘me’ للمستخدم المصادق عليه.message(object, مطلوب): كائن الرسالة الذي يحتوي على محتوى المسودة.raw(string, مطلوب): رسالة البريد الإلكتروني بترميز base64url.
gmail/get_message
gmail/get_message
الوصف: استرجاع رسالة محددة بواسطة المعرّف.المعاملات:
userId(string, مطلوب): عنوان البريد الإلكتروني للمستخدم أو ‘me’ للمستخدم المصادق عليه. (الافتراضي: “me”)id(string, مطلوب): معرّف الرسالة المراد استرجاعها.format(string, اختياري): صيغة إرجاع الرسالة. الخيارات: “full”, “metadata”, “minimal”, “raw”. (الافتراضي: “full”)metadataHeaders(array, اختياري): عند التحديد وكانت الصيغة METADATA، يتم تضمين الترويسات المحددة فقط.
gmail/get_attachment
gmail/get_attachment
الوصف: استرجاع مرفق رسالة.المعاملات:
userId(string, مطلوب): عنوان البريد الإلكتروني للمستخدم أو ‘me’ للمستخدم المصادق عليه. (الافتراضي: “me”)messageId(string, مطلوب): معرّف الرسالة التي تحتوي على المرفق.id(string, مطلوب): معرّف المرفق المراد استرجاعه.
gmail/fetch_thread
gmail/fetch_thread
الوصف: استرجاع سلسلة بريد إلكتروني محددة بواسطة المعرّف.المعاملات:
userId(string, مطلوب): عنوان البريد الإلكتروني للمستخدم أو ‘me’ للمستخدم المصادق عليه. (الافتراضي: “me”)id(string, مطلوب): معرّف السلسلة المراد استرجاعها.format(string, اختياري): صيغة إرجاع الرسائل. الخيارات: “full”, “metadata”, “minimal”. (الافتراضي: “full”)metadataHeaders(array, اختياري): عند التحديد وكانت الصيغة METADATA، يتم تضمين الترويسات المحددة فقط.
gmail/modify_thread
gmail/modify_thread
الوصف: تعديل التصنيفات المُطبقة على سلسلة.المعاملات:
userId(string, مطلوب): عنوان البريد الإلكتروني للمستخدم أو ‘me’ للمستخدم المصادق عليه. (الافتراضي: “me”)id(string, مطلوب): معرّف السلسلة المراد تعديلها.addLabelIds(array, اختياري): قائمة بمعرّفات التصنيفات المراد إضافتها لهذه السلسلة.removeLabelIds(array, اختياري): قائمة بمعرّفات التصنيفات المراد إزالتها من هذه السلسلة.
gmail/trash_thread
gmail/trash_thread
الوصف: نقل سلسلة إلى سلة المحذوفات.المعاملات:
userId(string, مطلوب): عنوان البريد الإلكتروني للمستخدم أو ‘me’ للمستخدم المصادق عليه. (الافتراضي: “me”)id(string, مطلوب): معرّف السلسلة المراد حذفها.
gmail/untrash_thread
gmail/untrash_thread
الوصف: إزالة سلسلة من سلة المحذوفات.المعاملات:
userId(string, مطلوب): عنوان البريد الإلكتروني للمستخدم أو ‘me’ للمستخدم المصادق عليه. (الافتراضي: “me”)id(string, مطلوب): معرّف السلسلة المراد استعادتها.
أمثلة الاستخدام
إعداد Agent أساسي لـ Gmail
تصفية أدوات Gmail محددة
البحث في البريد الإلكتروني وتحليله
إدارة السلاسل
الحصول على المساعدة
تحتاج مساعدة؟
تواصل مع فريق الدعم للحصول على المساعدة في إعداد تكامل Gmail أو
استكشاف الأخطاء وإصلاحها.
