إنتقل إلى المحتوى الرئيسي

تعليقات المستخدمين والإبلاغ عن المشكلات

يقدم Gratis AI Agent v1.5.0 نظامًا مدمجًا لجمع التعليقات والإبلاغ عن المشكلات، مما يتيح للمستخدمين النهائيين الإشارة إلى الردود غير المفيدة والإبلاغ عن المشكلات مباشرة من واجهة الدردشة. يتضمن هذا النظام إدارة الموافقة، وأمر إبلاغ آلي، وفرزًا بمساعدة الذكاء الاصطناعي في الخلفية.

زر الإعجاب المنخفض (Thumbs-Down Button)​

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

  • يظهر الزر عند تمرير المؤشر فوقه بجوار كل رسالة من المساعد.
  • النقر عليه يفتح نافذة موافقة التعليقات (Feedback Consent Modal).
  • يتم ربط التعليق بسلسلة المحادثة والرسالة المحددة.

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

  • شرح المعلومات التي سيتم جمعها (مقتطف من المحادثة، وسياق المتصفح).
  • مطالبة المستخدم بتأكيد موافقته على مشاركة هذه البيانات.
  • توفير حقل نصي حر ليصف المستخدم ما حدث بشكل خاطئ.
  • تقديم خيار إلغاء (Cancel) للتجاهل دون إرسال.

لن يتم تسجيل أي تعليق حتى يؤكد المستخدم ذلك صراحةً.

لافتة التعليقات التلقائية (Auto-Prompt Feedback Banner)​

في نهاية المحادثة، قد يعرض المساعد لافتة تعليقات تلقائية (auto-prompt feedback banner) — وهي رسالة غير مزعجة تسأل عما إذا كانت الجلسة مفيدة.

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

أمر الشرطة /report-issue (Slash Command)​

يمكن للمستخدمين تشغيل مسار التعليقات مباشرة عن طريق كتابة /report-issue في حقل إدخال الدردشة. يقوم هذا الأمر بما يلي:

  • يفتح نافذة موافقة التعليقات على الفور.
  • يملأ حقل الوصف مسبقًا بسياق حول المحادثة الحالية.
  • يسمح للمستخدمين بإضافة تفاصيل إضافية قبل الإرسال.

يتوفر أمر /report-issue في جميع أوضاع الدردشة (المضمن، الأداة العائمة، ملء الشاشة).

الفرز بمساعدة الذكاء الاصطناعي (AI-Assisted Triage)​

يتم توجيه التعليقات المرسلة إلى طبقة فرز تعمل بالذكاء الاصطناعي، والتي:

  • تصنف التقرير (خطأ واقعي، إجابة غير مفيدة، محتوى غير لائق، إلخ).
  • ترفق بيانات وصفية ذات صلة بالمحادثة.
  • ترسل ملخص الفرز إلى نقطة نهاية التعليقات (Feedback Endpoint) المكوّنة (انظر الإعدادات > متقدم).

يقلل هذا من وقت المراجعة اليدوية من خلال إبراز أهم المشكلات أولاً.

الإعدادات > متقدم​

لتفعيل الواجهة الخلفية للتعليقات، قم بتكوين الحقول التالية ضمن Gratis AI Agent → الإعدادات → متقدم:

الحقلالوصف
Feedback Endpoint URLعنوان URL الذي يستقبل طلبات POST بحمولات التعليقات (JSON).
Feedback API Keyرمز Bearer token يُرسل في رأس Authorization لمصادقة إرسالات التعليقات.

اترك كلا الحقلين فارغين لتعطيل جمع التعليقات. تظل أزرار التعليقات الفردية مرئية للمستخدمين، ولكن لن يتم إرسال أي بيانات.

تلميح

يجب أن تقبل نقطة نهاية التعليقات جسم JSON يحتوي على حقول على الأقل هي message_id، وconversation_id، وfeedback_text، وtriage_category. راجع وثائق مزود نقطة النهاية الخاصة بك لمعرفة المخطط المتوقع.