更新评估任务洞察结果的用户反馈 - UpdateOpsEvaluationTaskInsights
功能介绍
该接口用于更新用户对于洞察内容的反馈。
适用场景:用户反馈建议。
调用方法
请参见如何调用API。
授权信息
账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。
| 授权项 | 访问级别 | 资源类型(*为必须) | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
| agentarts:evaluationTask:updateOpsEvaluationTaskInsights | Write | evaluationTask * | g:ResourceTag/<tag-key> | - | - |
URI
PUT /v1/ops/evaluation-tasks/{task_id}/insights
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| task_id | 是 | String | 参数解释: 评估任务的唯一标识符(ID)。该参数嵌入在API路径中,用于定位需要操作的具体任务实例。 约束限制: 长度为0到100个字符的字符串。 取值范围: 不涉及。 默认取值: 不涉及。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| check_option | 否 | Array of strings | 用户选定的选项的变量名。 |
| other_content | 否 | String | 用户反馈内容 |
| status | 否 | String | 点赞点踩状态,GOOD点赞,BAD点踩,NONE表示无反馈。 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| data | String | 执行成功无错误时返回该内容,通常设置为空即可。 |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 系统定义的标准化错误代码。 取值范围: 业务异常编码字符串。 |
| error_msg | String | 参数解释: 对错误的详细描述,包含异常原因或解决建议。 约束限制: 字符串类型,最小长度为2,最大长度为512。 取值范围: 字符长度2-512,任意文本内容。 |
状态码:500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 系统定义的标准化错误代码。 取值范围: 业务异常编码字符串。 |
| error_msg | String | 参数解释: 对错误的详细描述,包含异常原因或解决建议。 约束限制: 字符串类型,最小长度为2,最大长度为512。 取值范围: 字符长度2-512,任意文本内容。 |
请求示例
修改用户反馈
PUT https://*.com/agentarts/v1/ops/evaluation-tasks/d499c3a8-791f-4eac-a542-01979fc41f28/insights
{
"check_option" : [ "answer_incorrection", "other" ],
"other_content" : "有用",
"status" : "GOOD/BAD/NONE"
} 响应示例
状态码:200
获取任务详情
{
"data" : ""
} 状态码:400
参数错误
{
"error_code" : "AgentArts.03400003",
"error_msg" : "评估对象不存在"
} 状态码:500
系统错误
{
"error_code" : "AgentArts.03500001",
"error_msg" : "查询过程出错"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 获取任务详情 |
| 400 | 参数错误 |
| 500 | 系统错误 |
错误码
请参见错误码。