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

نظرة عامة

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

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

قبل استخدام تكامل Gmail، تأكد من توفر ما يلي:

إعداد تكامل Gmail

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

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

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

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

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

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

الوصف: استرجاع قائمة بالرسائل.المعاملات:
  • userId (string, مطلوب): عنوان البريد الإلكتروني للمستخدم أو ‘me’ للمستخدم المصادق عليه. (الافتراضي: “me”)
  • q (string, اختياري): استعلام بحث لتصفية الرسائل (مثال: ‘from:someone@example.com is:unread’).
  • maxResults (integer, اختياري): الحد الأقصى لعدد الرسائل المُرجعة (1-500). (الافتراضي: 100)
  • pageToken (string, اختياري): رمز الصفحة لاسترجاع صفحة محددة من النتائج.
  • labelIds (array, اختياري): إرجاع الرسائل ذات التصنيفات التي تطابق جميع معرّفات التصنيف المحددة فقط.
  • includeSpamTrash (boolean, اختياري): تضمين رسائل البريد العشوائي والمحذوفات في النتائج. (الافتراضي: false)
الوصف: إرسال بريد إلكتروني.المعاملات:
  • to (string, مطلوب): عنوان البريد الإلكتروني للمستلم.
  • subject (string, مطلوب): سطر موضوع البريد الإلكتروني.
  • body (string, مطلوب): محتوى رسالة البريد الإلكتروني.
  • userId (string, اختياري): عنوان البريد الإلكتروني للمستخدم أو ‘me’ للمستخدم المصادق عليه. (الافتراضي: “me”)
  • cc (string, اختياري): عناوين نسخة كربونية (مفصولة بفواصل).
  • bcc (string, اختياري): عناوين نسخة كربونية مخفية (مفصولة بفواصل).
  • from (string, اختياري): عنوان المرسل (إذا كان مختلفاً عن المستخدم المصادق عليه).
  • replyTo (string, اختياري): عنوان الرد.
  • threadId (string, اختياري): معرّف السلسلة إذا كان الرد على محادثة موجودة.
الوصف: حذف بريد إلكتروني بواسطة المعرّف.المعاملات:
  • userId (string, مطلوب): عنوان البريد الإلكتروني للمستخدم أو ‘me’ للمستخدم المصادق عليه.
  • id (string, مطلوب): معرّف الرسالة المراد حذفها.
الوصف: إنشاء مسودة بريد إلكتروني جديدة.المعاملات:
  • userId (string, مطلوب): عنوان البريد الإلكتروني للمستخدم أو ‘me’ للمستخدم المصادق عليه.
  • message (object, مطلوب): كائن الرسالة الذي يحتوي على محتوى المسودة.
    • raw (string, مطلوب): رسالة البريد الإلكتروني بترميز base64url.
الوصف: استرجاع رسالة محددة بواسطة المعرّف.المعاملات:
  • userId (string, مطلوب): عنوان البريد الإلكتروني للمستخدم أو ‘me’ للمستخدم المصادق عليه. (الافتراضي: “me”)
  • id (string, مطلوب): معرّف الرسالة المراد استرجاعها.
  • format (string, اختياري): صيغة إرجاع الرسالة. الخيارات: “full”, “metadata”, “minimal”, “raw”. (الافتراضي: “full”)
  • metadataHeaders (array, اختياري): عند التحديد وكانت الصيغة METADATA، يتم تضمين الترويسات المحددة فقط.
الوصف: استرجاع مرفق رسالة.المعاملات:
  • userId (string, مطلوب): عنوان البريد الإلكتروني للمستخدم أو ‘me’ للمستخدم المصادق عليه. (الافتراضي: “me”)
  • messageId (string, مطلوب): معرّف الرسالة التي تحتوي على المرفق.
  • id (string, مطلوب): معرّف المرفق المراد استرجاعه.
الوصف: استرجاع سلسلة بريد إلكتروني محددة بواسطة المعرّف.المعاملات:
  • userId (string, مطلوب): عنوان البريد الإلكتروني للمستخدم أو ‘me’ للمستخدم المصادق عليه. (الافتراضي: “me”)
  • id (string, مطلوب): معرّف السلسلة المراد استرجاعها.
  • format (string, اختياري): صيغة إرجاع الرسائل. الخيارات: “full”, “metadata”, “minimal”. (الافتراضي: “full”)
  • metadataHeaders (array, اختياري): عند التحديد وكانت الصيغة METADATA، يتم تضمين الترويسات المحددة فقط.
الوصف: تعديل التصنيفات المُطبقة على سلسلة.المعاملات:
  • userId (string, مطلوب): عنوان البريد الإلكتروني للمستخدم أو ‘me’ للمستخدم المصادق عليه. (الافتراضي: “me”)
  • id (string, مطلوب): معرّف السلسلة المراد تعديلها.
  • addLabelIds (array, اختياري): قائمة بمعرّفات التصنيفات المراد إضافتها لهذه السلسلة.
  • removeLabelIds (array, اختياري): قائمة بمعرّفات التصنيفات المراد إزالتها من هذه السلسلة.
الوصف: نقل سلسلة إلى سلة المحذوفات.المعاملات:
  • userId (string, مطلوب): عنوان البريد الإلكتروني للمستخدم أو ‘me’ للمستخدم المصادق عليه. (الافتراضي: “me”)
  • id (string, مطلوب): معرّف السلسلة المراد حذفها.
الوصف: إزالة سلسلة من سلة المحذوفات.المعاملات:
  • userId (string, مطلوب): عنوان البريد الإلكتروني للمستخدم أو ‘me’ للمستخدم المصادق عليه. (الافتراضي: “me”)
  • id (string, مطلوب): معرّف السلسلة المراد استعادتها.

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

إعداد Agent أساسي لـ Gmail

تصفية أدوات Gmail محددة

البحث في البريد الإلكتروني وتحليله

إدارة السلاسل

الحصول على المساعدة

تحتاج مساعدة؟

تواصل مع فريق الدعم للحصول على المساعدة في إعداد تكامل Gmail أو استكشاف الأخطاء وإصلاحها.