> ## 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.

# سير عمل HITL

> تعلم كيفية تنفيذ سير عمل Human-In-The-Loop في CrewAI لتعزيز اتخاذ القرار

Human-In-The-Loop (HITL) هو نهج قوي يجمع بين الذكاء الاصطناعي والخبرة البشرية لتعزيز اتخاذ القرار وتحسين نتائج المهام. يوضح هذا الدليل كيفية تنفيذ HITL داخل CrewAI Enterprise.

## نهجا HITL في CrewAI

يقدم CrewAI نهجين لتنفيذ سير عمل Human-In-The-Loop:

| النهج                                          | الأفضل لـ                                                                          | الإصدار        |
| ---------------------------------------------- | ---------------------------------------------------------------------------------- | -------------- |
| **قائم على التدفق** (مُزخرف `@human_feedback`) | الإنتاج مع واجهة Enterprise، سير عمل البريد الإلكتروني أولاً، ميزات المنصة الكاملة | **1.8.0+**     |
| **قائم على Webhook**                           | التكاملات المخصصة، الأنظمة الخارجية (Slack، Teams، إلخ.)، الإعدادات القديمة        | جميع الإصدارات |

## HITL القائم على التدفق مع منصة Enterprise

<Note>
  يتطلب مُزخرف `@human_feedback` **إصدار CrewAI 1.8.0 أو أعلى**.
</Note>

عند استخدام مُزخرف `@human_feedback` في تدفقاتك، يوفر CrewAI Enterprise **نظام HITL يعتمد على البريد الإلكتروني أولاً** يمكّن أي شخص لديه عنوان بريد إلكتروني من الاستجابة لطلبات المراجعة:

<CardGroup cols={2}>
  <Card title="تصميم البريد الإلكتروني أولاً" icon="envelope">
    يتلقى المستجيبون إشعارات بريد إلكتروني ويمكنهم الرد مباشرة — لا حاجة لتسجيل الدخول.
  </Card>

  <Card title="مراجعة من لوحة التحكم" icon="desktop">
    راجع واستجب لطلبات HITL في لوحة تحكم Enterprise عند التفضيل.
  </Card>

  <Card title="توجيه مرن" icon="route">
    وجّه الطلبات إلى عناوين بريد محددة بناءً على أنماط الدوال أو استخراجها من حالة التدفق.
  </Card>

  <Card title="استجابة تلقائية" icon="clock">
    هيّئ استجابات احتياطية تلقائية عندما لا يرد أي شخص خلال المهلة الزمنية.
  </Card>
</CardGroup>

### الفوائد الرئيسية

* **مستجيبون خارجيون**: أي شخص لديه بريد إلكتروني يمكنه الاستجابة، حتى غير مستخدمي المنصة
* **تعيين ديناميكي**: استخراج بريد المُعيَّن من حالة التدفق (مثل `account_owner_email`)
* **تهيئة بسيطة**: التوجيه عبر البريد الإلكتروني أسهل في الإعداد من إدارة المستخدمين/الأدوار
* **احتياطي منشئ النشر**: إذا لم تتطابق قاعدة توجيه، يتم إخطار منشئ النشر

<Tip>
  لتفاصيل التنفيذ حول مُزخرف `@human_feedback`، راجع دليل [التغذية الراجعة البشرية في التدفقات](/ar/learn/human-feedback-in-flows).
</Tip>

## إعداد سير عمل HITL القائم على Webhook

للتكاملات المخصصة مع الأنظمة الخارجية مثل Slack وMicrosoft Teams أو تطبيقاتك الخاصة، يمكنك استخدام النهج القائم على Webhook:

<Steps>
  <Step title="تهيئة المهمة">
    هيّئ مهمتك مع تفعيل الإدخال البشري:

    <Frame>
      <img src="https://mintcdn.com/crewai/5SZbe87tsCWZY09V/images/enterprise/crew-human-input.png?fit=max&auto=format&n=5SZbe87tsCWZY09V&q=85&s=cb2e2bab131e9eff86b0c51dceb16e11" alt="إدخال بشري للطاقم" width="624" height="165" data-path="images/enterprise/crew-human-input.png" />
    </Frame>
  </Step>

  <Step title="تقديم رابط Webhook">
    عند تشغيل طاقمك، أضف رابط webhook للإدخال البشري:

    <Frame>
      <img src="https://mintcdn.com/crewai/5SZbe87tsCWZY09V/images/enterprise/crew-webhook-url.png?fit=max&auto=format&n=5SZbe87tsCWZY09V&q=85&s=f2d298c0b4c7b3a62e1dee4e2e6f1bb3" alt="رابط Webhook للطاقم" width="624" height="259" data-path="images/enterprise/crew-webhook-url.png" />
    </Frame>
  </Step>

  <Step title="استلام إشعار Webhook">
    بمجرد إتمام الطاقم للمهمة التي تتطلب إدخالاً بشرياً، ستتلقى إشعار webhook يحتوي على:

    * **معرّف التنفيذ**
    * **معرّف المهمة**
    * **مخرجات المهمة**
  </Step>

  <Step title="مراجعة مخرجات المهمة">
    سيتوقف النظام في حالة `Pending Human Input`. راجع مخرجات المهمة بعناية.
  </Step>

  <Step title="إرسال التغذية الراجعة البشرية">
    استدعِ نقطة نهاية الاستئناف لطاقمك بالمعلومات التالية:

    <Frame>
      <img src="https://mintcdn.com/crewai/5SZbe87tsCWZY09V/images/enterprise/crew-resume-endpoint.png?fit=max&auto=format&n=5SZbe87tsCWZY09V&q=85&s=1e1c2ca22a2d674426f8e663fed33eca" alt="نقطة نهاية استئناف الطاقم" width="624" height="261" data-path="images/enterprise/crew-resume-endpoint.png" />
    </Frame>

    <Warning>
      **هام: يجب تقديم روابط Webhook مرة أخرى**:
      **يجب** تقديم نفس روابط webhook (`taskWebhookUrl`، `stepWebhookUrl`، `crewWebhookUrl`) في استدعاء الاستئناف التي استخدمتها في استدعاء التشغيل. لا تُنقل تهيئات Webhook تلقائياً من التشغيل — يجب تضمينها صراحة في طلب الاستئناف لمواصلة تلقي الإشعارات لاكتمال المهام وخطوات الوكيل واكتمال الطاقم.
    </Warning>

    مثال على استدعاء الاستئناف مع webhooks:

    ```bash theme={null}
    curl -X POST {BASE_URL}/resume \
      -H "Authorization: Bearer YOUR_API_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{
        "execution_id": "abcd1234-5678-90ef-ghij-klmnopqrstuv",
        "task_id": "research_task",
        "human_feedback": "Great work! Please add more details.",
        "is_approve": true,
        "taskWebhookUrl": "https://your-server.com/webhooks/task",
        "stepWebhookUrl": "https://your-server.com/webhooks/step",
        "crewWebhookUrl": "https://your-server.com/webhooks/crew"
      }'
    ```

    <Warning>
      **تأثير التغذية الراجعة على تنفيذ المهمة**:
      من الضروري توخي الحذر عند تقديم التغذية الراجعة، حيث سيتم دمج محتوى التغذية الراجعة بالكامل كسياق إضافي لعمليات تنفيذ المهام اللاحقة.
    </Warning>

    وهذا يعني:

    * جميع المعلومات في تغذيتك الراجعة تصبح جزءاً من سياق المهمة.
    * التفاصيل غير ذات الصلة قد تؤثر سلباً عليها.
    * التغذية الراجعة الموجزة وذات الصلة تساعد في الحفاظ على تركيز وكفاءة المهمة.
    * راجع دائماً تغذيتك الراجعة بعناية قبل الإرسال للتأكد من أنها تحتوي فقط على معلومات ذات صلة توجه تنفيذ المهمة بشكل إيجابي.
  </Step>

  <Step title="التعامل مع التغذية الراجعة السلبية">
    إذا قدمت تغذية راجعة سلبية:

    * سيعيد الطاقم محاولة المهمة مع سياق إضافي من تغذيتك الراجعة.
    * ستتلقى إشعار webhook آخر لمزيد من المراجعة.
    * كرر الخطوات 4-6 حتى ترضى.
  </Step>

  <Step title="استمرار التنفيذ">
    عندما ترسل تغذية راجعة إيجابية، سيستمر التنفيذ إلى الخطوات التالية.
  </Step>
</Steps>

## أفضل الممارسات

* **كن محدداً**: قدم تغذية راجعة واضحة وقابلة للتنفيذ تعالج المهمة مباشرة
* **كن ذا صلة**: ضمّن فقط المعلومات التي ستساعد في تحسين تنفيذ المهمة
* **كن سريعاً**: استجب لمطالبات HITL بسرعة لتجنب تأخير سير العمل
* **راجع بعناية**: تحقق من تغذيتك الراجعة قبل الإرسال لضمان الدقة

## حالات الاستخدام الشائعة

سير عمل HITL ذو قيمة خاصة لـ:

* ضمان الجودة والتحقق
* سيناريوهات اتخاذ القرار المعقدة
* العمليات الحساسة أو عالية المخاطر
* المهام الإبداعية التي تتطلب حكماً بشرياً
* مراجعات الامتثال والتنظيم

## اعرف المزيد

<CardGroup cols={2}>
  <Card title="إدارة HITL للتدفقات" icon="users-gear" href="/ar/enterprise/features/flow-hitl-management">
    استكشف قدرات منصة Enterprise الكاملة لـ Flow HITL بما في ذلك إشعارات البريد الإلكتروني وقواعد التوجيه والاستجابة التلقائية والتحليلات.
  </Card>

  <Card title="التغذية الراجعة البشرية في التدفقات" icon="code" href="/ar/learn/human-feedback-in-flows">
    دليل التنفيذ لمُزخرف `@human_feedback` في تدفقاتك.
  </Card>
</CardGroup>