查询对话历史列表
功能介绍
查询历史问题列表。包含对话ID、对话问题、用户名、对话开始时间。
URI
GET /v1/koosearch/chat-history
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
user_name |
否 |
String |
用户名。 |
repo_id |
否 |
String |
知识库ID。 获取方式: 账号登录KooSearch体验平台,在左侧导航栏选择:"知识库管理" ,在此界面获取"知识库ID"字段的值,表示该知识库在向量数据库中存储的ID,具有唯一性 |
chat_id |
否 |
String |
对话ID。 |
page_num |
否 |
Integer |
请求页码。 |
page_size |
否 |
Integer |
请求限定响应结果的分页大小,例如5条/页,10条/页。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
参数解释: 接口鉴权使用的Token,Token获取方式参考:3.2节 认证鉴权。 约束限制: 不涉及。 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
total |
Integer |
会话历史总数。 |
size |
Integer |
当前页面返回条数。 |
pages |
Integer |
总页数。 |
current |
Integer |
当前页码。 |
optimize_count_sql |
Boolean |
当前无实际意义。 |
search_count |
Boolean |
当前无实际意义。 |
records |
Array of ChatHistoryRecordInfo objects |
会话历史详情。 |
参数 |
参数类型 |
描述 |
---|---|---|
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 |
返回成功。 |
错误码
请参见错误码。