# 查询对话历史列表 - ListChatHistorys #### 功能介绍 查询历史问题列表。包含对话ID、对话问题、用户名、对话开始时间。 #### URI GET /v1/{project_id}/applications/{application_id}/uni-search/chat-history 表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参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | user_name | 否 | String | **参数解释：** 用户名。 **约束限制：** 不涉及 **取值范围：** 必须为1-64位的字母、数字、下划线或短横线。 **默认取值：** 不涉及 | | repo_id | 否 | String | **参数解释：** 知识库ID。 **约束限制：** 不涉及 **取值范围：** 必须为1-64位的字母、数字、下划线或短横线 **默认取值：** 不涉及 | | chat_id | 否 | String | **参数解释：** 对话ID。 **约束限制：** 不涉及 **取值范围：** 必须为1-64位的字母、数字、下划线或短横线 **默认取值：** 不涉及 | | tags | 否 | Array of strings | **参数解释：** 文档标签，查询时取交集。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | type | 否 | String | **参数解释：** 类型，必须为AnswerFromType枚举类中的有效值。 **约束限制：** 不涉及 **取值范围：** - AI -- AI召回 - OTHER -- 其他 **默认取值：** 不涉及 | | page_num | 否 | Integer | **参数解释：** 当前请求的页码，表示从第几页开始获取数据。默认值为1，表示第一页。 **约束限制：** 不涉及 **取值范围：** 1～65535 **默认取值：** 1 | | page_size | 否 | Integer | **参数解释：** 每页显示的记录数，表示一次请求返回的数据条数。默认值为10，表示一页展示10条数据。 **约束限制：** 不涉及 **取值范围：** 1-65535 **默认取值：** 10 | #### 请求参数 表3请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 接口鉴权使用的Token，Token获取方式参考：[获取IAM用户Token](https://support.huaweicloud.com/api-koosearch/koosearch_06_0009.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total | Integer | **参数解释：** 会话历史总数。 **取值范围：** 不涉及 | | size | Integer | **参数解释：** 当前页面返回条数。 **取值范围：** 不涉及 | | pages | Integer | **参数解释：** 总页数。 **取值范围：** 不涉及 | | current | Integer | **参数解释：** 当前页码。 **取值范围：** 不涉及 | | optimize_count_sql | Boolean | **参数解释：** 当前无实际意义。 **取值范围：** 不涉及 | | search_count | Boolean | **参数解释：** 当前无实际意义 **取值范围：** 不涉及 | | records | Array of [ChatHistoryRecordInfo] objects | **参数解释：** 会话历史详情。 **取值范围：** 不涉及 | 表5ChatHistoryRecordInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | chat_id | String | **参数解释：** 会话ID，会话的唯一标识。 **取值范围：** 不涉及 | | knowledge_repo_id | String | **参数解释：** 知识库ID，标识当前会话参考的知识库。 **取值范围：** 不涉及 | | chat_title | String | **参数解释：** 当前会话中的query。 **取值范围：** 不涉及 | | user_name | String | **参数解释：** 用户名。 **取值范围：** 不涉及 | | create_date_time | String | **参数解释：** 会话发生的时间戳。 **取值范围：** 不涉及 | | project_id | String | **参数解释：** 项目ID，1～64个字符，只能包含数字、字母、中划线和下划线，且必须以字母开头。预留字段，可联系负责开通服务的工作人员获取该字段的值。 **取值范围：** 不涉及 | | is_del | Integer | **参数解释：** 当前对话是否删除标记。 **取值范围：** - 0：未删除 - 1：已删除 | | slave_repo_id | String | **参数解释：** 从知识库ID，标识当前会话参考的知识库，使用'","分隔。 **取值范围：** 不涉及 | | type | String | **参数解释：** 类型。 **取值范围：** - AI AI搜索 - MIND_RESEARCH 深度搜索 - OTHER 其他 | | question_models | Array of [QuestionModel] objects | **参数解释：** 历史记录。 **取值范围：** 不涉及 | | actions | Array of strings | **参数解释：** 权限列表。 **取值范围：** 不涉及 | 表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/b25446daeb1a41a7953c5deba2b2677a/applications/be9b19bf-4865-4fb8-b9f8-2fd1fea98d76/uni-search/chat-history?page_num=1&page_size=10 ``` #### 响应示例 **状态码：200** 查看成功。 ``` { "records" : [ { "chat_id" : "e447ed24-b3e0-4184-96cc-e06a9dc6cf89", "knowledge_repo_id" : "176e63a2-73bd-415c-aab2-f688030855e3", "chat_title" : "今天天气", "create_date_time" : "1695196394925", "is_del" : 0 }, { "chat_id" : "2c57dd12-0384-46c8-8d13-ae78dc857d94", "knowledge_repo_id" : "176e63a2-73bd-415c-aab2-f688030855e3", "chat_title" : "人工智能会取代人类吗", "create_date_time" : "1695195832442", "is_del" : 0 }, { "chat_id" : "ff193ad6-c812-402c-8233-f7ab5f4b0b11", "knowledge_repo_id" : "176e63a2-73bd-415c-aab2-f688030855e3", "chat_title" : "人工智能会取代人类吗", "create_date_time" : "1695195733199", "is_del" : 0 }, { "chat_id" : "f557e561-cc8f-47b1-bbd7-9d6064293588", "knowledge_repo_id" : "176e63a2-73bd-415c-aab2-f688030855e3", "chat_title" : "今天天气好吗", "create_date_time" : "1695195285924", "is_del" : 0 }, { "chat_id" : "a0330214-ea10-4aba-874a-06cefa4bc77a", "knowledge_repo_id" : "852947fe-6c60-4d91-af65-839a0292127e", "chat_title" : "神经网络是什么", "create_date_time" : "1695193989920", "is_del" : 0 }, { "chat_id" : "fbc01f0d-a9c4-4d80-a8e4-7c2e191472e9", "knowledge_repo_id" : "fba6ea89-5d9a-4835-9a8d-3ecebfc023e9", "chat_title" : "你好吗", "create_date_time" : "1695193289515", "is_del" : 0 }, { "chat_id" : "475ad732-d682-4899-8263-6643e1f1d045", "knowledge_repo_id" : "d3e0e470-0032-4907-ba64-9aba4521ed0c", "chat_title" : "你好吗", "create_date_time" : "1695193277246", "is_del" : 0 }, { "chat_id" : "73e00b01-df45-4222-81f1-018726e66315", "knowledge_repo_id" : "fba6ea89-5d9a-4835-9a8d-3ecebfc023e9", "chat_title" : "杭州在哪里", "create_date_time" : "1695192613055", "is_del" : 0 }, { "chat_id" : "f6bee59c-a8b9-41d7-bca3-06b4e28fd70b", "knowledge_repo_id" : "d3e0e470-0032-4907-ba64-9aba4521ed0c", "chat_title" : "杭州在哪里", "create_date_time" : "1695192600724", "is_del" : 0 }, { "chat_id" : "8b8d345e-833c-4b71-9bdd-e4ba75a6457e", "knowledge_repo_id" : "dbac6a40-6142-4447-b7ad-6718c089faf4", "chat_title" : "something", "create_date_time" : "1695115924537", "is_del" : 0 } ], "total" : 222, "size" : 10, "current" : 1, "optimize_count_sql" : true, "search_count" : true, "pages" : 23 } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 查看成功。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-koosearch/ErrorCode.html)。