واجهة برمجة تطبيقات CrewAI AMP
مرحبًا بك في مرجع واجهة برمجة تطبيقات CrewAI AMP. تتيح لك هذه الواجهة التفاعل برمجيًا مع الأطقم المنشورة، مما يمكّنك من دمجها مع تطبيقاتك وسير عملك وخدماتك.البدء السريع
1
الحصول على بيانات اعتماد API
انتقل إلى صفحة تفاصيل طاقمك في لوحة تحكم CrewAI AMP وانسخ رمز Bearer من علامة تبويب الحالة.
2
اكتشاف المدخلات المطلوبة
استخدم نقطة النهاية
GET /inputs لمعرفة المعاملات التي يتوقعها طاقمك.3
بدء تنفيذ الطاقم
استدعِ
POST /kickoff مع مدخلاتك لبدء تنفيذ الطاقم واستلام
kickoff_id.4
مراقبة التقدم
استخدم
GET /status/{kickoff_id} للتحقق من حالة التنفيذ واسترجاع النتائج.المصادقة
تتطلب جميع طلبات API المصادقة باستخدام رمز Bearer. أدرج رمزك في ترويسةAuthorization:
أنواع الرموز
عنوان URL الأساسي
لكل طاقم منشور نقطة نهاية API فريدة خاصة به:your-crew-name بعنوان URL الفعلي لطاقمك من لوحة التحكم.
سير العمل النموذجي
- الاكتشاف: استدعِ
GET /inputsلفهم ما يحتاجه طاقمك - التنفيذ: أرسل المدخلات عبر
POST /kickoffلبدء المعالجة - المراقبة: استعلم عن
GET /status/{kickoff_id}حتى الاكتمال - النتائج: استخرج المخرجات النهائية من الاستجابة المكتملة
معالجة الأخطاء
تستخدم الواجهة أكواد حالة HTTP القياسية:الاختبار التفاعلي
لماذا لا يوجد زر “إرسال”؟ نظرًا لأن كل مستخدم CrewAI AMP لديه عنوان URL
فريد للطاقم، نستخدم وضع المرجع بدلاً من بيئة تفاعلية لتجنب
الالتباس. يوضح لك هذا بالضبط كيف يجب أن تبدو الطلبات بدون
أزرار إرسال غير فعالة.
- تنسيق الطلب الدقيق مع جميع المعاملات
- أمثلة الاستجابة لحالات النجاح والخطأ
- عينات الكود بلغات متعددة (cURL، Python، JavaScript، إلخ)
- أمثلة المصادقة بتنسيق رمز Bearer الصحيح
لاختبار واجهتك الفعلية:
نسخ أمثلة cURL
انسخ أمثلة cURL واستبدل العنوان URL + الرمز بقيمك الحقيقية
استخدام Postman/Insomnia
استورد الأمثلة في أداة اختبار API المفضلة لديك
- انسخ مثال cURL هذا من أي صفحة نقطة نهاية
- استبدل
your-actual-crew-name.crewai.comبعنوان URL الحقيقي لطاقمك - استبدل رمز Bearer برمزك الحقيقي من لوحة التحكم
- نفّذ الطلب في طرفيتك أو عميل API
هل تحتاج مساعدة؟
دعم المؤسسات
احصل على مساعدة في تكامل API واستكشاف الأخطاء وإصلاحها
لوحة تحكم المؤسسات
إدارة أطقمك وعرض سجلات التنفيذ