type
status
date
slug
summary
tags
category
icon
password
近期，MinerU 与 Dify联合研发的 MinerU 插件在 Dify 市场上架了!大量社区的小伙伴们在社群里群里询问，应该如何使用 Dify 中 MinerU插件来搭建工作流。今天，使用教程，它来啦！
我们先来看一下大家使用 Dify 和 MinerU 插件的场景，大致可分为如下环境：
针对不同的使用场景，一些配置会有些许不同，一定要注意我们的提示哦（都是社区小伙伴们部署时的血泪教训）
一、 场景一：在 Dify MinerU插件中配置 MinerU 官方在线API 服务
1.登录你的 Dify 平台。
2.进入 【工具】 -> 【插件市场】，搜索MinerU插件并添加。
3.配置MinerU插件参数：
- 首先访问 MinerU 官方网站申请官方在线 API，审核通过后方可使用：
4.保存配置。如图所示：
二、 场景二：在 Dify MinerU插件中配置 MinerU 本地服务
提示：此场景前提是您已在本地部署了 MinerU，并参照 MinerU GitHub Repo 中 projects 文件夹中的 web_api 项目，构建部署了 MinerU 本地 API 服务，然后在 Dify 中进行授权配置。
MinerU web_api 传送门：
https://github.com/opendatalab/MinerU/tree/master/projects/web_api
1.登录你的 Dify 平台。
2.进入【工具】 -> 【插件市场】，搜索MinerU插件并添加。
3.获取本机 IP 地址
为了让 Dify 正确访问 MinerU API，需要使用局域网 IP 地址（不能使用 127.0.0.1 或 localhost）。请根据你的系统获取本机 IP：
- Windows：打开命令提示符cmd，输入下方命令，查找 "IPv4 地址":
- macOS：打开终端（Terminal），执行
Linux：打开终端，执行
记录下你的 IP 地址，例如：192.168.1.100。
<ins/>4.配置MinerU插件参数：
5.保存配置，就可以在 Dify 应用中成功使用 MinerU 工具来处理 PDF等文件啦！
提示
若需要使用本地部署的 MinerU 进行文件解析，需要确保已在本地部署MinerU的同时，部署了GitHub MinerU Repo中projects文件夹中的 web_api 项目。
三、使用 Dify 中 MinerU 插件的常见问题
本地部署的 Dify，在执行过程中遇到如下错误怎么办？
1.为了解决上述问题，接下来你需要设置 Dify 的配置文件：
找到 Dify 部署目录，编辑 .env 文件。
修改 FILES_URL 配置项，依据你的部署方式选择：
- Docker Compose 部署：FILES_URL 设置为 http://api:5001。
- 其他部署方式：FILES_URL 设置为 http://Dify宿主机IP:5001（如 http://192.168.1.101:5001，这里的 IP 通常是运行 Dify 的机器的 IP，即前文提到的“本地IP”端口。5001 是 Dify API 服务的默认端口）。
2.确认 Dify API 服务的 5001 端口已对外暴露（可检查 docker-compose.yaml 文件的端口映射）。
3.保存 .env 文件。
4.重启 Dify 服务使配置生效。
提示:
如果你使用本机 IP 设置 FILES_URL ，那么当你的网络环境发生变化 (例如连接了不同的 WiFi)，你的本机 IP 地址可能会改变。届时需要：
- 重新获取本机 IP 地址。
- 更新 Dify 中 MinerU 插件的 Base URL 配置。
- 如有必要 (如果 Dify 的 FILES_URL 配置的是 IP 地址而不是 api)，更新 Dify 的 .env 文件并重启 Dify 服务。
- 在使用 Dify 的 MinerU 插件时，尤其是在处理文件上传时，如果不配置此步骤，可能会遇到类似 Request URL is missing an 'http://' or 'https://' protocol 的错误。这是常是因为 Dify 的 api 服务无法正确访问其自身的文件服务。
四、实践案例：用 MinerU 插件在 Dify 中搭建工作流
接下来，我们将带你在 Dify 中通过 MinerU 插件快速搭建一个文件问答工作流，帮助你更高效地使用 MinerU 进行文档解析和问答。
1.环境准备
首先，请根据前文提示完成以下配置：
- 安装并启用 MinerU 插件；
- 在 Dify 设置中，配置好模型供应商及对应的 Token（API 密钥）。
2.创建空白工作流应用
- 进入 Dify，点击【工作室】按钮，选择“创建空白应用”；
- 类型选择【工作流】；
- 设置应用名称与图标，可选填应用描述。
3.在【开始】节点中添加两个输入字段：
- uploadfile：用于上传文件；
- question：用户提问文本。
4.添加 MinerU 插件节点：
- 点击【开始】节点下方的【添加】按钮；
- 选择【工具】类型，添加【MinerU 插件】节点；
- 在插件输入变量中，绑定【开始】节点的 uploadfile 字段作为输入。
5.添加 LLM 节点，进行问答处理：
- 在【MinerU 插件】节点下方点击【添加】，选择【LLM】节点；
- 设置 LLM 节点的提示词（Prompts）如下：
- 上下文字段（Context）：引用【MinerU 插件】节点输出的 Parse File 字段；
- System 字段提示词：可填写说明，如：Parse File 是用户上传文件解析出的内容，用户提到的“文件”“文档”等即指该内容。
- User 字段提示词：引用【开始】节点中的 question 字段作为用户问题输入。
6.设置【结束】节点输出：
在【结束】节点中，选择【LLM】节点的输出字段 text 作为最终输出变量。
运行并测试工作流：
点击页面右上角【运行】按钮，测试上传文件与提问功能；
测试通过后，点击【发布】下拉菜单中的【运行】按钮，即可在浏览器中打开最终应用页面。
通过以上教程，相信你已经掌握了 MinerU 插件的基本使用方法。如果在操作过程中还有疑问，欢迎在公众号后台回复关键词 “MinerU插件”，即可获取我们为你准备的完整配置文件（YAML）。后续，MinerU 插件也会在 接入 Dify 的知识库，相关功能，研发小哥正在努力开发中。
当然，我们更期待你发挥创意，基于 Dify中的 MinerU 插件打造更多高效实用的工作流！
如果你在使用 MinerU 插件过程中探索出了更优的工作流方案，欢迎投稿分享给我们！一经采用，我们将赠送 OpenDataLab 精美周边礼品 作为感谢。
需要在公众号后台设置输入“MinerU插件”即可获得工作流 yaml 文件下载链接。