نظرة عامة على المشغلات

​

أدلة التكامل

​

قدرات المشغلات

• الاستجابة للأحداث الفورية - تنفيذ سير العمل تلقائياً عند استيفاء شروط محددة
• التكامل مع الأنظمة الخارجية - الاتصال بمنصات مثل Gmail وOutlook وOneDrive وJIRA وSlack وStripe والمزيد
• توسيع نطاق الأتمتة - التعامل مع أحداث كبيرة الحجم دون تدخل يدوي
• الحفاظ على السياق - الوصول إلى بيانات المشغل داخل طواقمك وتدفقاتك

​

إدارة المشغلات

​

عرض المشغلات المتاحة

1. انتقل إلى عملية النشر في لوحة تحكم CrewAI
2. انقر على علامة تبويب Triggers لعرض جميع تكاملات المشغلات المتاحة

​

تفعيل وتعطيل المشغلات

• مُفعّل (تبديل أزرق): المشغل نشط وسينفذ عملية النشر تلقائياً عند حدوث الأحداث المحددة
• مُعطّل (تبديل رمادي): المشغل غير نشط ولن يستجيب للأحداث

​

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

​

بناء أتمتات مدفوعة بالمشغلات

​

قائمة فحص إعداد المشغل

• ربط التكامل تحت Tools & Integrations وإكمال خطوات OAuth أو مفتاح API
• تفعيل تبديل المشغل في عملية النشر التي يجب أن تستجيب للأحداث
• توفير متغيرات البيئة المطلوبة (رموز API، معرّفات المستأجر، الأسرار المشتركة)
• إنشاء أو تحديث المهام التي يمكنها تحليل الحمولة الواردة في أول مهمة طاقم أو خطوة تدفق
• تحديد ما إذا كنت ستمرر سياق المشغل تلقائياً باستخدام allow_crewai_trigger_context
• إعداد المراقبة — سجلات webhook وسجل تنفيذ CrewAI والتنبيهات الخارجية الاختيارية

​

اختبار المشغلات محلياً باستخدام CLI

​

عرض المشغلات المتاحة

crewai triggers list

• اسم التكامل وحالة الاتصال
• أنواع المشغلات المتاحة
• أسماء وأوصاف المشغلات

​

محاكاة تنفيذ المشغل

crewai triggers run <trigger_name>

crewai triggers run microsoft_onedrive/file_changed

• تنفيذ طاقمك محلياً
• تمرير حمولة مشغل كاملة وواقعية
• محاكاة كيفية استدعاء طاقمك في الإنتاج بالضبط

​

المشغلات مع الطاقم

@CrewBase
class MyAutomatedCrew:
    @agent
    def researcher(self) -> Agent:
        return Agent(
            config=self.agents_config['researcher'],
        )

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

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

​

التكامل مع التدفقات

​

الوصول إلى حمولة المشغل

from crewai.flow import Flow, start, listen

class MyAutomatedFlow(Flow):
    @start()
    def handle_trigger(self, crewai_trigger_payload: dict = None):
        """
        This start method can receive trigger data
        """
        if crewai_trigger_payload:
            # Process the trigger data
            trigger_id = crewai_trigger_payload.get('id')
            event_data = crewai_trigger_payload.get('payload', {})

            # Store in flow state for use by other methods
            self.state.trigger_id = trigger_id
            self.state.trigger_type = event_data

            return event_data

        # Handle manual execution
        return None

    @listen(handle_trigger)
    def process_data(self, trigger_data):
        """
        Process the data from the trigger
        """
        # ... process the trigger

​

تشغيل الطواقم من التدفقات

@start()
def delegate_to_crew(self, crewai_trigger_payload: dict = None):
    """
    Delegate processing to a specialized crew
    """
    crew = MySpecializedCrew()

    # Pass the trigger payload to the crew
    result = crew.crew().kickoff(
        inputs={
            'a_custom_parameter': "custom_value",
            'crewai_trigger_payload': crewai_trigger_payload
        },
    )

    return result

​

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

• تحقق من أن المشغل مُفعّل في علامة تبويب Triggers الخاصة بعملية النشر
• تحقق من حالة اتصال التكامل تحت Tools & Integrations
• تأكد من تهيئة جميع متغيرات البيئة المطلوبة بشكل صحيح

• تحقق من سجلات التنفيذ لتفاصيل الأخطاء
• استخدم crewai triggers run <trigger_name> للاختبار محلياً ورؤية هيكل الحمولة بالضبط
• تحقق من أن طاقمك يمكنه التعامل مع معامل crewai_trigger_payload
• تأكد من أن طاقمك لا يتوقع معاملات غير مضمنة في حمولة المشغل

• اختبر دائماً باستخدام crewai triggers run <trigger> قبل النشر لرؤية الحمولة الكاملة
• تذكر أن crewai run لا يحاكي استدعاءات المشغل — استخدم crewai triggers run بدلاً من ذلك
• استخدم crewai triggers list للتحقق من المشغلات المتاحة لتكاملاتك المتصلة
• بعد النشر، سيتلقى طاقمك حمولة المشغل الفعلية، لذا اختبر بدقة محلياً أولاً