### 使用 Python API 将 docx 文件上传至 Dify 知识库 通过 Python 调用 Dify 的 API，可以实现将 `.docx` 文件上传到其知识库的功能。这通常涉及以下几个方面：构建 HTTP 请求、设置认证信息以及传递文件数据。 以下是具体方法和示例代码： #### 方法概述 1. **获取 API 密钥**：确保已获得访问 Dify 平台所需的 API Key 或其他形式的身份验证令牌。 2. **定义请求 URL**：根据官方文档或实际环境配置，指定用于上传文件的端点地址。 3. **构造 POST 请求**：使用 `requests` 库或其他 HTTP 客户端工具发送带有文件参数的 POST 请求。 4. **处理响应**：解析服务器返回的结果以确认操作成功与否。 #### 示例代码 以下是一个完整的 Python 实现案例，展示如何将 `.docx` 文件上传到 Dify 知识库[^2]。 ```python import requests def upload_docx_to_dify(api_url, api_key, file_path): """ 上传 .docx 文件到 Dify 知识库 参数: api_url (str): Dify 提供的文件上传接口 URL api_key (str): 用户身份验证密钥 file_path (str): 待上传的 .docx 文件路径 返回: dict: 响应结果 JSON 数据 """ headers = { 'Authorization': f'Bearer {api_key}' # 设置授权头 } with open(file_path, 'rb') as file_obj: # 打开目标文件作为二进制模式读取对象 files = {'file': (file_path.split('/')[-1], file_obj, 'application/vnd.openxmlformats-officedocument.wordprocessingml.document')} response = requests.post( url=api_url, headers=headers, files=files ) if response.status_code == 200 or response.status_code == 201: return {"status": "success", "data": response.json()} else: return {"status": "error", "message": response.text} # 配置变量 API_URL = "https://your-dify-instance.com/api/v1/upload" API_KEY = "your_api_key_here" FILE_PATH = "/path/to/your/document.docx" # 调用函数 result = upload_docx_to_dify(API_URL, API_KEY, FILE_PATH) if result["status"] == "success": print("文件上传成功:", result["data"]) else: print("文件上传失败:", result["message"]) ``` 上述脚本中包含了几个重要部分： - **headers 字典** 中设置了 Bearer Token 认证方式来保护 API 接口的安全性； - 利用了 `with...as` 结构打开本地文件，并将其封装成适合传输的形式； - 对于可能存在的异常情况也进行了初步判断与反馈机制设计。 #### 注意事项 - 替换占位符 `"https://your-dify-instance.com/api/v1/upload"` 和 `"your_api_key_here"` 为真实的服务地址及个人专属 token。 - 如果遇到权限不足等问题，请检查当前账户是否有足够的权利执行该类任务或者重新申请新的有效凭证。