---
title: "سير عمل HITL"
description: "تعلم كيفية تنفيذ سير عمل Human-In-The-Loop في CrewAI لتعزيز اتخاذ القرار"
icon: "user-check"
mode: "wide"
---

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="/images/enterprise/crew-human-input.png" alt="إدخال بشري للطاقم" />
        </Frame>
    </Step>

    <Step title="تقديم رابط Webhook">
        عند تشغيل طاقمك، أضف رابط webhook للإدخال البشري:
        <Frame>
            <img src="/images/enterprise/crew-webhook-url.png" alt="رابط Webhook للطاقم" />
        </Frame>
    </Step>

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

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

    <Step title="إرسال التغذية الراجعة البشرية">
        استدعِ نقطة نهاية الاستئناف لطاقمك بالمعلومات التالية:
        <Frame>
            <img src="/images/enterprise/crew-resume-endpoint.png" alt="نقطة نهاية استئناف الطاقم" />
        </Frame>

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

        مثال على استدعاء الاستئناف مع webhooks:
        ```bash
        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>
