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

​
شاهد: بناء Agents و Flows في CrewAI باستخدام Coding Agent Skills

قم بتثبيت مهارات وكيل البرمجة الخاصة بنا (Claude Code، Codex، …) لتشغيل وكلاء البرمجة بسرعة مع CrewAI. يمكنك تثبيتها باستخدام npx skills add crewaiinc/skills

​
فيديو تعليمي

شاهد هذا الفيديو التعليمي لعرض تفصيلي لعملية التثبيت:

​
دليل نصي

متطلبات إصدار Pythonيتطلب CrewAI إصدار Python >=3.10 and <3.14. إليك كيفية التحقق من إصدارك:
إذا كنت بحاجة لتحديث Python، قم بزيارة python.org/downloads
متطلبات OpenAI SDKيتطلب CrewAI 0.175.0 إصدار openai >= 1.13.3. إذا كنت تدير التبعيات بنفسك، تأكد من أن بيئتك تستوفي هذا الشرط لتجنب مشاكل الاستيراد/التشغيل.
يستخدم CrewAI أداة uv لإدارة التبعيات والحزم. وهي تبسّط إعداد المشروع وتنفيذه وتوفر تجربة سلسة. إذا لم تكن قد ثبّتت uv بعد، اتبع الخطوة 1 لإعدادها بسرعة على نظامك، وإلا يمكنك الانتقال إلى الخطوة 2.
1

تثبيت uv

  • على macOS/Linux: استخدم curl لتحميل السكريبت وتنفيذه عبر sh:
    إذا لم يكن curl متاحًا على نظامك، يمكنك استخدام wget:
  • على Windows: استخدم irm لتحميل السكريبت وiex لتنفيذه:
    إذا واجهت أي مشاكل، راجع دليل تثبيت UV لمزيد من المعلومات.
2

تثبيت CrewAI

  • شغّل الأمر التالي لتثبيت واجهة سطر أوامر crewai:
    إذا ظهر تحذير بشأن PATH، شغّل هذا الأمر لتحديث الصدفة:
    إذا واجهت خطأ بناء chroma-hnswlib==0.7.6 (fatal error C1083: Cannot open include file: 'float.h') على Windows، ثبّت Visual Studio Build Tools مع خيار Desktop development with C++.
  • للتحقق من تثبيت crewai، شغّل:
  • يجب أن ترى شيئًا مثل:
  • إذا كنت بحاجة لتحديث crewai، شغّل:
تم التثبيت بنجاح! أنت جاهز لإنشاء أول Crew!

​
إنشاء مشروع CrewAI

يقوم crewai create crew الآن بإنشاء مشروع crew بأسلوب JSON-first. توضع الـ Agents في agents/*.jsonc، وتوضع المهام وإعدادات الـ crew في crew.jsonc، ويحمّل crewai run هذا التعريف مباشرة.
1

إنشاء هيكل المشروع

  • شغّل أمر crewai عبر CLI:
  • سينشئ هذا مشروعًا جديدًا بالهيكل التالي:
  • إذا احتجت إلى البنية القديمة Python/YAML التي تحتوي على crew.py و config/agents.yaml و config/tasks.yaml، شغّل:
2

تخصيص مشروعك

  • سيحتوي مشروعك على هذه الملفات الأساسية:
  • ابدأ بتحرير crew.jsonc والملفات داخل agents/ لتعريف سلوك الـ crew.
  • استخدم قيم {placeholder} في نصوص الـ Agents والمهام، ثم ضع القيم الافتراضية في inputs داخل crew.jsonc. عند تشغيل crewai run ستطلب CLI أي قيم ناقصة.
  • احتفظ بالمعلومات الحساسة مثل مفاتيح API في .env.
3

تشغيل الـ Crew

  • قبل تشغيل الـ Crew، تأكد من تنفيذ:
  • إذا كنت بحاجة لتثبيت حزم إضافية، استخدم:
  • لتشغيل الـ Crew، نفّذ الأمر التالي في جذر مشروعك:

​
خيارات التثبيت للمؤسسات

للفرق والمؤسسات، يوفر CrewAI خيارات نشر مؤسسية تزيل تعقيد الإعداد:

​
CrewAI AMP (SaaS)

  • لا يتطلب أي تثبيت - فقط سجّل مجانًا على app.crewai.com
  • تحديثات وصيانة تلقائية
  • بنية تحتية مُدارة وقابلة للتوسع
  • بناء Crews بدون كتابة كود

​
CrewAI Factory (استضافة ذاتية)

  • نشر بالحاويات على بنيتك التحتية
  • يدعم أي مزود سحابي بما في ذلك النشر المحلي
  • تكامل مع أنظمة الأمان الحالية

استكشف خيارات المؤسسات

تعرّف على عروض CrewAI للمؤسسات وجدول عرضًا توضيحيًا

​
الخطوات التالية

بدء سريع: Flow + وكيل

اتبع البداية السريعة لإنشاء Flow وتشغيل طاقم بوكيل واحد وإنتاج تقرير.

انضم إلى المجتمع

تواصل مع مطورين آخرين واحصل على المساعدة وشارك تجاربك مع CrewAI.