点赞点踩
更新时间：2025-01-22
接口描述
此接口支持对agent应用返回的对话内容进行评价（包括点赞、点踩及取消评价），并允许附加标签和评论文本，帮助进一步细化反馈数据。
接口定义
| URL | /v2/app/conversation/feedback |
|---|---|
| Method | POST |
| Content-Type | application/json |
| Authorization | 请求签名 格式为：Bearer+空格+密钥（API Key） |
请求结构
POST /v2/app/conversation/feedback HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: authorization string
Content-Type: application/json
{
"app_id": "d00fb80d-c5a8-45df-ad33-e9c03572c5ac",
"conversation_id": "76a25d49-5c0e-4979-83ea-2f9903945801",
"message_id": "2793aaf6-3cd9-42d4-b87e-0d9eb82c7e52",
"type": "downvote",
"flag": ["答非所问"],
"reason": "回答内容和问题不相关"
}请求参数
header参数
除公共头域外，无其它特殊头域。
请求body参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| app_id | string | 是 | 应用id |
| conversation_id | string | 是 | 对话id |
| message_id | string | 是 | 对应的消息id |
| type | string | 否 | 点赞点踩枚举值： cancel：取消评论 upvote：点赞 downvote：点踩 |
| flag | string | 否 | 点踩原因枚举值： 答非所问 内容缺失 没有帮助 逻辑问题 偏见歧视 事实错误 |
| reason | string | 否 | 对于点赞点踩额外补充的原因。 |
响应参数
响应header参数
除公共头域外，无其它特殊头域。
响应body参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| request_id | dict | 是 | 请求对应的request id |
| code | string | 否 | 错误代码，参考错误码，当发生异常时返回 |
| message | string | 否 | 错误消息，参考错误码，当发生异常时返回 |
请求curl示例
curl --location 'https://qianfan.baidubce.com/v2/app/conversation/feedback' \
--header 'Authorization: Bearer string' \
--header 'Content-Type: application/json' \
--data '{
"app_id": "d00fb80d-c5a8-45df-ad33-e9c03572c5ac",
"conversation_id": "76a25d49-5c0e-4979-83ea-2f9903945801",
"message_id": "2793aaf6-3cd9-42d4-b87e-0d9eb82c7e52",
"type": "downvote",
"flag": ["答非所问"],
"reason": "回答内容和问题不相关"
}'正确响应示例
{
"request_id": "db50e6ed-ee0a-4d95-a385-6d57a05aed7b"
}错误响应示例
{
"code": "InvalidParameter",
"message": "'conversation_id' must be uuid",
"request_id": "0a7c7833-544b-4e82-9dc7-8a1047179ff3"
}