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

# تشغيل الطاقم

> تشغيل طاقم على CrewAI AMP

## نظرة عامة

بمجرد نشر طاقمك على منصة CrewAI AMP، يمكنك بدء عمليات التنفيذ عبر واجهة الويب أو API. يغطي هذا الدليل كلا النهجين.

## الطريقة 1: استخدام واجهة الويب

### الخطوة 1: الانتقال إلى طاقمك المنشور

1. سجّل الدخول إلى [CrewAI AMP](https://app.crewai.com)
2. انقر على اسم الطاقم من قائمة مشاريعك
3. ستنتقل إلى صفحة تفاصيل الطاقم

<Frame>
  <img src="https://mintcdn.com/crew-ai-platform-docs/PsPgimrfKBcwyL9_/images/platform/crew-dashboard.png?fit=max&auto=format&n=PsPgimrfKBcwyL9_&q=85&s=22c8bb2aba9564b10c94e1aafc46368d" alt="لوحة تحكم الطاقم" width="1492" height="872" data-path="images/platform/crew-dashboard.png" />
</Frame>

### الخطوة 2: بدء التنفيذ

من صفحة تفاصيل طاقمك، لديك خياران لبدء التنفيذ:

#### الخيار أ: التشغيل السريع

1. انقر على رابط `Kickoff` في قسم Test Endpoints
2. أدخل معاملات الإدخال المطلوبة لطاقمك في محرر JSON
3. انقر على زر `Send Request`

<Frame>
  <img src="https://mintcdn.com/crew-ai-platform-docs/PsPgimrfKBcwyL9_/images/platform/kickoff-endpoint.png?fit=max&auto=format&n=PsPgimrfKBcwyL9_&q=85&s=01c208e483add575dee2828da2a509ed" alt="نقطة نهاية التشغيل" width="2794" height="1390" data-path="images/platform/kickoff-endpoint.png" />
</Frame>

#### الخيار ب: استخدام الواجهة المرئية

1. انقر على علامة تبويب `Run` في صفحة تفاصيل الطاقم
2. أدخل المدخلات المطلوبة في حقول النموذج
3. انقر على زر `Run Crew`

<Frame>
  <img src="https://mintcdn.com/crew-ai-platform-docs/yxGoL_P6iQdNCtRQ/images/platform/run-crew.png?fit=max&auto=format&n=yxGoL_P6iQdNCtRQ&q=85&s=29b6ef46cb1e23bc03e6d6856a69b14b" alt="تشغيل الطاقم" width="2808" height="1764" data-path="images/platform/run-crew.png" />
</Frame>

### الخطوة 3: مراقبة تقدم التنفيذ

بعد بدء التنفيذ:

1. ستتلقى استجابة تحتوي على `kickoff_id` - **انسخ هذا المعرّف**
2. هذا المعرّف ضروري لتتبع تنفيذك

<Frame>
  <img src="https://mintcdn.com/crew-ai-platform-docs/PsPgimrfKBcwyL9_/images/platform/copy-task-id.png?fit=max&auto=format&n=PsPgimrfKBcwyL9_&q=85&s=27508c86c74d2654e54840e9203c1ad5" alt="نسخ معرّف المهمة" width="2790" height="1040" data-path="images/platform/copy-task-id.png" />
</Frame>

### الخطوة 4: التحقق من حالة التنفيذ

لمراقبة تقدم تنفيذك:

1. انقر على نقطة نهاية "Status" في قسم Test Endpoints
2. الصق `kickoff_id` في الحقل المخصص
3. انقر على زر "Get Status"

<Frame>
  <img src="https://mintcdn.com/crew-ai-platform-docs/PsPgimrfKBcwyL9_/images/platform/get-status.png?fit=max&auto=format&n=PsPgimrfKBcwyL9_&q=85&s=05e3609494c0e75d12519f273892ad50" alt="الحصول على الحالة" width="2774" height="452" data-path="images/platform/get-status.png" />
</Frame>

ستعرض استجابة الحالة:

* حالة التنفيذ الحالية (`running`، `completed`، إلخ.)
* تفاصيل حول المهام الجارية
* أي مخرجات أُنتجت حتى الآن

### الخطوة 5: عرض النتائج النهائية

بمجرد اكتمال التنفيذ:

1. ستتغير الحالة إلى `completed`
2. يمكنك عرض نتائج ومخرجات التنفيذ الكاملة
3. لعرض أكثر تفصيلاً، تحقق من علامة تبويب `Executions` في صفحة تفاصيل الطاقم

## الطريقة 2: استخدام API

يمكنك أيضاً تشغيل الطواقم برمجياً باستخدام REST API لـ CrewAI AMP.

### المصادقة

جميع طلبات API تتطلب رمز حامل للمصادقة:

```bash theme={null}
curl -H "Authorization: Bearer YOUR_CREW_TOKEN" https://your-crew-url.crewai.com
```

رمز الحامل متاح في علامة تبويب Status في صفحة تفاصيل طاقمك.

### التحقق من صحة الطاقم

قبل تنفيذ العمليات، يمكنك التحقق من أن طاقمك يعمل بشكل صحيح:

```bash theme={null}
curl -H "Authorization: Bearer YOUR_CREW_TOKEN" https://your-crew-url.crewai.com
```

ستعيد الاستجابة الناجحة رسالة تشير إلى أن الطاقم يعمل:

```
Healthy%
```

### الخطوة 1: استرداد المدخلات المطلوبة

أولاً، حدد المدخلات التي يتطلبها طاقمك:

```bash theme={null}
curl -X GET \
  -H "Authorization: Bearer YOUR_CREW_TOKEN" \
  https://your-crew-url.crewai.com/inputs
```

ستكون الاستجابة كائن JSON يحتوي على مصفوفة من معاملات الإدخال المطلوبة، على سبيل المثال:

```json theme={null}
{ "inputs": ["topic", "current_year"] }
```

يوضح هذا المثال أن هذا الطاقم المحدد يتطلب مدخلين: `topic` و`current_year`.

### الخطوة 2: بدء التنفيذ

ابدأ التنفيذ بتقديم المدخلات المطلوبة:

```bash theme={null}
curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_CREW_TOKEN" \
  -d '{"inputs": {"topic": "AI Agent Frameworks", "current_year": "2025"}}' \
  https://your-crew-url.crewai.com/kickoff
```

ستتضمن الاستجابة `kickoff_id` الذي ستحتاجه للتتبع:

```json theme={null}
{ "kickoff_id": "abcd1234-5678-90ef-ghij-klmnopqrstuv" }
```

### الخطوة 3: التحقق من حالة التنفيذ

استخدم `kickoff_id` للحصول على حالة التنفيذ:

```bash theme={null}
curl -X GET \
  -H "Authorization: Bearer YOUR_CREW_TOKEN" \
  https://your-crew-url.crewai.com/status/abcd1234-5678-90ef-ghij-klmnopqrstuv
```

تعرض الاستجابة حالة التنفيذ والتقدم والنتيجة. أرسل الطلب مرة أخرى للحصول على استجابة جديدة.

هذا مثال على استجابة لطاقم قيد التشغيل:

```json theme={null}
{
  "state": "RUNNING",
  "status": "Task is Running",
  "progress": {
    "unit": "task",
    "completed": 1,
    "total": 3,
    "remaining": 2,
    "current": "write_report",
    "current_agent": "Researcher",
    "started_at": "2025-09-10T18:00:00+00:00",
    "updated_at": "2025-09-10T18:02:14+00:00",
    "duration_seconds": 134.0
  },
  "last_event": {
    "type": "tool_usage_started",
    "timestamp": "2025-09-10T18:02:14+00:00",
    "tool_name": "SerperDevTool",
    "agent_role": "Researcher"
  },
  "events_count": 24,
  "events_by_type": {
    "crew_kickoff_started": 1,
    "task_started": 2,
    "agent_execution_started": 2,
    "tool_usage_started": 3
  },
  "triggered_by": { "type": "user", "id": "4711" },
  "execution_origin": "api",
  "source": "memory"
}
```

#### حقول الاستجابة

| الحقل | الوصف |
| - | - |
| `state` | حالة التنفيذ: `PENDING` أو `STARTED` أو `RUNNING` أو `SUCCESS` أو `FAILED` أو `PAUSED` أو `REVOKED`. |
| `status` | رسالة قصيرة عن الحالة. |
| `result` | الناتج النهائي. يبقى الحقل فارغًا حتى يتوقف التنفيذ. |
| `result_json` | الناتج النهائي بصيغة JSON، إذا كان الناتج كائن JSON. |
| `usage_metrics` | عدد الرموز (tokens) للتنفيذ. |
| `progress` | مقدار العمل المكتمل. راجع [التقدم](#التقدم). |
| `last_event` | أحدث حدث. راجع [الأحداث](#الأحداث). |
| `events` | أحدث الأحداث. يأتي أقدم حدث أولًا. |
| `events_count` | عدد الأحداث التي أرسلها التنفيذ. |
| `events_by_type` | عدد الأحداث لكل نوع. |
| `triggered_by` | الهوية التي بدأت التنفيذ. راجع [الإسناد](#الإسناد). |
| `execution_origin` | مصدر الطلب. راجع [مصدر التنفيذ](#مصدر-التنفيذ). |
| `last_step` | أحدث خطوة للوكيل. للطواقم فقط. |
| `last_executed_task` | أحدث مهمة أكملها الطاقم. للطواقم فقط. |
| `flow_id` | معرّف التدفق الذي ينتظر تغذية راجعة بشرية. |
| `source` | مصدر البيانات: `memory` أو `application`. |

الحقل الذي ليس له قيمة يكون `null`.

#### التقدم

يعرض كائن `progress` مقدار العمل المكتمل.

| الحقل | الوصف |
| - | - |
| `unit` | وحدة العمل. يستخدم الطاقم `task`. ويستخدم التدفق `step`. |
| `completed` | عدد الوحدات المكتملة. |
| `total` | عدد الوحدات في التنفيذ. |
| `remaining` | عدد الوحدات غير المكتملة. |
| `current` | اسم المهمة أو الدالة التي تعمل الآن. |
| `current_agent` | دور الوكيل الذي يعمل الآن. |
| `started_at` | وقت بدء العامل (worker) للتنفيذ. |
| `updated_at` | وقت أحدث تغيير. |
| `duration_seconds` | عدد الثواني من البداية حتى `updated_at`. |

يختار التدفق الخطوة التالية أثناء التشغيل. عدد الخطوات غير معروف قبل توقف التدفق. في التدفق تكون قيمة `total` و`remaining` دائمًا `null`:

```json theme={null}
{
  "unit": "step",
  "completed": 4,
  "total": null,
  "remaining": null,
  "current": "summarize",
  "current_agent": null,
  "started_at": "2025-09-10T18:00:00+00:00",
  "updated_at": "2025-09-10T18:00:41+00:00",
  "duration_seconds": 41.2
}
```

<Warning>
  لا تحسب نسبة مئوية للتدفق. اعرض قيمة `completed` كعدد للخطوات.
</Warning>

#### الأحداث

يعرض الحدث ما قام به التنفيذ في وقت محدد. كل حدث هو ملخص. لا يحتوي الحدث على المطالبات (prompts) أو النواتج أو حالة التدفق.

| الحقل | الوصف |
| - | - |
| `type` | نوع الحدث، مثل `task_started`. |
| `timestamp` | وقت الحدث. |
| `crew_name` | اسم الطاقم، إذا كان الحدث يحتوي عليه. |
| `flow_name` | اسم التدفق، إذا كان الحدث يحتوي عليه. |
| `method_name` | اسم دالة التدفق، إذا كان الحدث يحتوي عليه. |
| `task_name` | اسم المهمة، إذا كان الحدث يحتوي عليه. |
| `agent_role` | دور الوكيل، إذا كان الحدث يحتوي عليه. |
| `tool_name` | اسم الأداة، إذا كان الحدث يحتوي عليه. |
| `model` | اسم النموذج، إذا كان الحدث يحتوي عليه. |
| `error` | رسالة الخطأ، إذا كان الحدث يحتوي عليها. |

تحتفظ قائمة `events` بأحدث 100 حدث. إذا أرسل التنفيذ أحداثًا أكثر، تحذف المنصة أقدم الأحداث من القائمة. يعطي الحقل `events_count` عدد كل الأحداث. ويحسب الحقل `events_by_type` كل الأحداث أيضًا. يبقى هذان الحقلان صحيحين عندما تمتلئ القائمة.

#### الإسناد

يعرض كائن `triggered_by` من بدأ التنفيذ.

| الحقل | الوصف |
| - | - |
| `type` | نوع الهوية: `user` أو `service_account` أو `unknown`. |
| `id` | معرّف الهوية في CrewAI AMP. |

تعطي الاستجابة النوع والمعرّف فقط. ولا تعطي الاسم أو عنوان البريد الإلكتروني أو المؤسسة. يمكن لكل رمز (token) خاص بالنشر أن يقرأ حالة كل تنفيذ في ذلك النشر. لا تتضمن الاستجابة بيانات شخصية.

إذا استخدم الطلب رمز `AUTH_TOKEN` الثابت الخاص بالنشر، يكون النوع `unknown`. وإذا لم تعرف المنصة الهوية، تكون قيمة `triggered_by` هي `null`.

#### مصدر التنفيذ

يعرض الحقل `execution_origin` كيف بدأ التنفيذ.

| القيمة | الوصف |
| - | - |
| `ui` | بدأ مستخدم التنفيذ من واجهة CrewAI AMP. |
| `schedule` | بدأ جدول زمني التنفيذ. |
| `trigger` | بدأ مشغّل أتمتة التنفيذ. |
| `chat` | بدأت رسالة محادثة التنفيذ. |
| `hitl-resume` | تابعت المنصة التنفيذ بعد التغذية الراجعة البشرية. |
| `replay` | بدأت إعادة تشغيل التنفيذ. |
| `api` | بدأ طلب إلى واجهة برمجة تطبيقات النشر التنفيذ. |

#### إعدادات اختيارية

اضبط متغيرات البيئة التالية في النشر لتغيير سجل الأحداث.

| المتغير | القيمة الافتراضية | الوصف |
| - | - | - |
| `CREWAI_STATUS_EVENTS` | `true` | اضبط القيمة على `false` لإيقاف سجل الأحداث وبيانات التقدم. |
| `CREWAI_STATUS_MAX_EVENTS` | `100` | عدد الأحداث في قائمة `events`. |
| `CREWAI_STATUS_EVENT_FLUSH_SECONDS` | `2.0` | أقل عدد من الثواني بين عمليتي كتابة لسجل الأحداث. |

<Note>
  تنطبق هذه الحدود:

  * النشر الذي يعمل بإصدار crewAI 1.15.21 أو أقدم يعطي `null` لبيانات التقدم ولبيانات الأحداث. حدّث إصدار crewAI في مشروعك، ثم انشر الطاقم مرة أخرى.
  * التنفيذ الذي ينتظر في الطابور تكون حالته `PENDING`. وهو يعطي `null` للحقل `triggered_by`.
  * التدفق الذي يتابع بعد التغذية الراجعة البشرية يحسب الخطوات بعد التغذية الراجعة فقط.
  * الاستجابة التي تحتوي على `"source": "application"` تعطي `null` لبيانات التقدم ولبيانات الأحداث.
</Note>

## التعامل مع عمليات التنفيذ

### عمليات التنفيذ طويلة المدة

لعمليات التنفيذ التي قد تستغرق وقتاً طويلاً:

1. فكّر في تنفيذ آلية استعلام دوري للتحقق من الحالة بشكل دوري
2. استخدم webhooks (إذا كانت متاحة) للإشعار عند اكتمال التنفيذ
3. نفّذ معالجة الأخطاء للمهلات الزمنية المحتملة

### سياق التنفيذ

يتضمن سياق التنفيذ:

* المدخلات المقدمة عند التشغيل
* متغيرات البيئة المُهيأة أثناء النشر
* أي حالة محفوظة بين المهام

### تصحيح أخطاء عمليات التنفيذ الفاشلة

إذا فشل التنفيذ:

1. تحقق من علامة تبويب "Executions" للسجلات المفصلة
2. راجع علامة تبويب "Traces" لتفاصيل التنفيذ خطوة بخطوة
3. ابحث عن استجابات LLM واستخدام الأدوات في تفاصيل التتبع

<Card title="تحتاج مساعدة؟" icon="headset" href="mailto:support@crewai.com">
  تواصل مع فريق الدعم للمساعدة في مشاكل التنفيذ أو أسئلة حول
  منصة Enterprise.
</Card>


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