Dify知识库批量管理：通过Python脚本API增删改-人工智能-PHP中文网

必须用python调用dify官方api实现知识库文档批量管理：先获取api密钥和32位知识库id，配置环境变量；再通过multipart上传或多步异步方式批量导入文件；删除时需分页拉取文档列表并校验筛选逻辑；更新元数据支持单文档patch或批量启用状态put。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

dify知识库批量管理：通过python脚本api增删改

你需要一次性向Dify知识库导入几百个文档，或者批量删除过期文件，又或者更新一批文档的描述字段——手动在网页端操作既耗时又容易出错，必须用Python调用Dify官方API自动化完成。

准备工作：获取API密钥与知识库ID

登录Dify控制台→点击右上角头像→【API Keys】→点击【Create API Key】→复制生成的密钥（形如“app-xxxxxx”），该密钥需保存好，【页面关闭后无法再次查看】。

打开知识库列表页，点击目标知识库名称进入详情页，观察浏览器地址栏URL，提取其中以“/datasets/”开头后的32位十六进制字符串，例如“/datasets/8a1b2c3d4e5f678901234567890abcde”，这串就是知识库ID。

安装依赖并初始化客户端

执行 pip install requests python-dotenv 安装必需库。

新建一个 Python 文件（如 manage_dataset.py），在同级目录下创建 .env 文件，写入两行：

DIFY_API_KEY=app-xxxxxxxxxxxxxxxxxxxxxxxx

DIFY_BASE_URL=https://api.dify.ai/v1

注意：DIFY_BASE_URL 必须带 /v1 后缀，漏掉会导致所有请求返回 404；国内用户若使用自建Dify服务，请将域名替换为你的实际部署地址。

批量上传本地PDF/Markdown文档

方法一：单次请求上传多个文件（推荐用于≤20个文件）

准备一个 docs/ 文件夹，把所有待上传的 .pdf、.md、.txt 文件放进去；脚本中用 os.listdir() 读取文件名，对每个文件构建 multipart/form-data 请求体，POST 到 /datasets/{dataset_id}/document

关键参数必须包含：file（二进制文件流）、name（原始文件名，不可省略）、process_rule.mode（填“automatic”或“custom”）、indexing_technique（填“high_quality”或“economy”）。

方法二：先创建空文档再异步上传内容（适合大文件或需精细控制分块）

python学习

Python 编程学习助手 skill，面向零基础用户。当用户表达以下意图时触发： - 学习 Python 基础概念（变量、数据类型、循环、函数、类等） - 请求 Python 练习题或测验 - 请求审查或调试 Python 代码 - 请求 Python 项目实战指导（爬虫、数据分析、Web 开发等入门项目） - 泛化表述如"教我 Python""我想学编程""Python 怎么写""帮我学 Python" 此 skill

下载

第一步：POST /datasets/{dataset_id}/document → body 中传 { "name": "report_v2.pdf", "process_rule": { "mode": "custom", "rules": { "pre_processing_rules": [{"id": "remove_extra_spaces", "enabled": true}] } } }，获取返回的 document_id；第二步：用该 document_id 调用 /datasets/{dataset_id}/document/{document_id}/upload，传入文件流。

【两次调用间至少间隔1秒，否则可能触发限流导致第二步失败】

批量删除知识库中的文档

① 先 GET /datasets/{dataset_id}/documents?page=1&limit=100 获取全部文档列表，注意检查 response["has_more"] 字段，若为 true 需继续翻页拉取；

② 遍历 documents 数组，筛选出需要删除的 document_id（可按 name 字段模糊匹配，如 "temp_" in doc["name"]）；

③ 对每个目标 document_id，发起 DELETE 请求到 /datasets/{dataset_id}/document/{document_id}；

④ 每次删除后检查响应状态码是否为 200，不是则记录 error_log.txt 并跳过继续下一个；

这一步没有撤回机制，删错无法恢复，务必先用测试知识库验证筛选逻辑。

批量更新文档元数据（如描述、启用状态）

方法一：PATCH 单文档（适用于少量更新）

对指定 document_id 发起 PATCH 请求到 /datasets/{dataset_id}/document/{document_id}，body 示例：{"enabled": false, "description": "已归档的2023年销售简报"}。

方法二：PUT 批量覆盖（仅限更新 enabled 状态）

构造 JSON 数组，每个元素含 document_id 和 enabled 值，如 [{"document_id": "doc_abc", "enabled": true}, {"document_id": "doc_def", "enabled": false}]，POST 到 /datasets/{dataset_id}/documents/enable，注意该接口不接受 description 或其他字段。