mirror of
https://github.com/crewAIInc/crewAI.git
synced 2026-08-13 01:38:41 +00:00
11890e6701
Some checks failed
CodeQL Advanced / Analyze (actions) (push) Has been cancelled
CodeQL Advanced / Analyze (python) (push) Has been cancelled
Check Documentation Broken Links / Check broken links (push) Has been cancelled
Vulnerability Scan / Detect changes (push) Has been cancelled
Vulnerability Scan / pip-audit (push) Has been cancelled
Build uv cache / build-cache (3.10) (push) Has been cancelled
Build uv cache / build-cache (3.11) (push) Has been cancelled
Build uv cache / build-cache (3.12) (push) Has been cancelled
Build uv cache / build-cache (3.13) (push) Has been cancelled
* Standardize CLI flags to kebab-case with deprecated snake_case aliases. Unify active long-option naming across create, train, test, and replay while keeping hidden backward-compatible aliases and documenting the migration in edge docs and AGENTS.md. * Emit deprecation warnings when snake_case CLI flag aliases are used. Route hidden legacy flags through separate internal params so warnings fire only when the alias is supplied, and extend CLI tests for create, replay, and --help coverage. * Merge CLI deprecation warn helpers into warn_deprecated(kind=...). Replace warn_deprecated_command and warn_deprecated_flag with one helper that accepts kind="command" or kind="flag".
313 lines
9.3 KiB
Plaintext
313 lines
9.3 KiB
Plaintext
---
|
|
title: واجهة سطر الأوامر
|
|
description: تعرّف على كيفية استخدام واجهة سطر أوامر CrewAI للتفاعل مع CrewAI.
|
|
icon: terminal
|
|
mode: "wide"
|
|
---
|
|
|
|
<Warning>
|
|
منذ الإصدار 0.140.0، بدأ CrewAI AMP عملية نقل مزود تسجيل الدخول.
|
|
لذلك، تم تحديث تدفق المصادقة عبر CLI. المستخدمون الذين يسجلون الدخول
|
|
باستخدام Google، أو الذين أنشأوا حساباتهم بعد 3 يوليو 2025 لن يتمكنوا
|
|
من تسجيل الدخول مع الإصدارات القديمة من مكتبة `crewai`.
|
|
</Warning>
|
|
|
|
## نظرة عامة
|
|
|
|
توفر واجهة سطر أوامر CrewAI مجموعة من الأوامر للتفاعل مع CrewAI، مما يتيح لك إنشاء وتدريب وتشغيل وإدارة الأطقم والتدفقات.
|
|
|
|
## التثبيت
|
|
|
|
لاستخدام واجهة سطر أوامر CrewAI، تأكد من تثبيت CrewAI:
|
|
|
|
```shell Terminal
|
|
pip install crewai
|
|
```
|
|
|
|
## الاستخدام الأساسي
|
|
|
|
الهيكل الأساسي لأمر CrewAI CLI هو:
|
|
|
|
```shell Terminal
|
|
crewai [COMMAND] [OPTIONS] [ARGUMENTS]
|
|
```
|
|
|
|
## الأوامر المتاحة
|
|
|
|
### 1. إنشاء
|
|
|
|
إنشاء طاقم أو تدفق جديد.
|
|
|
|
```shell Terminal
|
|
crewai create [OPTIONS] TYPE NAME
|
|
```
|
|
|
|
- `TYPE`: اختر بين "crew" أو "flow"
|
|
- `NAME`: اسم الطاقم أو التدفق
|
|
|
|
مثال:
|
|
|
|
```shell Terminal
|
|
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
|
|
crewai version [OPTIONS]
|
|
```
|
|
|
|
- `--tools`: (اختياري) عرض الإصدار المثبت من أدوات CrewAI
|
|
|
|
### 3. التدريب
|
|
|
|
تدريب الطاقم لعدد محدد من التكرارات.
|
|
|
|
```shell Terminal
|
|
crewai train [OPTIONS]
|
|
```
|
|
|
|
- `-n, --n-iterations INTEGER`: عدد تكرارات التدريب (افتراضي: 5)
|
|
- `-f, --filename TEXT`: مسار ملف مخصص للتدريب (افتراضي: "trained_agents_data.pkl")
|
|
|
|
### 4. الإعادة
|
|
|
|
إعادة تنفيذ الطاقم من مهمة محددة.
|
|
|
|
```shell Terminal
|
|
crewai replay [OPTIONS]
|
|
```
|
|
|
|
- `-t, --task-id TEXT`: إعادة تنفيذ الطاقم من معرّف المهمة هذا، بما في ذلك جميع المهام اللاحقة
|
|
|
|
### 5. سجل مخرجات المهام
|
|
|
|
استرجاع أحدث مخرجات مهام crew.kickoff().
|
|
|
|
```shell Terminal
|
|
crewai log-tasks-outputs
|
|
```
|
|
|
|
### 6. إعادة تعيين الذاكرة
|
|
|
|
إعادة تعيين ذاكرة الطاقم (طويلة، قصيرة، الكيانات، أحدث مخرجات التشغيل).
|
|
|
|
```shell Terminal
|
|
crewai reset-memories [OPTIONS]
|
|
```
|
|
|
|
- `-l, --long`: إعادة تعيين الذاكرة طويلة المدى
|
|
- `-s, --short`: إعادة تعيين الذاكرة قصيرة المدى
|
|
- `-e, --entities`: إعادة تعيين ذاكرة الكيانات
|
|
- `-k, --kickoff-outputs`: إعادة تعيين أحدث مخرجات التشغيل
|
|
- `-kn, --knowledge`: إعادة تعيين تخزين المعرفة
|
|
- `-akn, --agent-knowledge`: إعادة تعيين تخزين معرفة الوكيل
|
|
- `-a, --all`: إعادة تعيين جميع الذاكرات
|
|
|
|
### 7. الاختبار
|
|
|
|
اختبار الطاقم وتقييم النتائج.
|
|
|
|
```shell Terminal
|
|
crewai test [OPTIONS]
|
|
```
|
|
|
|
- `-n, --n-iterations INTEGER`: عدد تكرارات الاختبار (افتراضي: 3)
|
|
- `-m, --model TEXT`: نموذج LLM لتشغيل الاختبارات (افتراضي: "gpt-4o-mini")
|
|
|
|
### 8. التشغيل
|
|
|
|
تشغيل الطاقم أو التدفق.
|
|
|
|
```shell Terminal
|
|
crewai run
|
|
```
|
|
|
|
<Note>
|
|
بدءًا من الإصدار 0.103.0، يمكن استخدام أمر `crewai run` لتشغيل
|
|
كل من الأطقم القياسية والتدفقات. للتدفقات، يكتشف تلقائيًا النوع
|
|
من pyproject.toml ويشغّل الأمر المناسب. هذه هي الطريقة الموصى بها
|
|
لتشغيل كل من الأطقم والتدفقات.
|
|
</Note>
|
|
|
|
### 9. الدردشة
|
|
|
|
بدءًا من الإصدار `0.98.0`، عند تشغيل أمر `crewai chat`، تبدأ جلسة تفاعلية مع طاقمك. سيرشدك المساعد الذكي بطلب المدخلات اللازمة لتنفيذ الطاقم. بمجرد توفير جميع المدخلات، سينفذ الطاقم مهامه.
|
|
|
|
```shell Terminal
|
|
crewai chat
|
|
```
|
|
|
|
<Note>
|
|
مهم: عيّن خاصية `chat_llm` في تعريف الـ crew لتفعيل هذا الأمر.
|
|
|
|
للـ crews بنمط JSON-first، أضفها إلى `crew.jsonc`:
|
|
|
|
```jsonc
|
|
{
|
|
"name": "My Crew",
|
|
"agents": ["researcher"],
|
|
"tasks": [],
|
|
"chat_llm": "openai/gpt-4o"
|
|
}
|
|
```
|
|
|
|
للـ crews الكلاسيكية Python/YAML، عيّنها في `crew.py`:
|
|
|
|
```python
|
|
@crew
|
|
def crew(self) -> Crew:
|
|
return Crew(
|
|
agents=self.agents,
|
|
tasks=self.tasks,
|
|
process=Process.sequential,
|
|
verbose=True,
|
|
chat_llm="gpt-4o",
|
|
)
|
|
```
|
|
</Note>
|
|
|
|
### 10. النشر
|
|
|
|
نشر الطاقم أو التدفق إلى [CrewAI AMP](https://app.crewai.com).
|
|
|
|
- **المصادقة**: تحتاج لتكون مصادقًا للنشر إلى CrewAI AMP.
|
|
|
|
```shell Terminal
|
|
crewai login
|
|
```
|
|
|
|
- **إنشاء نشر**:
|
|
```shell Terminal
|
|
crewai deploy create
|
|
```
|
|
|
|
- **نشر الطاقم**:
|
|
```shell Terminal
|
|
crewai deploy push
|
|
```
|
|
|
|
- **حالة النشر**:
|
|
```shell Terminal
|
|
crewai deploy status
|
|
```
|
|
|
|
- **سجلات النشر**:
|
|
```shell Terminal
|
|
crewai deploy logs
|
|
```
|
|
|
|
- **عرض النشرات**:
|
|
```shell Terminal
|
|
crewai deploy list
|
|
```
|
|
|
|
- **حذف النشر**:
|
|
```shell Terminal
|
|
crewai deploy remove
|
|
```
|
|
|
|
### 11. إدارة المؤسسة
|
|
|
|
إدارة مؤسسات CrewAI AMP.
|
|
|
|
```shell Terminal
|
|
crewai org [COMMAND] [OPTIONS]
|
|
```
|
|
|
|
- `list`: عرض جميع المؤسسات
|
|
- `current`: عرض المؤسسة النشطة حاليًا
|
|
- `switch`: التبديل إلى مؤسسة محددة
|
|
|
|
### 12. تسجيل الدخول
|
|
|
|
المصادقة مع CrewAI AMP باستخدام تدفق رمز الجهاز الآمن.
|
|
|
|
```shell Terminal
|
|
crewai login
|
|
```
|
|
|
|
### 13. إدارة التهيئة
|
|
|
|
إدارة إعدادات تهيئة CLI لـ CrewAI.
|
|
|
|
```shell Terminal
|
|
crewai config [COMMAND] [OPTIONS]
|
|
```
|
|
|
|
- `list`: عرض جميع معاملات التهيئة
|
|
- `set`: تعيين معامل تهيئة
|
|
- `reset`: إعادة تعيين جميع المعاملات إلى القيم الافتراضية
|
|
|
|
### 14. إدارة التتبع
|
|
|
|
إدارة تفضيلات جمع التتبع لعمليات الطاقم والتدفق.
|
|
|
|
```shell Terminal
|
|
crewai traces [COMMAND]
|
|
```
|
|
|
|
- `enable`: تفعيل جمع التتبع
|
|
- `disable`: تعطيل جمع التتبع
|
|
- `status`: عرض حالة جمع التتبع الحالية
|
|
|
|
#### كيف يعمل التتبع
|
|
|
|
يتم التحكم في جمع التتبع بفحص ثلاثة إعدادات بترتيب الأولوية:
|
|
|
|
1. **علامة صريحة في الكود** (الأولوية الأعلى):
|
|
```python
|
|
crew = Crew(agents=[...], tasks=[...], tracing=True) # تفعيل دائمًا
|
|
crew = Crew(agents=[...], tasks=[...], tracing=False) # تعطيل دائمًا
|
|
crew = Crew(agents=[...], tasks=[...]) # فحص الأولويات الأدنى
|
|
```
|
|
|
|
2. **متغير البيئة** (الأولوية الثانية):
|
|
```env
|
|
CREWAI_TRACING_ENABLED=true
|
|
```
|
|
|
|
3. **تفضيل المستخدم** (الأولوية الأدنى):
|
|
```shell Terminal
|
|
crewai traces enable
|
|
```
|
|
|
|
<Note>
|
|
**لتفعيل التتبع**، استخدم أيًا من هذه الطرق:
|
|
- عيّن `tracing=True` في كود الطاقم/التدفق، أو
|
|
- أضف `CREWAI_TRACING_ENABLED=true` إلى ملف `.env`، أو
|
|
- شغّل `crewai traces enable`
|
|
|
|
**لتعطيل التتبع**، استخدم أيًا من هذه الطرق:
|
|
- عيّن `tracing=False` في كود الطاقم/التدفق، أو
|
|
- أزل أو عيّن `false` لمتغير `CREWAI_TRACING_ENABLED`، أو
|
|
- شغّل `crewai traces disable`
|
|
</Note>
|
|
|
|
<Tip>
|
|
يتعامل CrewAI CLI مع المصادقة لمستودع الأدوات تلقائيًا عند
|
|
إضافة حزم إلى مشروعك. فقط أضف `crewai` قبل أي أمر `uv`
|
|
لاستخدامه. مثلًا `crewai uv add requests`.
|
|
</Tip>
|
|
|
|
<Note>
|
|
تُخزن إعدادات التهيئة في `~/.config/crewai/settings.json`. بعض
|
|
الإعدادات مثل اسم المؤسسة ومعرّفها للقراءة فقط وتُدار من خلال
|
|
أوامر المصادقة والمؤسسة.
|
|
</Note>
|