资讯 文档
技术能力
语音技术
文字识别
人脸与人体
图像技术
语言与知识
视频技术

点赞点踩

接口描述

此接口支持对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 Array[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"
}
上一篇
查询用户应用列表
下一篇
组件