تخطَّ إلى المحتوى
توثيق CrewAI

التثبيت

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

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

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

يمكنك تثبيتها باستخدام npx skills add crewaiinc/skills

فيديو تعليمي

Section titled “فيديو تعليمي”

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

دليل نصي

Section titled “دليل نصي”

يستخدم CrewAI أداة uv لإدارة التبعيات والحزم. وهي تبسّط إعداد المشروع وتنفيذه وتوفر تجربة سلسة.

إذا لم تكن قد ثبّتت uv بعد، اتبع الخطوة 1 لإعدادها بسرعة على نظامك، وإلا يمكنك الانتقال إلى الخطوة 2.

  1. تثبيت uv

    • على macOS/Linux:

      استخدم curl لتحميل السكريبت وتنفيذه عبر sh:

      Terminal window
      curl -LsSf https://astral.sh/uv/install.sh | sh

      إذا لم يكن curl متاحًا على نظامك، يمكنك استخدام wget:

      Terminal window
      wget -qO- https://astral.sh/uv/install.sh | sh

    • على Windows:

      استخدم irm لتحميل السكريبت وiex لتنفيذه:

      Terminal window
      powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

      إذا واجهت أي مشاكل، راجع دليل تثبيت UV لمزيد من المعلومات.

  2. تثبيت CrewAI

    • شغّل الأمر التالي لتثبيت واجهة سطر أوامر crewai:

      Terminal window
      uv tool install crewai

    • للتحقق من تثبيت crewai، شغّل:

      Terminal window
      uv tool list

    • يجب أن ترى شيئًا مثل:

      Terminal window
      crewai v0.102.0
      - crewai

    • إذا كنت بحاجة لتحديث crewai، شغّل:

      Terminal window
      uv tool install crewai --upgrade

إنشاء مشروع CrewAI

Section titled “إنشاء مشروع CrewAI”

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

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

    • شغّل أمر crewai عبر CLI:

      Terminal window
      crewai create crew <your_project_name>

    • سينشئ هذا مشروعًا جديدًا بالهيكل التالي:

      my_project/
      ├── .gitignore
      ├── .env
      ├── agents/
      │   └── researcher.jsonc
      ├── crew.jsonc
      ├── knowledge/
      ├── pyproject.toml
      ├── README.md
      ├── skills/
      └── tools/

    • إذا احتجت إلى البنية القديمة Python/YAML التي تحتوي على crew.py و config/agents.yaml و config/tasks.yaml، شغّل:

      Terminal window
      crewai create crew <your_project_name> --classic
  2. تخصيص مشروعك

    • سيحتوي مشروعك على هذه الملفات الأساسية:

      الملفالغرض
      crew.jsoncإعداد الـ crew وترتيب المهام والعملية وقيم الإدخال الافتراضية
      agents/*.jsoncتعريف دور كل Agent وهدفه و backstory والـ LLM والأدوات والسلوك
      .envتخزين مفاتيح API ومتغيرات البيئة
      tools/ملفات Python اختيارية لأدوات custom:<name>
      knowledge/ملفات معرفة اختيارية للـ Agents
      skills/ملفات skills اختيارية تطبق على الـ crew

    • ابدأ بتحرير crew.jsonc والملفات داخل agents/ لتعريف سلوك الـ crew.

    • استخدم قيم {placeholder} في نصوص الـ Agents والمهام، ثم ضع القيم الافتراضية في inputs داخل crew.jsonc. عند تشغيل crewai run ستطلب CLI أي قيم ناقصة.

    • احتفظ بالمعلومات الحساسة مثل مفاتيح API في .env.

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

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

Section titled “خيارات التثبيت للمؤسسات”

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

Section titled “الخطوات التالية”

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

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

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

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