AI应用平台Dify升级v1.0.0版本教程

推荐语

掌握AI应用平台Dify的最新升级，探索其强大的插件系统和功能扩展。

核心内容：
1. Dify v1.0.0版本的升级亮点与核心组件
2. 新增模型插件、工具插件和Agent策略插件的功能介绍
3. 插件集的部署效率提升及插件市场的应用生态

杨芳贤

53A创始人/腾讯云(TVP)最具价值专家

目录

（1）前言

（2）Dify v1.0.0升级步骤

（3）新功能介绍

01

前言

• 插件系统核心组件相关功能
• 模型插件
  重新定义了 Dify 中的 AI 模型管理方式。模型以插件形式运行，可在任何 Dify 应用中无缝配置和使用，从聊天助手到 workflow 都能灵活适配，方便用户根据不同需求快速调用和切换模型。
• 工具插件
  支持在 AI 应用调用特定功能的工具，能为 Agent 和 workflow 提供丰富的领域内专业能力和自定义功能，如实现从数据分析到内容翻译等各种操作，大大扩展了 AI 应用的功能边界。
• Agent 策略插件
  为 Dify chatflow 和 workflow 的新 Agent 节点提供推理策略，实现节点内的自主工具调用和执行以完成多步骤推理过程。用户还可通过创建自定义推理策略，如思维链、思维树、函数调用和 ReAct 等，提升 Chatflow 和 Workflow 的问题解决能力。
• 扩展插件
  通过 HTTP webhook 实现外部集成，让 AI 应用能够与更多外部系统进行交互和数据传输，进一步增强了应用的扩展性和与其他平台的兼容性。
• 插件集
  可将多个插件组合为一个集合，简化部署过程，减少了用户在部署多个插件时的繁琐操作，提高了部署效率。同时，应用可以通过插件的 Endpoints 反向调用 Dify 的核心能力，包括 Dify 内的模型、应用、工具、知识库以及工作流节点，实现了插件与平台核心功能的深度交互。
• 其他功能
• 插件标准与市场
  提供了插件标准（.difypkg）和插件市场，方便用户共享和下载插件，促进了插件的流通和使用，用户可以在插件市场中找到各种满足不同需求的插件，丰富 AI 应用的功能。
• 解耦架构设计
  插件系统基于解耦架构，每个插件都能作为独立模块运行，实现了插件的独立开发、部署和维护，同时确保版本控制和安全性，保障了系统的标准化和稳定性，降低了插件开发和维护的难度，也提高了系统的可靠性和可维护性。
• 持久化存储能力
  在插件和工作空间层面提供了持久化存储能力，让数据管理更加安全持久，确保插件和工作空间中的数据能够得到有效保存和管理，方便用户在不同场景下使用和调用数据。

02

升级步骤

如果觉得新版本对自己非常有帮助，那么就开始进行升级部署吧

如果您有旧版本的源码，比如v0.15.3的源码包，首先进入docker目录，将volumes文件夹和docker-compose.yaml文件备份一下，因为接下来升级过程中如果出现问题，需要及时的回溯，备份防止数据丢失。

进入Github中Dify的1.0.0分支源码进行下载最新的docker-compose.yaml文件，以下为地址：

https://github.com/langgenius/dify/blob/1.0.0/docker/docker-compose.yaml

点击下载按钮，docker-compose.yaml文件就下载到本地了

如果您的旧版本docker-compose.yaml没有额外修改过其他东西的话，就可以把最新的docker-compose文件进行替换覆盖掉了，替换完毕后，就在docker目录下，输入以下命令进行拉取最新镜像

docker compose -f docker-compose.yaml up -d

等待完成，完成之后，dify就会启动

进入dify平台，默认路径为http://localhost

我们会发现知识库的所有文档都不能使用了，别急，因为我们还没有把模型数据和知识库数据从旧数据库迁移。

（1）Plugin Migration  插件迁移

如果您是linux环境，就使用以下命令进入容器内部

docker exec -it dify-api-1 bash

如果您是Windows，并且有Docker Desktop，那么进行如下操作，进入docker-worker-1，点击Exec栏，在下面命令框中输入bash进行根目录

输入以下命令，将旧版本使用的工具和模型安装到新的插件环境中

poetry run flask extract-plugins --workers=20

此命令将提取当前环境中使用的所有模型和工具。workers 参数确定提取期间并行进程的数量;根据您的需要进行调整。

最终结果将保存在 plugins.jsonl 文件中，其中包含当前 Dify 实例中所有工作区的插件信息。

确保您的网络正常运行并且可以访问https://marketplace.dify.ai，然后运行以下命令：

poetry run flask install-plugins --workers=2

此命令将下载所有必要的插件并将其安装到最新环境中。

（2） 数据库迁移

完成基本的插件安装过程后，请按照标准的 Dify 升级过程将数据库 Schema 更新到最新版本。

poetry run flask db upgrade

Dify v1.0 包括对旧数据的兼容性。您应该能够正常运行，但为了获得更好的未来兼容性，请在确定不会恢复到旧版本后运行以下数据迁移命令：

poetry run flask migrate-data-for-plugin

此命令将为数据库中的现有模型和工具供应商添加 langgenius 前缀，例如将 openai 转换为 langgenius/openai/openai。此作可能会影响旧版 Dify 的功能，因此请在运行此命令之前备份您的数据库，以防止出现不必要的问题。

以上所有操作执行完毕后，重启Dify，重新进入平台

我们发现模型供应商空了，这是正常的，升级新版本后，所有的供应商需要以插件的形式重新安装，安装完毕后，旧版本的历史模型数据会自动带入。

新功能介绍

（1）插件市场

在右上角，发现多了一个插件按钮