對話評分

對話評分可收集訪客對 AI Agent 使用體驗的意見。啟用後，訪客會在對話結束時收到評分提示，提供直接且可採取行動的訊號，幫助您瞭解 AI Agent 的表現。

評分會在控制台的對話 > 收件匣中隨各段對話顯示，也包含在對話匯出中。可利用這些資料找出知識缺口、改善 AI Agent 設定，並追蹤滿意度的長期趨勢。

請在控制台的對話 > 洞察 > 對話評分設定此功能。

取得對話評分設定

權限範圍：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：傳回更新後的對話評分設定。

---