文档中心

数据智能体 DataAgent（私有化）

结构化知识库管理

查询结构化知识库目录

查询结构化知识库目录

调用本接口查询结构化知识库目录树，返回与知识库同名的根目录及其子目录。

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

接口说明

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

请求参数

Path

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

响应参数

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

data

参数名	类型	是否必传	描述
folder_id	String	是	目录唯一 ID；根目录通常为 0
kb_id	String	是	目录所属的结构化知识库 ID
parent_folder_id	String	否	父目录 ID；根目录没有父目录
name	String	是	目录名称
status	String	否	目录状态
asset_count	Number	否	目录下直接归属的数据资产数量
children	Array	否	子目录列表。递归循环 data 参数。

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

这个页面对您有帮助吗？

有用

有用

无用

无用