文档中心

数据智能体 DataAgent（私有化）

结构化知识库管理

创建结构化知识库

创建结构化知识库

调用本接口创建结构化知识库，并为当前调用者登记创建者权限。

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

接口说明

接口名称：create_kb_structured_knowledge_v1_kbs_post
接口地址：/structured_knowledge/v1/kbs
请求方式：POST

请求参数

参数名	类型	是否必传	描述
Idempotency-Key	String	是	调用方生成的写请求幂等键；同一租户、操作和请求体重试时必须保持不变

请求体

Object 类型，包含参数如下：

参数名	类型	是否必传	描述
name	String	是	结构化知识库名称，长度 1 到 255 个字符
description	String	否	结构化知识库业务说明，最多 2048 个字符

响应参数

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

data

参数名	类型	是否必传	描述
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:47

这个页面对您有帮助吗？

有用

有用

无用

无用