[Dify] 知识库 API 使用指南：如何通过 API 灵活插入文档条目

在使用 Dify 构建智能应用的过程中，知识库（Knowledge Base）是一个非常核心的功能。除了在 Dify 的 Web 界面中手动上传文档，其实还可以通过调用 API 来实现更自动化、灵活的文档管理。

本文以 Dify 版本 14.2 为例，讲解如何通过 API 向知识库插入文本条目，并重点说明常见易混淆的参数配置和调用细节。

 

---

为什么通过 API 管理知识库？

相比 Web 界面操作，使用 API 进行知识库管理有如下优势：

• 自动化：可以集成到自有业务系统，实现文档实时同步。

• 批量处理：支持大规模文档插入与更新。

• 更高的灵活性：支持动态生成内容后直接写入知识库。

---

API 接口地址

向知识库插入文本条目的 API 地址格式类似如下形式：

POST /datasets/{dataset_id}/document/create-by-text

dataset_id 获取方法

⚠️ 需要注意，dataset_id 并不是你