يشرح هذا الدليل كيفية ضبط تصنيف المشاعر والعواطف في Discourse AI واستخدام التقارير لاستكشاف منشورات مجتمعك.
مستوى المستخدم المطلوب: مدير (Administrator) للضبط؛ مدير أو مشرف (Moderator) لعرض التقارير.
يساعدك تصنيف المشاعر والعواطف على استكشاف الأنماط في نقاشات مجتمعك:
- المشاعر (Sentiment) تصنف المنشورات إلى إيجابية، محايدة أو سلبية.
- العاطفة (Emotion) توزع درجات عبر 28 تسمية، بما في ذلك الامتنان، الفضول، الغضب والحزن.
هذه قدرات منفصلة. يمكنك تفعيل أي منها أو كلاهما، واختيار فئة مختلفة للمعالجة الخلفية لكل منها. تعد التقارير المنشورات المصنفة، وليس الأشخاص الفريدين أو أنواع الشخصية. استخدمها للعثور على النقاشات الجديرة بالقراءة، وليس كبديل لفهم سياقها.
قبل أن تبدأ
تحتاج إلى تمكين Discourse AI عبر discourse_ai_enabled وفئة معالجة خلفية مضبوطة للتصنيف.
مستضاف عبر Discourse؟ قد يكون موقعك يضم بالفعل نقاط نهاية مخصصة للتصنيف مهيأة مسبقًا. تحقق من تكوينه الحالي قبل تغييره. اتصل بـ team@discourse.org إذا احتجت إلى مساعدة بشأن التوفر، تكوين نقاط النهاية أو حدود إعادة المعالجة التاريخية (backfill).
مستضاف ذاتيًا؟ اضبط نقطة نهاية مخصصة متوافقة، أو وكيل ذكاء اصطناعي مع نموذج لغوي، أو نموذج قرار. تمكين الميزة وحده لا يوفر خدمة استنتاج.
راجع سياسة الخصوصية، قواعد الاحتفاظ بالبيانات والتكاليف لدى مزودك قبل تمكين المعالجة التلقائية. يرسل التصنيف نص المنشور إلى فئة المعالجة الخلفية المحددة. تستخدم لقطات الشاشة أدناه منشورات مبتكرة على موقع اختباري ونموذج قرار؛ وهي لا توصي بهذا المزود لمحتوى المجتمع الخاص.
ضبط المشاعر والعواطف
- افتح الإدارة → الإضافات → الذكاء الاصطناعي → الميزات.
- افتح “المشاعر والعواطف”.
- تحت “المشاعر”، اختر “مُفعّل” إذا كنت تريد تصنيفًا إيجابيًا، محايدًا وسلبيًا. يتحكم هذا في
ai_sentiment_enabled. - اختر “فئة المعالجة الخلفية” الخاصة به وقم بتكوين نقطة النهاية، الوكيل أو النموذج المقابل كما هو موضح أدناه.
- تحت “العاطفة”، اختر “مُفعّل” إذا كنت تريد تصنيف العواطف. يتحكم هذا في
ai_sentiment_emotion_enabled. - اختر فئة المعالجة الخلفية الخاصة به وقم بتكوينه بشكل مستقل.
- اضبط حدود المعالجة في الخلفية الموضحة في القسم التالي.
- انقر على “إرسال” وتأكد من حفظ اختياراتك.
يستخدم هذا المثال نموذج قرار لكلا القدرتين. تم ضبط “المنشورات في الساعة” عمدًا على 0 لإيقاف الفحص التلقائي أثناء الاختبار. استخدم قيمة موجبة لمعالجة المنشورات الجديدة والتاريخية تلقائيًا.
استخدام نقاط نهاية مخصصة للتصنيف
اختر “نقطة نهاية مخصصة للتصنيف” لكل قدرة ترغب في تشغيلها بنموذج مخصص. اتبع “تكوين نقاط نهاية مخصصة للتصنيف” حتى الإعداد ai_sentiment_model_configs.
نماذج المخصصة المرجعية هي:
| القدرة | النموذج |
|---|---|
| المشاعر | cardiffnlp/twitter-roberta-base-sentiment-latest |
| العاطفة | SamLowe/roberta-base-go_emotions |
يحدد كل مدخل تكوين classification_type الخاص به (sentiment أو emotion)، model_name، endpoint وapi_key. قم بتوفير مدخل منفصل لكل مصنف مخصص تستخدمه. حافظ على سرية بيانات الاعتماد؛ لا تقم بتضمينها في منشورات الدعم أو لقطات الشاشة.
راجع استضافة ذاتية للمشاعر والعواطف لـ Discourse AI لنشر خادم الاستنتاج. قم بتمكين واختيار كل قدرة بشكل منفصل باستخدام عناصر التحكم أعلاه.
تتوقع فئة المعالجة الخلفية المخصصة واجهة برمجة تطبيقات تصنيف متوافقة. نسخ نقطة نهاية Anthropic أو دردشة OpenAI أو Azure Language في هذا الإعداد لا يجعلها متوافقة. اختبار اتصال ناجح لنموذج لغوي في مكان آخر في Discourse لا يختبر نقطة نهاية المشاعر المخصصة.
استخدام وكيل ذكاء اصطناعي أو نموذج قرار
بالنسبة لـ “وكيل LLM”، اختر وكيلًا مناسبًا للمصنفين مع نموذج لغوي مضبوط. يتضمن Discourse وكلاء مصنفين للمشاعر والعواطف. ليس الوكيل المحادثاتي العام بديلاً عن وكيل مضبوط لإعادة درجات التسمية المتوقعة.
بالنسبة لـ “نموذج القرار”، قم أولاً بتكوين واختبار نموذج قرار متوافق، ثم اختر لكل قدرة مفعلة. لا يتطلب نموذج القرار نموذج لغة محادثاتي منفصلًا لهذا التصنيف.
يمكن أن تتكبد طلبات الوكيل ونموذج القرار رسومًا لدى المزود أو تستهلك أرصدة. راجع قواعد معالجة البيانات للنموذج المحدد قبل تعيينه لميزة معالجة تلقائية.
التحكم في المعالجة والتغطية التاريخية
يتحقق وظيفة مجدولة من المنشورات التي تعاني من تصنيفات مفقودة كل خمس دقائق. تشارك المنشورات الجديدة والتاريخية في هذا الفحص؛ لا تتوفر النتائج بالضرورة فورًا بعد النشر. لا يوجد عدد أدنى من المنشورات أو أيام قبل ظهور البيانات: يمكن لمنشور واحد تم تصنيفه بنجاح أن يساهم.
| عنصر التحكم | إعداد الموقع | الافتراضي | التأثير |
|---|---|---|---|
| المنشورات في الساعة | ai_sentiment_backfill_maximum_posts_per_hour |
240 |
العدد التقريبي للمنشورات المعالجة في الساعة. 0 يوقف الفحص المجدول، بما في ذلك المنشورات الجديدة. |
| حد عمر المنشور، بالأيام | ai_sentiment_backfill_post_max_age_days |
60 |
افحص المنشورات المنشأة ضمن نافذة العمر هذه. 0 يعني اليوم، وليس تاريخًا غير محدود. |
زد حد العمر لتضمين المنشورات الأقدم. تعالج الوظيفة المجدولة النتائج المفقودة بمرور الوقت؛ لا يصنف النطاق الزمني المحدد للتقرير تلك البيانات التاريخية بحد ذاته.
المعدل تقريبي، وليس حدًا دقيقًا للطلبات أو الإنفاق. يمكن أن يؤدي تمكين كل من المصنفين إلى إجراء طلبين لكل منشور. يمكن إعادة محاولة الطلبات الفاشلة أو الرفض. يتم فحص المنشورات المعدلة بشكل منفصل ولا يتم التحكم بها بواسطة معدل الفحص المجدول أو حدود العمر. يتم استبعاد الرسائل الخاصة، المنشورات المحذوفة، الموضوعات المحذوفة وأنواع المنشورات غير القياسية من فحص إعادة المعالجة التاريخية المجدولة. لا يضمن استبعاد الرسائل الخاصة في الماسح والتقارير ضمانًا لجميع مسارات التصنيف: وظيفة المنشور المعدل لا تطبق فلتر الرسائل الخاصة نفسه. ضع هذا في الاعتبار قبل تكوين مزود خارجي.
استكشاف المشاعر حسب الفئة أو الوسم
- افتح الإدارة → التقارير → تحليل المشاعر، أو زور
/admin/reports/sentiment_analysisعلى موقعك. - حدد تواريخ البداية والنهاية.
- اختر “الفئة” أو “الوسم” لتجميع النتائج.
- استخدم فلتر الفئة أو الوسم المقابل لتضييق النتائج. يوفر التصفية حسب الفئة أيضًا خيارًا لتضمين الفئات الفرعية.
- اقرأ المجموع لكل مجموعة وتفصيلها الإيجابي، السلبي والمحايد.
- انقر على صف المجموعة لفحص رسمها البياني والمنشورات الأساسية.
يحتوي المثال على تسعة منشورات مصنف: ثلاث إيجابية، ثلاث سلبية وثلاث محايدة. يتم تضمين المنشورات المحايدة في هذا التقرير.
في عرض التفاصيل:
- اختر “الكل”، “إيجابي”، “محايد” أو “سلبي” لتصفية المنشورات المحملة.
- افتح موضوع المنشور لقراءة النقاش المحيط.
- استخدم أيقونة الرابط بجانب الرسم البياني لنسخ عنوان URL لعرض التقرير ذاك. يحتاج المتلقون إلى وصول موظف (Staff).
- انقر على “رجوع” للعودة إلى النتائج المجمعة.
تشير تواريخ التقرير إلى وقت إنشاء المنشورات، وليس وقت تشغيل التصنيف. يمكن للمنشور أن يساهم في مجموعات وسوم متعددة إذا كان موضوعه يحمل وسومًا متعددة، لذا فإن إضافة مجاميع الوسوم يمكن أن تعد المنشور نفسه أكثر من مرة.
قراءة اتجاه المشاعر العام
افتح تقرير “المشاعر العامة” من الإدارة → التقارير، أو زور /admin/reports/overall_sentiment.
الدرجة هي:
عدد المنشورات الإيجابية − عدد المنشورات السلبية
يجب أن تكون الدرجة الإيجابية أو السلبية أكبر من 0.6 ليتم احتساب المنشور في تلك المجموعة. إذا لم تتجاوز أي منها العتبة، تعامل التقرير المجمعة المنشور على أنه محايد. العتبة ثابتة؛ لا يوجد إعداد موقع لتغييرها.
المشاعر العامة هي صافي عدد المنشورات، وليست متوسطًا احتماليًا أو نسبة سعادة. ثلاث منشورات إيجابية وثلاث منشورات سلبية ينتج عنها درجة عامة من 0، بغض النظر عن عدد المنشورات المحايدة. افحص التفصيل المجمّع والنقاشات الأساسية قبل تفسير الاتجاه المسطح على أنه غياب للآراء القوية.
استكشاف العواطف
لكل عاطفة تقرير تحت الإدارة → التقارير. على سبيل المثال، زور /admin/reports/emotion_anger لـ “الغضب” أو /admin/reports/emotion_curiosity لـ “الفضول”. اختر نطاقًا زمنيًا وتجميعًا يوميًا، أسبوعيًا أو شهريًا لاستكشاف الاتجاه.
يعد تقرير العاطفة المنشورات التي تكون درجتها لتلك التسمية أكبر من 0.1. هذه العتبة ثابتة أيضًا. يمكن أن تنطبق أكثر من عاطفة على نفس المنشور، لذا فإن مجاميع العواطف ليست حصرية متبادلة.
يمكنك أيضًا تصفية الموضوعات حسب عاطفة. زور /filter?q=order:emotion_anger للعثور على الموضوعات المطابقة، مصنفة حسب عدد المنشورات المؤهلة المصنفة بالغضب وليس حسب متوسط درجة العاطفة. استخدم order:emotion_anger-asc لعكس الترتيب. بدون فلتر activity-after:، يحسب هذا الترتيب المنشورات المؤهلة من العام الماضي. تنطبق أذونات الوصول المعتادة لقائمة الموضوعات.
تسميات العواطف المتاحة
الإعجاب، المتعة، الغضب، الانزعاج، الموافقة، الرعاية، الارتباك، الفضول، الرغبة، خيبة الأمل، عدم الموافقة، الاشمئزاز، الإحراج، الإثارة، الخوف، الامتنان، الحزن، الفرح، الحب، العصبية، المحايد، التفاؤل، الفخر، الإدراك، الارتياح، الندم، الحزن والمفاجأة.
فهم القيود
- التصنيف يعتمد على النموذج. يمكن أن يتم تفسير السخرية، المواد المقتبسة، اللغة المتخصص والنقاشات متعددة اللغات بشكل خاطئ. تعتمد تغطية اللغة والدقة على النموذج المختار. لا تتم معايرة الدرجات من فئات معالجة خلفية مختلفة بالضرورة بشكل متماثل.
- تغطي التقارير فقط النتائج المخزنة. يمكن أن ينتج عن ميزة مفعلة بدون فئة معالجة خلفية عاملة، معالجة متوقفة أو تغطية تاريخية غير كافية تقارير فارغة أو غير مكتملة.
- يتم إعادة استخدام التصنيفات الحالية. لا يؤدي تعديل منشور مصنّف إلى استبدال نتائجه تلقائيًا. لا يؤدي تغيير الوكيل المحدد أو نموذج القرار ضمن نفس فئة المعالجة الخلفية إلى إعادة تصنيف النتائج الحالية أيضًا.
- يغير تغيير فئة المعالجة الخلفية مصدر نتائج التقرير. لا يتم تحويل النتائج القديمة إلى فئة المعالجة الخلفية المحددة. يمكن أن تظهر التقارير فارغة بينما يتم معالجة التصنيفات المفقودة.
- تستبعد التقارير الرسائل الخاصة. هذا الاستبعاد في التقارير منفصل عن قيود معالجة البيانات الموصوفة أعلاه.
استكشاف الأخطاء وحل النتائج المفقودة أو غير المتوقعة
| المشكلة | ما يجب التحقق منه |
|---|---|
| لا توجد نتائج بعد التمكين | تأكد من تمكين القدرة ذات الصلة، تكوين فئة المعالجة الخلفية، أن “المنشورات في الساعة” موجب، وأن وظائف الخلفية تعمل. اسمح بالوقت للفحص كل خمس دقائق وطابور المعالجة. |
| يعمل تصنيف المشاعر لكن العاطفة فارغة | قم بتمكين وتكوين “العاطفة” بشكل منفصل. لا توفر نقطة نهاية مخصصة للمشاعر فقط تصنيفات العاطفة. |
| التواريخ الأقدم ليس لها نتائج | زد حد عمر المنشور، اسمح بوقت المعالجة، وتأكد من أن نطاق التقرير يشمل تواريخ إنشاء المنشورات. |
| ترجع نقطة النهاية المخصصة خطأً | تحقق من عنوان URL، بيانات الاعتماد، النموذج وصيغة الاستجابة. يتوقع المحول مصفوفة مسطحة من التسميات والدرجات، مع تسميات المشاعر مثل positive، neutral وnegative، وليست استجابات دردشة اعتباطية أو تسميات من نوع LABEL_0. |
| لا يمكن الوصول إلى نقطة نهاية الشبكة الخاصة | تحقق من الاتصال و، حيثما لزم الأمر، أضف فقط اسم المضيف أو IP نقطة نهاية الاستنتاج الموثوقة إلى allowed_internal_hosts. لا تقم بتعطيل حماية تزوير الطلبات من جانب الخادم على نطاق واسع. |
| لا تتغير النتائج بعد التعديل أو اختيار النموذج | يتم إعادة استخدام النتائج الحالية. لا تفترض أن تعديل المحتوى أو حفظ نموذج آخر يحدد موعدًا لإعادة التصنيف الكاملة. |
| يعرض فلتر عددًا من المنشورات أقل من عددها | يصف العدد المجموعة بأكملها، بينما تصف علامات تبويب المشاعر المنشورات المحملة. تحقق من المزيد من النتائج للتحميل وافتح الموضوعات الأصلية عند التحقيق في التناقضات. |
يمكن للمسؤولين مراجعة سجلات طلبات الوكيل ونموذج القرار في الإدارة → الإضافات → الذكاء الاصطناعي → السجلات. تحقق من /logs لأخطاء التصنيف في الخلفية، بما في ذلك إخفاقات نقطة النهاية المخصصة. تعامل مع محتويات السجلات على أنها حساسة: يمكن أن تحتوي على نص المنشور واستجابات النموذج. احذف بيانات الاعتماد والمحتوى الخاص قبل مشاركة التشخيصات.



