واجهة سطر الأوامر

نظرة عامة

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

التثبيت

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

pip install crewai

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

الهيكل الأساسي لأمر CrewAI CLI هو:

crewai [COMMAND] [OPTIONS] [ARGUMENTS]

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

1. إنشاء

إنشاء طاقم أو تدفق جديد.

crewai create [OPTIONS] TYPE NAME

TYPE: اختر بين “crew” أو “flow”
NAME: اسم الطاقم أو التدفق

مثال:

crewai create crew my_new_crew
crewai create flow my_new_flow

افتراضيًا، ينشئ crewai create crew مشروعًا JSON-first يحتوي على crew.jsonc و agents/*.jsonc. استخدم crewai create crew my_new_crew --classic فقط إذا أردت البنية القديمة Python/YAML مع crew.py و config/agents.yaml و config/tasks.yaml.

2. الإصدار

عرض الإصدار المثبت من CrewAI.

crewai version [OPTIONS]

--tools: (اختياري) عرض الإصدار المثبت من أدوات CrewAI

3. التدريب

تدريب الطاقم لعدد محدد من التكرارات.

crewai train [OPTIONS]

-n, --n_iterations INTEGER: عدد تكرارات التدريب (افتراضي: 5)
-f, --filename TEXT: مسار ملف مخصص للتدريب (افتراضي: “trained_agents_data.pkl”)

4. الإعادة

إعادة تنفيذ الطاقم من مهمة محددة.

crewai replay [OPTIONS]

-t, --task_id TEXT: إعادة تنفيذ الطاقم من معرّف المهمة هذا، بما في ذلك جميع المهام اللاحقة

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

استرجاع أحدث مخرجات مهام crew.kickoff().

crewai log-tasks-outputs

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

إعادة تعيين ذاكرة الطاقم (طويلة، قصيرة، الكيانات، أحدث مخرجات التشغيل).

crewai reset-memories [OPTIONS]

-l, --long: إعادة تعيين الذاكرة طويلة المدى
-s, --short: إعادة تعيين الذاكرة قصيرة المدى
-e, --entities: إعادة تعيين ذاكرة الكيانات
-k, --kickoff-outputs: إعادة تعيين أحدث مخرجات التشغيل
-kn, --knowledge: إعادة تعيين تخزين المعرفة
-akn, --agent-knowledge: إعادة تعيين تخزين معرفة الوكيل
-a, --all: إعادة تعيين جميع الذاكرات

7. الاختبار

اختبار الطاقم وتقييم النتائج.

crewai test [OPTIONS]

-n, --n_iterations INTEGER: عدد تكرارات الاختبار (افتراضي: 3)
-m, --model TEXT: نموذج LLM لتشغيل الاختبارات (افتراضي: “gpt-4o-mini”)

8. التشغيل

تشغيل الطاقم أو التدفق.

crewai run

9. الدردشة

بدءًا من الإصدار 0.98.0، عند تشغيل أمر crewai chat، تبدأ جلسة تفاعلية مع طاقمك. سيرشدك المساعد الذكي بطلب المدخلات اللازمة لتنفيذ الطاقم. بمجرد توفير جميع المدخلات، سينفذ الطاقم مهامه.

crewai chat

Note

مهم: عيّن خاصية chat_llm في تعريف الـ crew لتفعيل هذا الأمر.

للـ crews بنمط JSON-first، أضفها إلى crew.jsonc:

{
  "name": "My Crew",
  "agents": ["researcher"],
  "tasks": [],
  "chat_llm": "openai/gpt-4o"
}

للـ crews الكلاسيكية Python/YAML، عيّنها في 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 window
```
crewai login
```
إنشاء نشر:
Terminal window
```
crewai deploy create
```
نشر الطاقم:
Terminal window
```
crewai deploy push
```
حالة النشر:
Terminal window
```
crewai deploy status
```
سجلات النشر:
Terminal window
```
crewai deploy logs
```
عرض النشرات:
Terminal window
```
crewai deploy list
```
حذف النشر:
Terminal window
```
crewai deploy remove
```

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

إدارة مؤسسات CrewAI AMP.

crewai org [COMMAND] [OPTIONS]

list: عرض جميع المؤسسات
current: عرض المؤسسة النشطة حاليًا
switch: التبديل إلى مؤسسة محددة

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

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

crewai login

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

إدارة إعدادات تهيئة CLI لـ CrewAI.

crewai config [COMMAND] [OPTIONS]

list: عرض جميع معاملات التهيئة
set: تعيين معامل تهيئة
reset: إعادة تعيين جميع المعاملات إلى القيم الافتراضية

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

إدارة تفضيلات جمع التتبع لعمليات الطاقم والتدفق.

crewai traces [COMMAND]

enable: تفعيل جمع التتبع
disable: تعطيل جمع التتبع
status: عرض حالة جمع التتبع الحالية

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

يتم التحكم في جمع التتبع بفحص ثلاثة إعدادات بترتيب الأولوية:

علامة صريحة في الكود (الأولوية الأعلى):

crew = Crew(agents=[...], tasks=[...], tracing=True)   # تفعيل دائمًا
crew = Crew(agents=[...], tasks=[...], tracing=False)  # تعطيل دائمًا
crew = Crew(agents=[...], tasks=[...])                 # فحص الأولويات الأدنى

متغير البيئة (الأولوية الثانية):
```
CREWAI_TRACING_ENABLED=true
```
تفضيل المستخدم (الأولوية الأدنى):
Terminal window
```
crewai traces enable
```