本文档由 AI 自动翻译。如有任何不准确之处,请参考 英文原版。导出应用可留存一份副本、交给他人,或迁移到另一个 Dify 实例或工作空间。导出后会得到一个 应用包,也就是
.ifpkg 文件。
导入应用包可创建新应用,也可更新已有应用,例如换上已测试完毕、准备上线的版本。
若只是在同一工作空间内复制应用,在应用菜单中选择 复制 即可。
- 导出和导入应用需要「编辑」及以上角色。
- 应用包里如果带有应用作为工具调用的工作流,导入需要「所有者」或「管理员」角色。应用包导出自当前工作空间且原有的工具仍在时除外。
导出应用
在应用或 Agent 的卡片菜单里,或者打开后左上角的菜单里,点击 导出应用 或 导出 Agent。 对于 Workflow、Chatflow 和新 Agent,导出的是当前草稿,包括尚未发布的改动。若要导出某个已发布版本,打开 版本历史,在该版本的菜单中选择 导出应用 或 导出 Agent。 其他类型的应用导出的是最近一次发布的配置。导出不包含的内容
除以下内容外,构成应用的一切都会随之导出:- 用到的集成(导入时可一键安装全部缺少的集成)
- 关联的知识库
- Swagger API 和 MCP 工具,以及新 Agent 或新 Agent 节点使用的工作流工具
- Agent 文件系统 中的长期文件,比如它在构建模式下安装的程序
- 服务 API 密钥
- 模型和工具凭据
- 日志和标注
- 历史版本
- 集成触发器的订阅
选择是否导出 Secret 值
导出含有 Secret 类型环境变量的 Workflow 或 Chatflow 时,可选择是否包含这些变量的值。从版本历史导出时,始终不包含 Secret 值。
通过导入创建新应用
在 工作室 或 Agents 中,点击 创建 > 导入应用。 这种方式总会创建一个新应用,它有自己的 Web 应用 URL,已有的应用不受影响。若想导入到已有的 Workflow 或 Chatflow 中,并保留其 Web 应用 URL 和 API 密钥,改为 更新该应用。 导入后,对照导出时 未包含的内容,把新应用需要的部分补上。通过导入更新已有应用
在 Workflow 或 Chatflow 中,从应用左上角的菜单或画布的右键菜单中点击 导入应用。应用包必须导出自 Workflow 或 Chatflow,且其中的节点都能在当前应用中使用:Workflow 不能包含直接回复节点,Chatflow 不能包含输出节点或触发器节点。 导入会替换你的草稿,应用的名称、描述和图标也会一并替换。应用本身不变,日志、标注、API 密钥,以及 Web 应用和 MCP 服务的 URL 都保持原样。在你发布更新后的草稿之前,用户使用的仍是已发布的版本。 如果应用包不含 Secret 值,发布前需重新填写。导入到早期 Dify 版本
从 Dify 1.19.0 及以上版本导出的 Workflow 应用、Chatflow 应用、聊天助手、旧版 Agent 和文本生成应用,只能导入 1.19.0 及以上版本。从 1.18.x 导出的应用包可导入 1.18.0 及以上版本。 若要将应用导入更早的 Dify 版本,先解压应用包(ZIP 格式),再单独导入其中的app.yaml DSL 文件。
部分配置不会随之迁移,例如 Web 应用设置和上传的图标,导入后需检查并重新设置。
应用包里的工作流工具也不会随之迁移:运行应用前,先在目标工作空间中配置好应用作为工具调用的工作流。
使用了 新 Agent 节点 的工作流只能导入 Dify 1.18.0 及以上版本。