文档中心

数据智能体 DataAgent（私有化）

结构化知识库管理

查询结构化知识库列表

查询结构化知识库列表

调用本接口按名称关键词和状态分页查询当前调用者有权访问的结构化知识库。

调用方：开放平台应用、外部 Agent 或集成服务。
前置条件：使用 Authorization 完成认证。

接口说明

接口名称：list_kbs_structured_knowledge_v1_kbs_get
接口地址：/structured_knowledge/v1/kbs
请求方式：GET

请求参数

Query

参数名	类型	是否必传	描述
kw	String	否	知识库名称模糊搜索关键词
status	String	否	知识库状态筛选，例如 ACTIVE 或 DISABLED
page	Number	否	页码，从 1 开始
page_size	Number	否	每页数量，范围 1 到 100

响应参数

参数名	类型	是否必传	描述
code	Number	是	响应码：0=成功，非0=失败
msg	String	否	Code非0时，返回错误信息
message	String	否	错误信息
data	Object	是	数据。详情请参见下文 data 表

data

参数名	类型	是否必传	描述
items	Array	否	当前页的结构化知识库列表。详情请参见下文 items 表
total	Number	否	符合查询条件的知识库总数
page	Number	否	当前页码，从 1 开始
page_size	Number	否	每页返回数量

items

参数名	类型	是否必传	描述
kb_id	String	是	结构化知识库唯一 ID
name	String	是	结构化知识库名称
description	String	否	结构化知识库业务说明
status	String	是	知识库状态，例如 ACTIVE、DISABLED 或 DELETED
asset_count	Number	否	知识库下未删除的数据资产数量
total_row_count	Number	否	知识库下全部未删除资产的数据行总数
created_by	String	否	创建人账号
create_time	Number	否	创建时间，Unix 毫秒时间戳
update_time	Number	否	最近更新时间，Unix 毫秒时间戳

最近更新时间：2026.09.11 14:59:46

这个页面对您有帮助吗？

有用

有用

无用

无用