الانتقال إلى المحتوى الرئيسي
منذ الإصدار 0.140.0، بدأ CrewAI AMP عملية نقل مزود تسجيل الدخول. لذلك، تم تحديث تدفق المصادقة عبر CLI. المستخدمون الذين يسجلون الدخول باستخدام Google، أو الذين أنشأوا حساباتهم بعد 3 يوليو 2025 لن يتمكنوا من تسجيل الدخول مع الإصدارات القديمة من مكتبة crewai.

​
نظرة عامة

توفر واجهة سطر أوامر CrewAI مجموعة من الأوامر للتفاعل مع CrewAI، مما يتيح لك إنشاء وتدريب وتشغيل وإدارة الأطقم والتدفقات.

​
التثبيت

لاستخدام واجهة سطر أوامر CrewAI، تأكد من تثبيت CrewAI:
Terminal
pip install crewai

​
الاستخدام الأساسي

الهيكل الأساسي لأمر CrewAI CLI هو:
Terminal
crewai [COMMAND] [OPTIONS] [ARGUMENTS]

​
الأوامر المتاحة

​
1. إنشاء

إنشاء طاقم أو تدفق جديد.
Terminal
crewai create [OPTIONS] TYPE NAME
  • TYPE: اختر بين “crew” أو “flow”
  • NAME: اسم الطاقم أو التدفق
مثال:
Terminal
crewai create crew my_new_crew
crewai create flow my_new_flow

​
2. الإصدار

عرض الإصدار المثبت من CrewAI.
Terminal
crewai version [OPTIONS]
  • --tools: (اختياري) عرض الإصدار المثبت من أدوات CrewAI

​
3. التدريب

تدريب الطاقم لعدد محدد من التكرارات.
Terminal
crewai train [OPTIONS]
  • -n, --n_iterations INTEGER: عدد تكرارات التدريب (افتراضي: 5)
  • -f, --filename TEXT: مسار ملف مخصص للتدريب (افتراضي: “trained_agents_data.pkl”)

​
4. الإعادة

إعادة تنفيذ الطاقم من مهمة محددة.
Terminal
crewai replay [OPTIONS]
  • -t, --task_id TEXT: إعادة تنفيذ الطاقم من معرّف المهمة هذا، بما في ذلك جميع المهام اللاحقة

​
5. سجل مخرجات المهام

استرجاع أحدث مخرجات مهام crew.kickoff().
Terminal
crewai log-tasks-outputs

​
6. إعادة تعيين الذاكرة

إعادة تعيين ذاكرة الطاقم (طويلة، قصيرة، الكيانات، أحدث مخرجات التشغيل).
Terminal
crewai reset-memories [OPTIONS]
  • -l, --long: إعادة تعيين الذاكرة طويلة المدى
  • -s, --short: إعادة تعيين الذاكرة قصيرة المدى
  • -e, --entities: إعادة تعيين ذاكرة الكيانات
  • -k, --kickoff-outputs: إعادة تعيين أحدث مخرجات التشغيل
  • -kn, --knowledge: إعادة تعيين تخزين المعرفة
  • -akn, --agent-knowledge: إعادة تعيين تخزين معرفة الوكيل
  • -a, --all: إعادة تعيين جميع الذاكرات

​
7. الاختبار

اختبار الطاقم وتقييم النتائج.
Terminal
crewai test [OPTIONS]
  • -n, --n_iterations INTEGER: عدد تكرارات الاختبار (افتراضي: 3)
  • -m, --model TEXT: نموذج LLM لتشغيل الاختبارات (افتراضي: “gpt-4o-mini”)

​
8. التشغيل

تشغيل الطاقم أو التدفق.
Terminal
crewai run
بدءًا من الإصدار 0.103.0، يمكن استخدام أمر crewai run لتشغيل كل من الأطقم القياسية والتدفقات. للتدفقات، يكتشف تلقائيًا النوع من pyproject.toml ويشغّل الأمر المناسب. هذه هي الطريقة الموصى بها لتشغيل كل من الأطقم والتدفقات.

​
9. الدردشة

بدءًا من الإصدار 0.98.0، عند تشغيل أمر crewai chat، تبدأ جلسة تفاعلية مع طاقمك. سيرشدك المساعد الذكي بطلب المدخلات اللازمة لتنفيذ الطاقم. بمجرد توفير جميع المدخلات، سينفذ الطاقم مهامه.
Terminal
crewai chat
مهم: عيّن خاصية chat_llm في ملف crew.py لتفعيل هذا الأمر.
@crew
def crew(self) -> Crew:
    return Crew(
        agents=self.agents,
        tasks=self.tasks,
        process=Process.sequential,
        verbose=True,
        chat_llm="gpt-4o",
    )

​
10. النشر

نشر الطاقم أو التدفق إلى CrewAI AMP.
  • المصادقة: تحتاج لتكون مصادقًا للنشر إلى CrewAI AMP.
    Terminal
    crewai login
  • إنشاء نشر:
    Terminal
    crewai deploy create
  • نشر الطاقم:
    Terminal
    crewai deploy push
  • حالة النشر:
    Terminal
    crewai deploy status
  • سجلات النشر:
    Terminal
    crewai deploy logs
  • عرض النشرات:
    Terminal
    crewai deploy list
  • حذف النشر:
    Terminal
    crewai deploy remove

​
11. إدارة المؤسسة

إدارة مؤسسات CrewAI AMP.
Terminal
crewai org [COMMAND] [OPTIONS]
  • list: عرض جميع المؤسسات
  • current: عرض المؤسسة النشطة حاليًا
  • switch: التبديل إلى مؤسسة محددة

​
12. تسجيل الدخول

المصادقة مع CrewAI AMP باستخدام تدفق رمز الجهاز الآمن.
Terminal
crewai login

​
13. إدارة التهيئة

إدارة إعدادات تهيئة CLI لـ CrewAI.
Terminal
crewai config [COMMAND] [OPTIONS]
  • list: عرض جميع معاملات التهيئة
  • set: تعيين معامل تهيئة
  • reset: إعادة تعيين جميع المعاملات إلى القيم الافتراضية

​
14. إدارة التتبع

إدارة تفضيلات جمع التتبع لعمليات الطاقم والتدفق.
Terminal
crewai traces [COMMAND]
  • enable: تفعيل جمع التتبع
  • disable: تعطيل جمع التتبع
  • status: عرض حالة جمع التتبع الحالية

​
كيف يعمل التتبع

يتم التحكم في جمع التتبع بفحص ثلاثة إعدادات بترتيب الأولوية:
  1. علامة صريحة في الكود (الأولوية الأعلى): 
    crew = Crew(agents=[...], tasks=[...], tracing=True)   # تفعيل دائمًا
crew = Crew(agents=[...], tasks=[...], tracing=False)  # تعطيل دائمًا
crew = Crew(agents=[...], tasks=[...])                 # فحص الأولويات الأدنى
  2. متغير البيئة (الأولوية الثانية): 
    CREWAI_TRACING_ENABLED=true
  3. تفضيل المستخدم (الأولوية الأدنى):
    Terminal
    crewai traces enable
لتفعيل التتبع، استخدم أيًا من هذه الطرق:
  • عيّن tracing=True في كود الطاقم/التدفق، أو
  • أضف CREWAI_TRACING_ENABLED=true إلى ملف .env، أو
  • شغّل crewai traces enable
لتعطيل التتبع، استخدم أيًا من هذه الطرق:
  • عيّن tracing=False في كود الطاقم/التدفق، أو
  • أزل أو عيّن false لمتغير CREWAI_TRACING_ENABLED، أو
  • شغّل crewai traces disable
يتعامل CrewAI CLI مع المصادقة لمستودع الأدوات تلقائيًا عند إضافة حزم إلى مشروعك. فقط أضف crewai قبل أي أمر uv لاستخدامه. مثلًا crewai uv add requests.
تُخزن إعدادات التهيئة في ~/.config/crewai/settings.json. بعض الإعدادات مثل اسم المؤسسة ومعرّفها للقراءة فقط وتُدار من خلال أوامر المصادقة والمؤسسة.