mirror of
https://github.com/crewAIInc/crewAI.git
synced 2026-04-30 14:52:36 +00:00
158 lines
9.3 KiB
Plaintext
158 lines
9.3 KiB
Plaintext
---
|
|
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>
|