必须用Python调用Dify官方API实现知识库文档批量管理：先获取API密钥和32位知识库ID，配置环境变量；再通过multipart上传或多步异步方式批量导入文件；删除时需分页拉取文档列表并校验筛选逻辑；更新元数据支持单文档PATCH或批量启用状态PUT。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要一次性向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免费学习笔记（深入）”；
新建一个 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”）。
方法二：先创建空文档再异步上传内容（适合大文件或需精细控制分块）
第一步：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 或其他字段。
