文档中心

数据智能体

结构化知识库管理

查询结构化数据资产列表

查询结构化数据资产列表

调用本接口按目录、数据来源、处理状态或名称关键词分页查询结构化数据资产。

调用方：开放平台应用、外部 Agent 或集成服务。
前置条件：调用者拥有知识库查看权限。

接口说明

接口名称：list_assets_structured_knowledge_v1_kbs__kb_id__assets_get
接口地址：/structured_knowledge/v1/kbs/{kb_id}/assets
请求方式：GET

请求参数

Path

参数名	类型	是否必传	描述
kb_id	String	是	结构化知识库 ID，由创建知识库或查询知识库列表接口返回

Query

参数名	类型	是否必传	描述
source_type	String	否	数据来源类型筛选：EXCEL、CSV、CLICKHOUSE 或 HIVE
status	String	否	数据资产处理状态筛选
folder_id	String	否	目录 ID 筛选；0 表示知识库根目录
include_descendants	Boolean	否	是否递归包含当前目录及其所有子目录中的资产；默认 false，仅查询当前目录
kw	String	否	资产名称模糊搜索关键词
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

参数名	类型	是否必传	描述
asset_id	String	是	结构化数据资产唯一 ID
kb_id	String	是	资产所属的结构化知识库 ID
asset_name	String	是	结构化数据资产名称
source_type	String	是	文件类型 EXCEL CSV CLICKHOUSE HIVE
status	String	是	状态 DRAFT READY_PENDING_IMPORT READY DISABLED DELETED CREATE_FAILED IMPORTING IMPORT_FAILED DELETING DELETE_FAILED
source	Object	是	源数据，详情请参见下文 source 表
folder_id	String	否	资产所属目录 ID
source_file_name	String	否	原始上传文件名；数据集来源可为空
file_size	Number	否	原始文件大小，单位字节；数据集来源可为空
row_count	Number	否	当前已写入 OpenSearch 的数据行数
last_error	String	否	最近一次处理失败原因；无失败时为空
created_by	String	否	创建人账号
create_time	Number	否	创建时间，Unix 毫秒时间戳
update_time	Number	否	最近更新时间，Unix 毫秒时间戳

source

参数名	类型	是否必传	描述
source_type	String	是	文件类型 EXCEL CSV CLICKHOUSE HIVE
file_id	String	否	Excel/CSV 上传后的文件 ID
dataset_id	String	否	ClickHouse/Hive 的 Prep 数据集 ID
dataset_name	String	否	ClickHouse/Hive 的 Prep 数据集名称
database_name	String	否	源数据库名称
table_name	String	否	源数据表名称
sheet_name	String	否	Excel 工作表名称；CSV 通常为 default

最近更新时间：2026.09.17 19:26:38

这个页面对您有帮助吗？

有用

有用

无用

无用