Bot接口会话
消息反馈
接口描述
此接口用于对 Bot 的回复消息进行反馈,例如点赞或点踩。
基础信息
| 请求地址 | /messages/{message_id}/feedbacks |
|---|---|
| 请求域名 | • 办公网域名:http://jiuwen-api.vmic.xyz/v1 • IDC域名:http://jiuwen-api.vivo.lan:8080/v1 |
| 请求方法 | POST |
| 接口说明 | 代表最终用户对返回消息进行评价,可以点赞与点踩,该数据将在“对话记录”页中可见,并用于后续的模型微调。 |
请求参数
Request Header
| 参数 | 取值 | 说明 |
|---|---|---|
| Authorization | Bearer {{API-SECRET-KEY}} | 用于验证客户端身份的 API密钥。注意:请只替换红色部分!Bearer和密钥中间有一个空格,请勿删除! |
| Content-Type | application/json | 响应的HTTP内容类型。 |
Path Params
| 参数 | 类型 | 说明 |
|---|---|---|
| message_id | String | 消息 ID |
Request Body
| 参数 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
| rating | String | 是 | • like:点赞 • dislike:点踩 • 空值:撤销 | |
| user | String | 否 | 用户标识,由开发者定义规则,需保证用户标识在应用内唯一。 |
返回参数
内容较多,详见下方示例
示例
Request
curl --location --request POST 'http://chato-console-test.vmic.xyz/v1/messages/{message_id}/feedbacks \
--header 'Authorization: Bearer {{API-SECRET-KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"rating": "like",
"user": "abc-123"
}'注意: 请只替换
{{API-SECRET-KEY}}!Bearer和密钥中间有一个空格,请勿删除!
Response
{
"has_more": false,
"data": [
{
"id": "WAz8eIbvDR60rouK",
"username": "FrankMcCallister",
"phone_number": "1-800-759-3000",
"avatar_url": "https://assets.protocol.chat/avatars/frank.jpg",
"display_name": null,
"conversation_id": "xgQQXg3hrtjh7AvZ",
"created_at": 692233200
}
]
}