更新时间:2025-07-22 GMT+08:00
分享

查询对话历史列表

功能介绍

查询历史问题列表。包含对话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
}

状态码

状态码

描述

200

返回成功。

错误码

请参见错误码

相关文档