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

نظرة عامة

استخدم مشغل Gmail لتشغيل طواقمك المنشورة عند حدوث أحداث Gmail في الحسابات المتصلة، مثل استلام رسالة بريد إلكتروني جديدة أو رسائل تطابق تسمية/فلتر.
تأكد من ربط Gmail في Tools & Integrations وتفعيل المشغل لعملية النشر.

تفعيل مشغل Gmail

  1. افتح عملية النشر في CrewAI AMP
  2. انتقل إلى علامة تبويب Triggers
  3. حدد موقع Gmail وبدّل مفتاح التبديل للتفعيل
تفعيل أو تعطيل المشغلات بالتبديل

مثال: معالجة الرسائل الجديدة

عند وصول رسالة بريد إلكتروني جديدة، سيرسل مشغل Gmail الحمولة إلى طاقمك أو تدفقك. فيما يلي مثال على طاقم يحلل ويعالج حمولة المشغل.
@CrewBase
class GmailProcessingCrew:
    @agent
    def parser(self) -> Agent:
        return Agent(
            config=self.agents_config['parser'],
        )

    @task
    def parse_gmail_payload(self) -> Task:
        return Task(
            config=self.tasks_config['parse_gmail_payload'],
            agent=self.parser(),
        )

    @task
    def act_on_email(self) -> Task:
        return Task(
            config=self.tasks_config['act_on_email'],
            agent=self.parser(),
        )
ستكون حمولة Gmail متاحة عبر آليات السياق القياسية.

الاختبار المحلي

اختبر تكامل مشغل Gmail محلياً باستخدام CrewAI CLI:
# عرض جميع المشغلات المتاحة
crewai triggers list

# محاكاة مشغل Gmail بحمولة واقعية
crewai triggers run gmail/new_email_received
سينفذ أمر crewai triggers run طاقمك بحمولة Gmail كاملة، مما يتيح لك اختبار منطق التحليل قبل النشر.
استخدم crewai triggers run gmail/new_email_received (وليس crewai run) لمحاكاة تنفيذ المشغل أثناء التطوير. بعد النشر، سيتلقى طاقمك حمولة المشغل تلقائياً.

مراقبة عمليات التنفيذ

تتبع سجل وأداء عمليات التشغيل المُشغّلة:
قائمة عمليات التنفيذ المُشغّلة بواسطة الأتمتة

استكشاف الأخطاء وإصلاحها

  • تأكد من ربط Gmail في Tools & Integrations
  • تحقق من تفعيل مشغل Gmail في علامة تبويب Triggers
  • اختبر محلياً بـ crewai triggers run gmail/new_email_received لرؤية هيكل الحمولة بالضبط
  • تحقق من سجلات التنفيذ وتأكد من تمرير الحمولة كـ crewai_trigger_payload
  • تذكر: استخدم crewai triggers run (وليس crewai run) لمحاكاة تنفيذ المشغل