# 消息评价
消息评价功能允许用户对智能体或应用回复的消息进行点赞、点踩及详细评论。该功能支持通过 API 调用和 Chat SDK 集成两种方式实现，为用户提供便捷反馈渠道。同时，它帮助开发者快速收集用户意见，使开发者能够直接了解智能体回复的质量，并针对性地优化算法、调整知识库内容或改进对话逻辑，从而为用户提供更精准、更有帮助的回答。
## 功能简介
消息评价功能允许用户对智能体或应用回复的消息进行评价，主要包括点赞、点踩以及提交详细的评论。无论是“一问一答”还是“一问多答”场景，每条消息的评价都是独立的，不会相互覆盖或影响。如果用户对同一条消息多次提交评价，系统将仅保留最后一次的评价内容。
消息评价功能仅支持对以下两种发布渠道中的消息进行评价：

* **Chat SDK**：集成 Chat SDK 的应用界面中，用户可直接在消息下方操作点赞 / 点踩。
* **API 渠道**：通过调用发起对话 API 或执行对话流 API 获取文本消息回复后，可调用评价 API 提交反馈。

## 通过 Chat SDK 配置消息评价功能
当智能体或扣子应用发布 Chat SDK 后，开发者可以设置是否允许用户对消息进行点赞或点踩，默认禁用消息评价功能。
开发者可以在 `WebChatClient` 方法的 `ui.chatBot` 参数中，配置是否允许用户对智能体的回答进行评价（点赞 / 点踩）。详细参数说明参见[安装并使用 Chat SDK](https://docs.coze.cn/api/open/docs/developer_guides/install_web_sdk)。
开启消息评价的示例代码如下：
```TypeScript
ui: {
    chatBot: {
        // 基础UI配置
        title: "智能助手",
        
        // 消息评价功能配置（独立模块）
        feedback: {
            isNeedFeedback: true,  // 是否启用反馈功能
            feedbackPanel: {       // 反馈面板详细配置
                title: '您对这个回答有什么看法？请告诉我们',
                placeholder: '请详细描述您的问题...',
                tags: [             // 反馈标签选项
                    {
                        label: '内容不够详细'
                    },
                    {
                        label: '内容错误'
                    },
                    {
                        label: '其他',
                        isNeedDetail: true  // 选择此标签时需要填写详细说明
                    }
                ]
            }
        }
    }
}
```

仅点踩时会弹出反馈卡片，供用户填写反馈标签内容。

通过上述代码，开发者可以轻松地在 App 中启用消息评价功能，用户可直接在智能体或扣子应用回复的消息下方操作点赞 / 点踩。消息评价的界面效果类似如下图所示。
![Image](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/583255fe75014e97a7f6f2106bbe3bb8~tplv-goo7wpa0wc-image.image)
## 通过 API 对消息进行评价
通过调用发起对话 API 或执行对话流 API 获取文本消息回复后，可调用评价 API 提交反馈。

1. 发起对话，获取智能体或扣子应用的回复消息的消息 ID。
   * 调用[发起对话](https://docs.coze.cn/api/open/docs/developer_guides/chat_v3)API 创建对话。
      如果是流式响应，可以直接在返回结果中获取智能体返回的 **type=answer** 类型的文本消息的消息 ID。如果是非流式响应，返回结果中不返回消息 ID，可以执行步骤 2 查看消息 ID。
   * 调用[执行对话流](https://docs.coze.cn/api/open/docs/developer_guides/workflow_chat)API，在对话流返回的 **conversation.message** 对象中获取 **type=answer** 类型的文本消息的消息 ID。
      ![Image](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/2b9317998c944448bdc30a1b4df531ec~tplv-goo7wpa0wc-image.image)
2. （可选）你也可以调用[查看消息列表](https://docs.coze.cn/api/open/docs/developer_guides/list_message) API 查看对应的消息 ID。
   ![Image](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/7cd9989c80e9483983ef612a0d61e06c~tplv-goo7wpa0wc-image.image)
3. 提交消息评价。
   仅支持评价以下来源的文本消息：
   
   * 通过发起对话 API 生成的 **type=answer** 类型的文本消息。
   * 通过执行对话流 API 返回的文本消息。

   会话创建者调用[提交消息评价](https://docs.coze.cn/api/open/docs/developer_guides/message_feedback) API，根据会话 ID 和消息 ID 对智能体或应用回复的指定消息进行评价，包括点赞、点踩、添加自定义的反馈标签、具体评论。
   ```Shell
   curl --location --request POST 'https://api.coze.cn/v1/conversations/7515364893***/messages/752173729302***/feedback' \ 
   --header 'Authorization: Bearer pat_xFWpGsNio4S7sfAzpu02vHCkAdL38VnSsTOIu8CkySdY9Z2xmeM8jjn***' \ 
   --header 'Content-Type: application/json'  \ 
   --data-raw '{ 
       "feedback_type": "unlike", 
       "reason_types": [ 
           "内容有误", 
           "不够详细" 
       ], 
       "comment": "实际参数应为 5.0 版本而非 4.0 版本。" 
   }' 
   ```

   无论是点赞的数据还是点踩的数据，都可以添加自定义的反馈标签。

4. （可选）删除消息评价。
   如果出现误操作、评价内容错误或无效等情况，会话创建者可以调用[删除消息评价](https://docs.coze.cn/api/open/docs/developer_guides/delete_message_feedback) API 删除指定消息的评价。 

## 查看消息评价数据
开发者可以在扣子罗盘中根据 `Feedback-Coze 对话` 字段筛选消息的评价数据，以便快速收集和分析用户意见。通过对点踩的数据进行分析，开发者可以了解智能体回复的质量，并针对性地优化算法、调整知识库内容或改进对话逻辑。
仅智能体或扣子应用的**所有者**和**协作者**可以查看消息评价数据。


1. 在扣子罗盘左侧导航栏选择**观测 > Trace**，在 Trace 列表中选择某条消息，或通过过滤器筛选消息评价的数据。查看方式选择 **All Span**，数据来源选择 **Coze 智能体**或 **Coze 应用**，过滤字段设置为 `Feedback-Coze 对话属于点赞或点踩`。
   ![Image](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/b319ffd1e22947169d590f974aaf6a02~tplv-goo7wpa0wc-image.image)
2. 在 Trace 详情页面的调用树中单击 **Message** 节点，在右侧查看该消息的反馈结果和标签。
   ![Image](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/f9c2db13331642b4b1c529ed9f9dea2d~tplv-goo7wpa0wc-image.image)