تقييم المحادثة

يتيح تقييم المحادثة جمع ملاحظات الزوار حول تجربتهم مع وكيل AI. عند تفعيله، يُطلب من الزوار تقييم التجربة في نهاية المحادثة، مما يقدم مؤشرًا مباشرًا وقابلًا للتنفيذ على أداء وكيل AI.

تظهر التقييمات في لوحة التحكم تحت المحادثات > صندوق الوارد بجوار كل محادثة، وتُدرج في صادرات المحادثات. استخدم البيانات لتحديد فجوات المعرفة وتحسين إعداد وكيل AI وتتبع اتجاهات الرضا مع الوقت.

اضبط الميزة تحت المحادثات > التحليلات > تقييم المحادثة في لوحة التحكم.

جلب إعداد تقييم المحادثة

نطاق الصلاحيات: read_all

GET https://app.quickchat.ai/v1/api/conversation_ratings/configuration

Shell

curl https://app.quickchat.ai/v1/api/conversation_ratings/configuration \
  -H 'Authorization: Bearer <API_TOKEN>'

Python

import requests

response = requests.get(
    url="https://app.quickchat.ai/v1/api/conversation_ratings/configuration",
    headers={"Authorization": "Bearer <API_TOKEN>"},
)
data = response.json()

الاستجابة 200 OK

{
  "conv_rating_active": true,
  "conv_rating_popup_active": true,
  "conv_rating_question_codes": ["HELPFUL_THUMBS", "EXPERIENCE_THUMBS"]
}

الحقل	الوصف
conv_rating_active قيمة منطقية	تفعيل جمع ملاحظات الزوار في نهاية المحادثات
conv_rating_popup_active قيمة منطقية	إظهار نافذة منبثقة تطلب الملاحظات (يجب أن تطابق conv_rating_active)
conv_rating_question_codes مصفوفة سلاسل نصية	أنواع أسئلة الملاحظات المعروضة. الافتراضي: ["HELPFUL_THUMBS", "EXPERIENCE_THUMBS"]

تحديث إعداد تقييم المحادثة

نطاق الصلاحيات: write_all

PATCH https://app.quickchat.ai/v1/api/conversation_ratings/configuration

ملاحظة

يجب تعيين conv_rating_active وconv_rating_popup_active إلى القيمة نفسها.

Shell

curl -X PATCH https://app.quickchat.ai/v1/api/conversation_ratings/configuration \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "conv_rating_active": true,
  "conv_rating_popup_active": true
}'

Python

import requests

response = requests.patch(
    url="https://app.quickchat.ai/v1/api/conversation_ratings/configuration",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={
        "conv_rating_active": True,
        "conv_rating_popup_active": True,
    },
)
data = response.json()

الاستجابة 200 OK: تعيد إعداد تقييم المحادثة المحدّث.

---