> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crewai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# مشغل Gmail

> تشغيل الأتمتات عند حدوث أحداث Gmail (مثل رسائل بريد إلكتروني جديدة، تسميات).

## نظرة عامة

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

<Tip>
  تأكد من ربط Gmail في Tools & Integrations وتفعيل المشغل
  لعملية النشر.
</Tip>

## تفعيل مشغل Gmail

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

<Frame>
  <img src="https://mintcdn.com/crewai/Tp3HEbbp9mp-dy3H/images/enterprise/trigger-selected.png?fit=max&auto=format&n=Tp3HEbbp9mp-dy3H&q=85&s=10b3ee6296f323168473593b64a1e4c8" alt="تفعيل أو تعطيل المشغلات بالتبديل" width="1984" height="866" data-path="images/enterprise/trigger-selected.png" />
</Frame>

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

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

```python theme={null}
@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:

```bash theme={null}
# عرض جميع المشغلات المتاحة
crewai triggers list

# محاكاة مشغل Gmail بحمولة واقعية
crewai triggers run gmail/new_email_received
```

سينفذ أمر `crewai triggers run` طاقمك بحمولة Gmail كاملة، مما يتيح لك اختبار منطق التحليل قبل النشر.

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

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

تتبع سجل وأداء عمليات التشغيل المُشغّلة:

<Frame>
  <img src="https://mintcdn.com/crewai/Tp3HEbbp9mp-dy3H/images/enterprise/list-executions.png?fit=max&auto=format&n=Tp3HEbbp9mp-dy3H&q=85&s=be7efd03eb810139e42a10815402158d" alt="قائمة عمليات التنفيذ المُشغّلة بواسطة الأتمتة" width="1950" height="1358" data-path="images/enterprise/list-executions.png" />
</Frame>

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

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