查询对话历史列表

功能介绍

查询历史问题列表。包含对话ID、对话问题、用户名、对话开始时间。

URI

GET /v1/koosearch/chat-history

表1 Query参数
参数	是否必选	参数类型	描述
user_name	否	String	用户名。
repo_id	否	String	知识库ID。获取方式：账号登录KooSearch体验平台，在左侧导航栏选择："知识库管理" ，在此界面获取"知识库ID"字段的值，表示该知识库在向量数据库中存储的ID，具有唯一性
chat_id	否	String	对话ID。
page_num	否	Integer	请求页码。
page_size	否	Integer	请求限定响应结果的分页大小，例如5条/页，10条/页。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：接口鉴权使用的Token，Token获取方式参考：3.2节认证鉴权。约束限制：不涉及。

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
total	Integer	会话历史总数。
size	Integer	当前页面返回条数。
pages	Integer	总页数。
current	Integer	当前页码。
optimize_count_sql	Boolean	当前无实际意义。
search_count	Boolean	当前无实际意义。
records	Array of ChatHistoryRecordInfo objects	会话历史详情。

表4 ChatHistoryRecordInfo
参数	参数类型	描述
chat_id	String	会话ID，会话的唯一标识。
knowledge_repo_id	String	知识库ID，标识当前会话参考的知识库。
slave_repo_id	String	从知识库ID。
chat_title	String	当前会话中的query。
create_date_time	String	会话发生的时间戳。
project_id	String	项目ID，1～64个字符，只能包含数字、字母、中划线和下划线，且必须以字母开头。预留字段，可联系负责开通服务的工作人员获取该字段的值。
is_del	Integer	当前对话是否删除标记，0：未删除，1：已删除。

请求示例

无

响应示例

状态码：200

返回成功。

{
  "records" : [ {
    "chat_id" : "8080de56-be09-4e80-a9e3-efe1e0505d16",
    "knowledge_repo_id" : "d848a560-6c71-4c87-ab3f-8b6e63ebbe62",
    "chat_title" : "安全保护机制测试",
    "create_date_time" : "1731052459260",
    "project_id" : "b25446daeb1a41a7953c5deba2b2677a",
    "is_del" : 0,
    "slave_repo_id" : "09d83dce-4379-47d6-8753-c0fb76c360a3,f4b45b6c-1331-411c-9d0a-adfc8a55877b"
  }, {
    "chat_id" : "0c11fab3-2a9e-4ceb-842b-178ae21b302d",
    "knowledge_repo_id" : "d848a560-6c71-4c87-ab3f-8b6e63ebbe62",
    "chat_title" : "球兰和心叶球兰有什么区别",
    "create_date_time" : "1731051914932",
    "project_id" : "b25446daeb1a41a7953c5deba2b2677a",
    "is_del" : 0
  }, {
    "chat_id" : "bb7fbd8a-ec5a-4d23-a6f3-0188d2b34377",
    "knowledge_repo_id" : "d848a560-6c71-4c87-ab3f-8b6e63ebbe62",
    "chat_title" : "介绍一下生石花",
    "create_date_time" : "1731050885407",
    "project_id" : "b25446daeb1a41a7953c5deba2b2677a",
    "is_del" : 0
  }, {
    "chat_id" : "188eaa84-c09a-46a5-bade-f6301a9b3046",
    "knowledge_repo_id" : "d848a560-6c71-4c87-ab3f-8b6e63ebbe62",
    "chat_title" : "什么是多肉植物",
    "create_date_time" : "1731050363161",
    "project_id" : "b25446daeb1a41a7953c5deba2b2677a",
    "is_del" : 0
  }, {
    "chat_id" : "f939c01e-8042-49bb-b207-6575f98bbaeb",
    "knowledge_repo_id" : "acd90739-2e22-4870-b2db-35018699b623",
    "chat_title" : "发动机故障有哪些？",
    "create_date_time" : "1731049696207",
    "project_id" : "b25446daeb1a41a7953c5deba2b2677a",
    "is_del" : 0
  }, {
    "chat_id" : "fb12825c-1f93-487e-b5ef-e03f711a4219",
    "knowledge_repo_id" : "09d83dce-4379-47d6-8753-c0fb76c360a3",
    "chat_title" : "《Development and Analysis of Fast-Charging Model of Electric Vehicles》内容概要是怎样的?",
    "create_date_time" : "1731049167914",
    "project_id" : "b25446daeb1a41a7953c5deba2b2677a",
    "is_del" : 0
  }, {
    "chat_id" : "b267029c-9081-421d-8df2-36941a35f167",
    "knowledge_repo_id" : "09d83dce-4379-47d6-8753-c0fb76c360a3",
    "chat_title" : "《Development and Analysis of Fast-Charging Model of Electric Vehicles》内容概要是怎样的?",
    "create_date_time" : "1731049057770",
    "project_id" : "b25446daeb1a41a7953c5deba2b2677a",
    "is_del" : 0
  }, {
    "chat_id" : "ea64df7f-2a43-4158-a502-d74bcf438ab6",
    "knowledge_repo_id" : "09d83dce-4379-47d6-8753-c0fb76c360a3",
    "chat_title" : "中国纯电动乘用车续驶里程和能耗评价是依据什么标准",
    "create_date_time" : "1731048963883",
    "project_id" : "b25446daeb1a41a7953c5deba2b2677a",
    "is_del" : 0
  }, {
    "chat_id" : "0227a870-8713-4a09-9253-2347d715bcd6",
    "knowledge_repo_id" : "09d83dce-4379-47d6-8753-c0fb76c360a3",
    "chat_title" : "中国纯电动乘用车续驶里程和能耗评价是依据什么标准",
    "create_date_time" : "1731048945303",
    "project_id" : "b25446daeb1a41a7953c5deba2b2677a",
    "is_del" : 0
  }, {
    "chat_id" : "bb5e22ca-42a0-453a-aef7-776ecc937eb0",
    "knowledge_repo_id" : "09d83dce-4379-47d6-8753-c0fb76c360a3",
    "chat_title" : "中国纯电动乘用车续驶里程和能耗评价是依据什么标准",
    "create_date_time" : "1731048825929",
    "project_id" : "b25446daeb1a41a7953c5deba2b2677a",
    "is_del" : 0
  } ],
  "total" : 40798,
  "size" : 10,
  "current" : 1,
  "pages" : 4080
}