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

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

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

​
دليل نصي

متطلبات إصدار Pythonيتطلب CrewAI إصدار Python >=3.10 and <3.14. إليك كيفية التحقق من إصدارك:
python3 --version
إذا كنت بحاجة لتحديث 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 -LsSf https://astral.sh/uv/install.sh | sh
    إذا لم يكن curl متاحًا على نظامك، يمكنك استخدام wget: 
    wget -qO- https://astral.sh/uv/install.sh | sh
  • على Windows: استخدم irm لتحميل السكريبت وiex لتنفيذه: 
    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
    إذا واجهت أي مشاكل، راجع دليل تثبيت UV لمزيد من المعلومات.
2

تثبيت CrewAI

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

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

نوصي باستخدام قالب YAML لنهج منظم في تعريف الـ Agents والمهام. إليك كيفية البدء:
1

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

  • شغّل أمر crewai عبر CLI: 
    crewai create crew <your_project_name>
  • سينشئ هذا مشروعًا جديدًا بالهيكل التالي: 
    my_project/
├── .gitignore
├── knowledge/
├── pyproject.toml
├── README.md
├── .env
└── src/
    └── my_project/
        ├── __init__.py
        ├── main.py
        ├── crew.py
        ├── tools/
        │   ├── custom_tool.py
        │   └── __init__.py
        └── config/
            ├── agents.yaml
            └── tasks.yaml
2

تخصيص مشروعك

  • سيحتوي مشروعك على هذه الملفات الأساسية:
    الملفالغرض
    agents.yamlتعريف الـ Agents وأدوارهم
    tasks.yamlإعداد مهام الـ Agents وسير العمل
    .envتخزين مفاتيح API ومتغيرات البيئة
    main.pyنقطة دخول المشروع وتدفق التنفيذ
    crew.pyتنسيق وإدارة الـ Crew
    tools/مجلد الأدوات المخصصة
    knowledge/مجلد قاعدة المعرفة
  • ابدأ بتحرير agents.yaml وtasks.yaml لتعريف سلوك الـ Crew.
  • احتفظ بالمعلومات الحساسة مثل مفاتيح API في .env.
3

تشغيل الـ Crew

  • قبل تشغيل الـ Crew، تأكد من تنفيذ: 
    crewai install
  • إذا كنت بحاجة لتثبيت حزم إضافية، استخدم: 
    uv add <package-name>
  • لتشغيل الـ Crew، نفّذ الأمر التالي في جذر مشروعك: 
    crewai run

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

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

​
CrewAI AMP (SaaS)

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

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

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

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

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

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

ابنِ أول Agent لك

اتبع دليل البداية السريعة لإنشاء أول Agent في CrewAI والحصول على تجربة عملية.

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

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