1、功能说明
调用此指令，可以创建一个文本知识库或图片知识库。新知识库默认为空，需要通过创建知识库文件指令上传文本或图片。
相关扣子 API 接口详细介绍见：https://www.coze.cn/open/docs/developer_guides/create_dataset
2、配置项
输入参数
| 参数名 | 必填 | 说明 |
|---|---|---|
| 知识库名称 | 是 | 要创建的知识库的名称，用于标识该知识库。 |
| Token | 是 | 用于验证身份的令牌，确保请求的合法性。 |
| 知识库空间 ID | 是 | 该知识库所属的空间唯一标识，用于在多空间场景下区分数据归属。 |
| 知识库类型 | 是 | 选择要创建的知识库类型，可选值为 “文本知识库” 或 “图片知识库”。 |
输出参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| 返回结果 | 变量 | 接口返回的完整响应内容，包含创建操作的状态、错误信息等。 |
| 知识库 ID | 变量 | 仅当 API 调用成功时返回，新创建的知识库的唯一标识，后续对知识库的操作（如上传文件、查询等）需依赖此 ID。 |
返回结果示例
成功响应
{
"code": 0,
"msg": "success",
"data": {
"dataset_id": "ds_657dxxxxxxxxx",
"name": "产品说明书知识库",
"type": "TEXT",
"space_id": "sp_657dxxxxxxxxx",
"create_time": "2025-12-01T10:30:00Z"
}
}
此时，知识库ID 会被赋值为 ds_657dxxxxxxxxx。失败响应
API调用失败的时候指令会调用错误。
3、示例流程
- 在 “知识库名称” 输入框中填写 “产品说明书知识库”。
- 粘贴有效的访问 Token 到 “Token” 输入框。
- 输入目标空间的 “知识库空间 ID”。
- 在 “知识库类型” 下拉菜单中选择 “文本知识库”。
- 运行指令后，通过 “知识库 ID” 变量获取新创建的知识库唯一标识，供后续上传文件使用。
4、注意事项
如果创建失败，可能的原因及处理方式：
- Token 无效或过期：请检查 Token 是否正确，或重新获取有效的 Token。
- 知识库空间 ID 错误：确认输入的空间 ID 与实际拥有的空间 ID 一致。
- 知识库类型选择错误：需在下拉选项中选择合法的类型（文本 / 图片）。
- 接口调用频率超限：请降低调用频率，或联系平台方调整配额。