سير عمل HITL

​

نهجا HITL في CrewAI

​

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

​

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

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

​

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

1

تهيئة المهمة

هيّئ مهمتك مع تفعيل الإدخال البشري:

2

تقديم رابط Webhook

عند تشغيل طاقمك، أضف رابط webhook للإدخال البشري:

3

استلام إشعار Webhook

بمجرد إتمام الطاقم للمهمة التي تتطلب إدخالاً بشرياً، ستتلقى إشعار webhook يحتوي على:

• معرّف التنفيذ
• معرّف المهمة
• مخرجات المهمة

4

مراجعة مخرجات المهمة

سيتوقف النظام في حالة Pending Human Input. راجع مخرجات المهمة بعناية.

5

إرسال التغذية الراجعة البشرية

استدعِ نقطة نهاية الاستئناف لطاقمك بالمعلومات التالية:

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

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

نسخ

اسأل الذكاء الاصطناعي

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"
  }'

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

وهذا يعني:

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

6

التعامل مع التغذية الراجعة السلبية

إذا قدمت تغذية راجعة سلبية:

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

7

استمرار التنفيذ

عندما ترسل تغذية راجعة إيجابية، سيستمر التنفيذ إلى الخطوات التالية.

​

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

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

​

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

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

​

اعرف المزيد