文档首页/ 华为云Flexus云服务_Flexus企业搜索服务/ API参考/ 对话历史/ 查询对话历史列表
更新时间：2024-08-27 GMT+08:00
查看PDF
分享

查询对话历史列表

功能介绍

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

URI

GET /v1/koosearch/chat-history

表1 Query参数

参数

是否必选

参数类型

描述

user_name

否

String

用户名

最小长度：1

最大长度：64

repo_id

否

String

知识库ID

获取方式：

账号登录KooSearch体验平台，在左侧导航栏选择："知识库管理" ，在此界面获取"知识库ID"字段的值，表示该知识库在向量数据库中存储的ID，具有唯一性

最小长度：1

最大长度：64

page_num

否

Integer

请求页码

最小值：1

最大值：65535

缺省值：1

page_size

否

Integer

请求限定响应结果的分页大小，例如5条/页，10条/页

最小值：1

最大值：65535

缺省值：10

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

接口鉴权使用的Token，Token获取方式参考：获取IAM用户Token

最小长度：1

最大长度：1000000

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

total

Integer

会话历史总数

最小值：1

最大值：65535

size

Integer

当前页面返回条数

最小值：1

最大值：65535

pages

Integer

总页数

最小值：1

最大值：65535

current

Integer

当前页码

最小值：1

最大值：65535

optimize_count_sql

Boolean

当前无实际意义

search_count

Boolean

当前无实际意义

records

Array of ChatHistoryRecordInfo objects

会话历史详情

数组长度：0 - 65535
表4 ChatHistoryRecordInfo

参数

参数类型

描述

chat_id

String

会话ID，会话的唯一标识

最小长度：1

最大长度：64

knowledge_repo_id

String

知识库ID，标识当前会话参考的知识库

最小长度：1

最大长度：64

chat_title

String

当前会话中的query

最小长度：1

最大长度：65535

create_date_time

String

会话发生的时间戳

最小长度：1

最大长度：13

project_id

String

项目ID，1～64个字符，只能包含数字、字母、中划线和下划线，且必须以字母开头。预留字段，可联系负责开通服务的工作人员获取该字段的值

最小长度：1

最大长度：64

is_del

Integer

当前对话是否删除标记，0：未删除，1：已删除

枚举值：

  • 0

  • 1

请求示例

无

响应示例

状态码： 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

成功

错误码

请参见错误码。

父主题： 对话历史

相关文档