> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crewai.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> تعرّف على كيفية استخدام واجهة سطر أوامر CrewAI للتفاعل مع CrewAI.

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

## نظرة عامة

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

## التثبيت

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

```shell Terminal theme={null}
pip install crewai
```

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

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

```shell Terminal theme={null}
crewai [COMMAND] [OPTIONS] [ARGUMENTS]
```

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

### 1. إنشاء

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

```shell Terminal theme={null}
crewai create [OPTIONS] TYPE NAME
```

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

مثال:

```shell Terminal theme={null}
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`.

#### أسماء مستعار قديمة للأعلام (مهملة)

لا تزال أعلام snake\_case القديمة تعمل، لكنها مخفية من `--help`. يُفضّل استخدام صيغ kebab-case الموثّقة في أقسام الأوامر أدناه.

| مهمل | استخدم بدلاً منه |
| :- | :- |
| `--skip_provider` (في `crewai create crew`) | `--skip-provider` |
| `--n_iterations` (في `crewai train`، `crewai test`) | `--n-iterations` |
| `--task_id` (في `crewai replay`) | `--task-id` |

### 2. الإصدار

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

```shell Terminal theme={null}
crewai version [OPTIONS]
```

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

### 3. التدريب

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

```shell Terminal theme={null}
crewai train [OPTIONS]
```

* `-n, --n-iterations INTEGER`: عدد تكرارات التدريب (افتراضي: 5)
* `-f, --filename TEXT`: مسار ملف مخصص للتدريب (افتراضي: "trained\_agents\_data.pkl")

### 4. الإعادة

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

```shell Terminal theme={null}
crewai replay [OPTIONS]
```

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

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

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

```shell Terminal theme={null}
crewai log-tasks-outputs
```

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

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

```shell Terminal theme={null}
crewai reset-memories [OPTIONS]
```

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

### 7. الاختبار

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

```shell Terminal theme={null}
crewai test [OPTIONS]
```

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

### 8. التشغيل

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

```shell Terminal theme={null}
crewai run
```

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

### 9. الدردشة

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

```shell Terminal theme={null}
crewai chat
```

> [!NOTE]
>
> مهم: عيّن خاصية `chat_llm` في تعريف الـ crew لتفعيل هذا الأمر.
>
> للـ crews بنمط JSON-first، أضفها إلى `crew.jsonc`:
>
> ```jsonc theme={null}
> {
>   "name": "My Crew",
>   "agents": ["researcher"],
>   "tasks": [],
>   "chat_llm": "openai/gpt-4o"
> }
> ```
>
> للـ crews الكلاسيكية Python/YAML، عيّنها في `crew.py`:
>
> ```python theme={null}
> @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](https://app.crewai.com).

* **المصادقة**: تحتاج لتكون مصادقًا للنشر إلى CrewAI AMP.

  ```shell Terminal theme={null}
  crewai login
  ```

* **إنشاء نشر**:
  ```shell Terminal theme={null}
  crewai deploy create
  ```
  * يرفع `--zip` المشروع كملف ZIP حتى عندما يكون له `origin` في git، دون الجلب منه.
  * عندما يكون المشروع مستودع git يحتوي على commit واحد على الأقل، فإن كل رفع ZIP، عند الإنشاء أو الدفع، يعرض الـ commit المحلي الذي بُني منه، وما إذا كان مجلد المشروع يحتوي على تغييرات غير مُثبَّتة.

* **نشر الطاقم**:
  ```shell Terminal theme={null}
  crewai deploy push
  ```
  يحافظ الدفع على المصدر المستخدم عند الإنشاء. إضافة `origin` لاحقًا لا تحوّل نشر ZIP إلى git.

* **حالة النشر**:
  ```shell Terminal theme={null}
  crewai deploy status
  ```
  يجلب هذا أحدث حالة لآخر محاولة نشر (مثل `Building Images for Crew` و`Deploy Enqueued` و`Online`). إذا فشل النشر، يعرض أيضًا الخطأ وإصلاحًا مقترحًا.

* **سجلات النشر**:
  ```shell Terminal theme={null}
  crewai deploy logs
  ```

* **عرض النشرات**:
  ```shell Terminal theme={null}
  crewai deploy list
  ```

* **حذف النشر**:
  ```shell Terminal theme={null}
  crewai deploy remove
  ```

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

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

```shell Terminal theme={null}
crewai org [COMMAND] [OPTIONS]
```

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

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

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

```shell Terminal theme={null}
crewai login
```

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

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

```shell Terminal theme={null}
crewai config [COMMAND] [OPTIONS]
```

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

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

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

```shell Terminal theme={null}
crewai traces [COMMAND]
```

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

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

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

1. **علامة صريحة في الكود** (الأولوية الأعلى):
   ```python theme={null}
   crew = Crew(agents=[...], tasks=[...], tracing=True)   # تفعيل دائمًا
   crew = Crew(agents=[...], tasks=[...], tracing=False)  # تعطيل دائمًا
   crew = Crew(agents=[...], tasks=[...])                 # فحص الأولويات الأدنى
   ```

2. **متغير البيئة** (الأولوية الثانية):
   ```env theme={null}
   CREWAI_TRACING_ENABLED=true
   ```

3. **تفضيل المستخدم** (الأولوية الأدنى):
   ```shell Terminal theme={null}
   crewai traces enable
   ```
   * يحدّث موجه التشغيل الأول (`Would you like to view your execution traces?`) هذا التفضيل أيضاً

> [!NOTE]
>
> **لتفعيل التتبع**، استخدم أيًا من هذه الطرق:
>
> * عيّن `tracing=True` في كود الطاقم/التدفق، أو
> * أضف `CREWAI_TRACING_ENABLED=true` إلى ملف `.env`، أو
> * شغّل `crewai traces enable`
>
> **لتعطيل التتبع**، استخدم أيًا من هذه الطرق:
>
> * عيّن `tracing=False` في كود الطاقم/التدفق، أو
> * أزل أو عيّن `false` لمتغير `CREWAI_TRACING_ENABLED`، أو
> * شغّل `crewai traces disable`

> [!TIP]
>
> يتعامل CrewAI CLI مع المصادقة لمستودع الأدوات تلقائيًا عند
> إضافة حزم إلى مشروعك. فقط أضف `crewai` قبل أي أمر `uv`
> لاستخدامه. مثلًا `crewai uv add requests`.

> [!NOTE]
>
> تُخزن إعدادات التهيئة في `~/.config/crewai/settings.json`. بعض
> الإعدادات مثل اسم المؤسسة ومعرّفها للقراءة فقط وتُدار من خلال
> أوامر المصادقة والمؤسسة.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.