j9九游会登录/ 应用平台 appstage/ api参考/ / / 查询知识库列表(token认证)
更新时间:2025-08-06 gmt 08:00

查询知识库列表(token认证)-j9九游会登录

功能介绍

该接口用于查询知识库列表,包括名称、描述、状态、检索方式等信息。

调用方法

请参见。

uri

get https://aiae.appstage.myhuaweicloud.com/v1/unidata/knowledge-bases

表1 query参数

参数

是否必选

参数类型

描述

name

string

参数解释:

知识库名称。

约束限制:

支持中英文、数字、下划线(_),1-50个字符。

取值范围:

不涉及。

默认取值:

不涉及。

scope

string

参数解释:

知识库范围类型。

约束限制:

不涉及。

取值范围:

枚举值:

  • private:用户创建知识库。

  • public:平台预置知识库。

  • community:社区内公开,用户指定公开的维度,如按照部门公开。

默认取值:

不涉及。

offset

integer

参数解释:

偏移量。

约束限制:

不涉及。

取值范围:

正整数。

默认取值:

0。

limit

integer

参数解释:

分页每页的条目数量。

约束限制:

不涉及。

取值范围:

1-1000的整数。

默认取值:

10。

data_set_status

array of strings

参数解释:

数据集记录状态。

约束限制:

不涉及。

取值范围:

枚举值:

  • creating:创建中。

  • disable:状态异常。

  • waiting_schedule:等待执行。

  • scheduling:执行中。

  • normal:正常。

  • schedule_failed:执行失败。

  • freeze冻结:cbc触发。

默认取值:

不涉及。

retrieval_status

string

参数解释:

知识库检索状态。

约束限制:

不涉及。

取值范围:

枚举值:

  • enable:已启用。

  • disable:已停用 。

默认取值:

不涉及。

rag_type

string

参数解释:

rag类型。

约束限制:

不涉及。

取值范围:

枚举值:

  • vector_rag:向量rag。

  • graph_rag:图谱rag。

默认取值:

不涉及。

请求参数

表2 请求header参数

参数

是否必选

参数类型

描述

x-auth-token

string

参数解释:

用户token。通过调用iam服务获取用户token接口获取(响应消息头中x-subject-token的值)。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

表3 响应body参数

参数

参数类型

描述

data

pageinfoknowledgebaset object

知识库列表信息。

表4 pageinfoknowledgebaset

参数

参数类型

描述

total

long

参数解释:

知识库总数。

取值范围:

不涉及。

list

array of knowledgebaset objects

参数解释:

知识库信息列表。

取值范围:

不涉及。

pagenum

integer

参数解释:

当前页。

取值范围:

不涉及。

pagesize

integer

参数解释:

每页的数量。

取值范围:

不涉及。

size

integer

参数解释:

当前页的数量。

取值范围:

不涉及。

startrow

long

参数解释:

当前页面第一个元素在数据库中的行号。

取值范围:

不涉及。

endrow

long

参数解释:

当前页面最后一个元素在数据库中的行号。

取值范围:

不涉及。

pages

integer

参数解释:

总页数。

取值范围:

不涉及。

prepage

integer

参数解释:

前一页。

取值范围:

不涉及。

nextpage

integer

参数解释:

后一页。

取值范围:

不涉及。

isfirstpage

boolean

参数解释:

是否为第一页。

取值范围:

不涉及。

islastpage

boolean

参数解释:

是否为最后一页。

取值范围:

不涉及。

haspreviouspage

boolean

参数解释:

是否有前一页。

取值范围:

不涉及。

hasnextpage

boolean

参数解释:

是否有下一页。

取值范围:

不涉及。

navigatepages

integer

参数解释:

导航页总数。

取值范围:

不涉及。

navigatepagenums

array of integers

参数解释:

所有导航页号。

取值范围:

不涉及。

navigatefirstpage

integer

参数解释:

导航页上一页。

取值范围:

不涉及。

navigatelastpage

integer

参数解释:

导航页下一页。

取值范围:

不涉及。

表5 knowledgebaset

参数

参数类型

描述

last_updated_date

string

参数解释:

最近更新时间。

取值范围:

格式为:yyyy-mm-dd hh:mm:ss,如2024-11-21 11:36:55。

last_updated_by_user_id

string

参数解释:

最近一次更新人id。

取值范围:

不涉及。

last_updated_by_user_name

string

参数解释:

最近一次更新人名称。

取值范围:

不涉及。

last_updated_by_nick_name

string

参数解释:

最新一次更新人名称。

取值范围:

不涉及。

tenant_id

string

参数解释:

租户id。

取值范围:

不涉及。

tenant_name

string

参数解释:

租户名称。

取值范围:

不涉及。

dept_code

string

参数解释:

部门编码。

取值范围:

不涉及。

created_date

string

参数解释:

创建日期。

取值范围:

不涉及。

created_by_user_id

string

参数解释:

创建人id。

取值范围:

不涉及。

created_by_user_name

string

参数解释:

创建人名称。

取值范围:

不涉及。

created_by_nick_name

string

参数解释:

创建人名称。

取值范围:

不涉及。

deleted

boolean

参数解释:

是否删除。

取值范围:

不涉及。

id

string

参数解释:

知识库id。

取值范围:

不涉及。

name

string

参数解释:

知识库名称。

取值范围:

不涉及。

description

string

参数解释:

知识库描述。

取值范围:

不涉及。

rag_type

string

参数解释:

知识库rag类型。

取值范围:

可以为空,为空则使用默认值。

枚举值:

  • vector_rag:向量rag,是一种结合了向量化和大语言模型的rag技术。

  • graph_rag:知识图谱rag,是一种结合了知识图谱和大语言模型的rag技术。

retrieval_config

retrievalconfig object

参数解释:

数据库检索配置。

取值范围:

不涉及。

scope

string

参数解释:

知识库范围类型。

取值范围:

枚举值:

  • private:用户创建知识库。

  • public:平台预置知识库。

  • community:社区内公开,用户指定公开的维度,如按照部门公开。

embed_database

string

参数解释:

向量数据库名称。

取值范围:

不涉及。

db_invoke_api

string

参数解释:

知识库调用api。

取值范围:

不涉及。

status

string

参数解释:

知识库状态。

取值范围:

枚举值:

  • waiting_schedule:等待执行。

  • scheduling:执行中。

  • normal:正常。

  • schedule_failed:执行失败。

  • freeze冻结:cbc触发。

retrieval_status

string

参数解释:

知识库检索状态。

取值范围:

不涉及。

schedule_type

string

参数解释:

调度类型。

取值范围:

不涉及。

schedule_config_id

string

参数解释:

周期性调度配置id。

取值范围:

不涉及。

schedule_status

string

参数解释:

周期性调度状态。

取值范围:

生效、暂停。

llama_index

boolean

参数解释:

标记是否由llamaindex生成。

取值范围:

不涉及。

表6 retrievalconfig

参数

参数类型

描述

retrieval_modes

array of strings

参数解释:

检索模式,用于设置知识库检索召回时的检索方式。

约束限制:

不涉及。

取值范围:

可传多个值。枚举值:

  • semantic_retrieval:使用向量进行文本语义查询,即调用向量数据库根据向量的相似性检索。

  • full_text_retrieval:使用关键字进行文本匹配,适合查找一些关键词和主题语的数据。

默认取值:

不涉及。

retrieval_hybrid_mode

string

参数解释:

此参数用于指定混合检索的模式。

“retrieval_modes”选择semantic_retrieval和full_text_retrieval时,为混合检索。

约束限制:

“retrieval_modes”选择semantic_retrieval和full_text_retrieval。

取值范围:

支持rrf,枚举值:rrf。

默认取值:

不涉及。

状态码:400

表7 响应body参数

参数

参数类型

描述

error_code

string

参数解释:

异常错误码。

取值范围:

不涉及。

error_msg

string

参数解释:

异常错误信息。

取值范围:

不涉及。

请求示例

响应示例

状态码:200

查询知识库列表响应参数。

{
  "data" : {
    "total" : 1,
    "list" : [ {
      "last_updated_date" : "2025-07-25t09:03:50.000 00:00",
      "last_updated_by_user_id" : "f0e1c67f3ee445cb938fb86bfbdf2255",
      "last_updated_by_user_name" : "developer",
      "last_updated_by_nick_name" : "developer",
      "tenant_id" : "1015192394",
      "tenant_name" : "developer",
      "dept_code" : "1015192394",
      "created_date" : "2025-07-24t09:23:17.000 00:00",
      "created_by_user_id" : "f0e1c67f3ee445cb938fb86bfbdf2255",
      "created_by_user_name" : "developer",
      "created_by_nick_name" : "developer",
      "deleted" : false,
      "id" : "febb587f-20fb-4ec2-8431-f5b8858fecde",
      "name" : "测试_0724_003",
      "description" : "0724第一次修改",
      "rag_type" : "vector_rag",
      "retrieval_config" : {
        "retrieval_modes" : [ "semantic_retrieval" ]
      },
      "scope" : "private",
      "dimension" : null,
      "community_auth_codes" : [ ],
      "embed_database" : "click_house",
      "db_invoke_api" : "embedding_api",
      "status" : "normal",
      "retrieval_status" : "disable",
      "schedule_type" : "once",
      "schedule_config_id" : null,
      "schedule_status" : null,
      "llama_index" : true,
      "type" : "kb1"
    } ],
    "pagenum" : 1,
    "pagesize" : 10,
    "size" : 2,
    "startrow" : 0,
    "endrow" : 1,
    "pages" : 1,
    "prepage" : 0,
    "nextpage" : 0,
    "isfirstpage" : true,
    "islastpage" : true,
    "haspreviouspage" : false,
    "hasnextpage" : false,
    "navigatepages" : 8,
    "navigatepagenums" : [ 1 ],
    "navigatefirstpage" : 1,
    "navigatelastpage" : 1
  }
}

状态码

状态码

描述

200

查询知识库列表响应参数。

400

错误请求。

错误码

请参见错误码

相关文档

网站地图