# 查询反馈信息列表 - ListFeedbacks #### 功能介绍 查询反馈信息列表，包含用户ID、问题、反馈信息、修订信息等。 #### URI GET /v1/{project_id}/applications/{application_id}/uni-search/feedback-manage 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 项目ID，获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-koosearch/koosearch_06_0022.html)。 **约束限制：** 不涉及 **取值范围：** 1～64个字符，只能包含数字、字母、中划线和下划线，且必须以字母开头。 **默认取值：** 不涉及 | | application_id | 是 | String | **参数解释：** 应用ID，获取方法请参见[获取应用ID](https://support.huaweicloud.com/api-koosearch/koosearch_06_0021.html)。 **约束限制：** 字符串 **取值范围：** 1～64个字符，只能包含数字、字母、中划线和下划线，且必须以字母开头。 **默认取值：** 不涉及 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | page_num | 否 | Integer | **参数解释：** 当前请求的页码，表示从第几页开始获取数据。默认值为1，表示第一页。 **约束限制：** 不涉及 **取值范围：** 1～65535 **默认取值：** 1 | | page_size | 否 | Integer | **参数解释：** 每页显示的记录数，表示一次请求返回的数据条数。默认值为10，表示一页展示10条数据。 **约束限制：** 不涉及 **取值范围：** 1-65535 **默认取值：** 10 | | user_name | 否 | String | **参数解释：** 用户名。 **约束限制：** 不涉及 **取值范围：** 最大长度为128。 **默认取值：** 不涉及 | | feedback_type | 否 | String | **参数解释：** 反馈类型。 **约束限制：** 不涉及 **取值范围：** - like-点赞 - unlike-点踩 **默认取值：** 不涉及 | | feedback_sencond_type | 否 | String | **参数解释：** 反馈二级类型，多个类别通过','分隔。 **约束限制：** 不涉及 **取值范围：** 最大长度为1024，只能包含字母、下划线、逗号、空格和中文。 **默认取值：** 不涉及 | | repo_id | 否 | String | **参数解释：** 知识库ID。 **约束限制：** 不涉及 **取值范围：** 长度在1到64之间，只能包含字母、数字、下划线和短横线。 **默认取值：** 不涉及 | | feedback_status | 否 | String | **参数解释：** 反馈状态。 **约束限制：** 不涉及 **取值范围：** - 0-未修正 - 1-已修正 - 2-非问题 **默认取值：** 不涉及 | | tag | 否 | String | **参数解释：** tag信息，由英文冒号连接key和value构成，如：key1:value1。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | name | 否 | String | **参数解释：** 反馈名称。 **约束限制：** 不涉及 **取值范围：** 最大长度为64。 **默认取值：** 不涉及 | #### 请求参数 表3请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 接口鉴权使用的Token，Token获取方式参考：[获取IAM用户Token](https://support.huaweicloud.com/api-koosearch/koosearch_06_0009.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | feeback_list | Array of [FeedbackInfo] objects | **参数解释：** 反馈列表。 **取值范围：** 不涉及 | | total | Integer | **参数解释：** 总数。 **取值范围：** 不涉及 | 表5FeedbackInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | feedback_id | String | **参数解释：** 反馈id。 **取值范围：** 不涉及 | | repo_id | String | **参数解释：** 知识库id。 **取值范围：** 不涉及 | | repo_name | String | **参数解释：** 知识库名称。 **取值范围：** 不涉及 | | question_id | String | **参数解释：** 问答ID。 **取值范围：** 不涉及 | | chart_id | String | **参数解释：** 会话ID。 **取值范围：** 不涉及 | | question | String | **参数解释：** 问题。 **取值范围：** 不涉及 | | answer | String | **参数解释：** 答案。 **取值范围：** 不涉及 | | expect_answer | String | **参数解释：** 期望答案。 **取值范围：** 不涉及 | | feedback_detail | String | **参数解释：** 反馈详情。 **取值范围：** 不涉及 | | user_name | String | **参数解释：** 用户名。 **取值范围：** 不涉及 | | feedback_type | String | **参数解释：** 反馈类型。 **取值范围：** - like-点赞 - unlike-点踩 | | feedback_second_type | String | **参数解释：** 反馈二级类型。 **取值范围：** 枚举值或者空 - 全部 - 理解有误 - 没有结合上下文 - 搜索结果未召回信息 - 搜索结果排序不准 - 搜索结果文档内容有误 - 大模型推理错误 - 存在偏见和歧视 - 其他安全问题 | | feedback_date_time | String | **参数解释：** 反馈时间。 **取值范围：** 不涉及 | | feedback_status | Integer | **参数解释：** 反馈类型。 **取值范围：** - 0-待修正 - 1-已修正 | | context_relation | String | **参数解释：** 上下文关联类型。 **取值范围：** 不涉及 | | revised_answer | String | **参数解释：** 修订问题。 **取值范围：** 不涉及 | | revised_reason | String | **参数解释：** 修订原因。 **取值范围：** 不涉及 | | standard_answer | String | **参数解释：** 标准答案。 **取值范围：** 不涉及 | | project_id | String | **参数解释：** 项目ID。 **取值范围：** 不涉及 | | question_model | [QuestionModel] object | **参数解释：** 模型。 **取值范围：** 不涉及 | | question_reference_models | Array of [QuestionReferenceModel] objects | **参数解释：** 引用模型。 **取值范围：** 不涉及 | 表6QuestionModel | 参数 | 参数类型 | 描述 | |:---|:---|:---| | question_id | String | **参数解释：** 问题ID。 **取值范围：** 不涉及 | | chat_id | String | **参数解释：** 会话ID。 **取值范围：** 不涉及 | | question | String | **参数解释：** 问题。 **取值范围：** 不涉及 | | rewrited_question | String | **参数解释：** 改写问题。 **取值范围：** 不涉及 | | answer | String | **参数解释：** 答案。 **取值范围：** 不涉及 | | pangu_answer | String | **参数解释：** pangu答案。 **取值范围：** 不涉及 | | user_name | String | **参数解释：** 用户名。 **取值范围：** 不涉及 | | create_date_time | String | **参数解释：** 对话发生时间。 **取值范围：** 不涉及 | | feedback_status | Integer | **参数解释：** 是否有问题反馈。 **取值范围：** - 0-未修正 - 1-已修正 - 2-非问题 | | feedback_type | String | **参数解释：** 反馈类型。 **取值范围：** - like-点赞 - unlike-点踩 | | pangu_question | String | **参数解释：** pangu问题。 **取值范围：** 不涉及 | | feedback_date_time | String | **参数解释：** 反馈时间。 **取值范围：** 不涉及 | | feedback_detail | String | **参数解释：** 反馈详情。 **取值范围：** 不涉及 | | context_relation | String | **参数解释：** 关联上下文。 **取值范围：** 不涉及 | | revised_answer | String | **参数解释：** 优化后结果。 **取值范围：** 不涉及 | | revised_reason | String | **参数解释：** 优化后问题。 **取值范围：** 不涉及 | | standard_answer | String | **参数解释：** 标准答案。 **取值范围：** 不涉及 | | project_id | String | **参数解释：** 项目ID。 **取值范围：** 不涉及 | | search_plan | String | **参数解释：** 搜索规划内容。 **取值范围：** 不涉及 | | web_reference | String | **参数解释：** web引用。 **取值范围：** 不涉及 | | question_reference_models | Array of [QuestionReferenceModel] objects | **参数解释：** 当前答案的参考文件和分片详情。 **取值范围：** 不涉及 | 表7QuestionReferenceModel | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | Integer | **参数解释：** 参考分片ID。 **取值范围：** 不涉及 | | file_id | String | **参数解释：** 文件ID。 **取值范围：** 不涉及 | | reference_id | String | **参数解释：** 参考文件ID。 **取值范围：** 不涉及 | | question_id | String | **参数解释：** 问题ID。 **取值范围：** 不涉及 | | doc_index | String | **参数解释：** 参考文件索引。 **取值范围：** 不涉及 | | doc_title | String | **参数解释：** 参考文件名称。 **取值范围：** 不涉及 | | subtitle | String | **参数解释：** 参考分片子标题。 **取值范围：** 不涉及 | | doc_content | String | **参数解释：** 参考分片内容。 **取值范围：** 不涉及 | | score | Float | **参数解释：** 参考分片与问题的相关性得分。 **取值范围：** 不涉及 | | type | String | **参数解释：** 类型。 **取值范围：** 不涉及 | | page_num | Integer | **参数解释：** 页码。 **取值范围：** 不涉及 | | component_num | Integer | **参数解释：** 组件数量。 **取值范围：** 不涉及 | | extend | String | **参数解释：** 一些用于文档高亮和定位的json数据。举例： { "element_id": "abc123", "elements": \[ "elem1", "elem2", "elem3" \], "pdf_coordinate": \[ \[ 202, 687 \], \[ 1031, 687 \] \] } **约束限制：** 此参数只有25.7.T1及之后版本支持。 **取值范围：** 不涉及 | #### 请求示例 查询反馈信息列表。 ``` /v1/123123/applications/123123/uni-search/knowledge-repo?page_num=1&page_size=10&name=知识&status= ``` #### 响应示例 **状态码：200** 反馈查询结果。 ``` { "feeback_list" : [ { "question_id" : "12353", "question" : "今天天气如何", "answer" : "天气很好", "feedback_detail" : "", "user_name" : "", "feedback_type" : "like", "feedback_date_time" : "123345675552", "feedback_status" : 0, "context_relation" : "", "revised_answer" : "", "revised_reason" : "", "standard_answer" : "" } ], "total" : 12 } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 反馈查询结果。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-koosearch/ErrorCode.html)。