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

نظرة عامة

بمجرد نشر طاقمك على منصة CrewAI AMP، يمكنك بدء عمليات التنفيذ عبر واجهة الويب أو API. يغطي هذا الدليل كلا النهجين.

الطريقة 1: استخدام واجهة الويب

الخطوة 1: الانتقال إلى طاقمك المنشور

  1. سجّل الدخول إلى CrewAI AMP
  2. انقر على اسم الطاقم من قائمة مشاريعك
  3. ستنتقل إلى صفحة تفاصيل الطاقم
لوحة تحكم الطاقم

الخطوة 2: بدء التنفيذ

من صفحة تفاصيل طاقمك، لديك خياران لبدء التنفيذ:

الخيار أ: التشغيل السريع

  1. انقر على رابط Kickoff في قسم Test Endpoints
  2. أدخل معاملات الإدخال المطلوبة لطاقمك في محرر JSON
  3. انقر على زر Send Request
نقطة نهاية التشغيل

الخيار ب: استخدام الواجهة المرئية

  1. انقر على علامة تبويب Run في صفحة تفاصيل الطاقم
  2. أدخل المدخلات المطلوبة في حقول النموذج
  3. انقر على زر Run Crew
تشغيل الطاقم

الخطوة 3: مراقبة تقدم التنفيذ

بعد بدء التنفيذ:
  1. ستتلقى استجابة تحتوي على kickoff_id - انسخ هذا المعرّف
  2. هذا المعرّف ضروري لتتبع تنفيذك
نسخ معرّف المهمة

الخطوة 4: التحقق من حالة التنفيذ

لمراقبة تقدم تنفيذك:
  1. انقر على نقطة نهاية “Status” في قسم Test Endpoints
  2. الصق kickoff_id في الحقل المخصص
  3. انقر على زر “Get Status”
الحصول على الحالة
ستعرض استجابة الحالة:
  • حالة التنفيذ الحالية (running، completed، إلخ.)
  • تفاصيل حول المهام الجارية
  • أي مخرجات أُنتجت حتى الآن

الخطوة 5: عرض النتائج النهائية

بمجرد اكتمال التنفيذ:
  1. ستتغير الحالة إلى completed
  2. يمكنك عرض نتائج ومخرجات التنفيذ الكاملة
  3. لعرض أكثر تفصيلاً، تحقق من علامة تبويب Executions في صفحة تفاصيل الطاقم

الطريقة 2: استخدام API

يمكنك أيضاً تشغيل الطواقم برمجياً باستخدام REST API لـ CrewAI AMP.

المصادقة

جميع طلبات API تتطلب رمز حامل للمصادقة:
رمز الحامل متاح في علامة تبويب Status في صفحة تفاصيل طاقمك.

التحقق من صحة الطاقم

قبل تنفيذ العمليات، يمكنك التحقق من أن طاقمك يعمل بشكل صحيح:
ستعيد الاستجابة الناجحة رسالة تشير إلى أن الطاقم يعمل:

الخطوة 1: استرداد المدخلات المطلوبة

أولاً، حدد المدخلات التي يتطلبها طاقمك:
ستكون الاستجابة كائن JSON يحتوي على مصفوفة من معاملات الإدخال المطلوبة، على سبيل المثال:
يوضح هذا المثال أن هذا الطاقم المحدد يتطلب مدخلين: topic وcurrent_year.

الخطوة 2: بدء التنفيذ

ابدأ التنفيذ بتقديم المدخلات المطلوبة:
ستتضمن الاستجابة kickoff_id الذي ستحتاجه للتتبع:

الخطوة 3: التحقق من حالة التنفيذ

استخدم kickoff_id للحصول على حالة التنفيذ:
تعرض الاستجابة حالة التنفيذ والتقدم والنتيجة. أرسل الطلب مرة أخرى للحصول على استجابة جديدة. هذا مثال على استجابة لطاقم قيد التشغيل:

حقول الاستجابة

الحقل الذي ليس له قيمة يكون null.

التقدم

يعرض كائن progress مقدار العمل المكتمل. يختار التدفق الخطوة التالية أثناء التشغيل. عدد الخطوات غير معروف قبل توقف التدفق. في التدفق تكون قيمة total وremaining دائمًا null:
لا تحسب نسبة مئوية للتدفق. اعرض قيمة completed كعدد للخطوات.

الأحداث

يعرض الحدث ما قام به التنفيذ في وقت محدد. كل حدث هو ملخص. لا يحتوي الحدث على المطالبات (prompts) أو النواتج أو حالة التدفق. تحتفظ قائمة events بأحدث 100 حدث. إذا أرسل التنفيذ أحداثًا أكثر، تحذف المنصة أقدم الأحداث من القائمة. يعطي الحقل events_count عدد كل الأحداث. ويحسب الحقل events_by_type كل الأحداث أيضًا. يبقى هذان الحقلان صحيحين عندما تمتلئ القائمة.

الإسناد

يعرض كائن triggered_by من بدأ التنفيذ. تعطي الاستجابة النوع والمعرّف فقط. ولا تعطي الاسم أو عنوان البريد الإلكتروني أو المؤسسة. يمكن لكل رمز (token) خاص بالنشر أن يقرأ حالة كل تنفيذ في ذلك النشر. لا تتضمن الاستجابة بيانات شخصية. إذا استخدم الطلب رمز AUTH_TOKEN الثابت الخاص بالنشر، يكون النوع unknown. وإذا لم تعرف المنصة الهوية، تكون قيمة triggered_by هي null.

مصدر التنفيذ

يعرض الحقل execution_origin كيف بدأ التنفيذ.

إعدادات اختيارية

اضبط متغيرات البيئة التالية في النشر لتغيير سجل الأحداث.
تنطبق هذه الحدود:
  • النشر الذي يعمل بإصدار crewAI 1.15.21 أو أقدم يعطي null لبيانات التقدم ولبيانات الأحداث. حدّث إصدار crewAI في مشروعك، ثم انشر الطاقم مرة أخرى.
  • التنفيذ الذي ينتظر في الطابور تكون حالته PENDING. وهو يعطي null للحقل triggered_by.
  • التدفق الذي يتابع بعد التغذية الراجعة البشرية يحسب الخطوات بعد التغذية الراجعة فقط.
  • الاستجابة التي تحتوي على "source": "application" تعطي null لبيانات التقدم ولبيانات الأحداث.

التعامل مع عمليات التنفيذ

عمليات التنفيذ طويلة المدة

لعمليات التنفيذ التي قد تستغرق وقتاً طويلاً:
  1. فكّر في تنفيذ آلية استعلام دوري للتحقق من الحالة بشكل دوري
  2. استخدم webhooks (إذا كانت متاحة) للإشعار عند اكتمال التنفيذ
  3. نفّذ معالجة الأخطاء للمهلات الزمنية المحتملة

سياق التنفيذ

يتضمن سياق التنفيذ:
  • المدخلات المقدمة عند التشغيل
  • متغيرات البيئة المُهيأة أثناء النشر
  • أي حالة محفوظة بين المهام

تصحيح أخطاء عمليات التنفيذ الفاشلة

إذا فشل التنفيذ:
  1. تحقق من علامة تبويب “Executions” للسجلات المفصلة
  2. راجع علامة تبويب “Traces” لتفاصيل التنفيذ خطوة بخطوة
  3. ابحث عن استجابات LLM واستخدام الأدوات في تفاصيل التتبع

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

تواصل مع فريق الدعم للمساعدة في مشاكل التنفيذ أو أسئلة حول منصة Enterprise.