部署Dify

应用场景

Dify是一款开源的大语言模型LLM（Large Language Model）应用开发平台，您可以通过Dify将企业或个人的知识库集成到大模型应用中，创建定制化的AI问答解决方案，同时也可将其集成到您的业务环境中，提升用户体验。本文主要介绍使用Dify应用镜像快速搭建基于大语言模型的知识库问答系统。

步骤一：部署Dify应用镜像的L实例

您可以新购买Dify应用镜像的L实例，也可以使用已有L实例部署Dify应用镜像。

进入Flexus应用服务器L实例购买页。

对Flexus应用服务器L实例进行资源配置。

参数	示例	说明
区域	北京-北京四	请就近选择靠近您业务的区域，可减少网络时延，提高访问速度。Flexus应用服务器L实例创建后无法更换区域，请谨慎选择。
应用镜像	Dify	基于Dify开源社区版的Agent开发平台。
Dify平台登录密码	-	设置Dify平台的登录密码。 Dify平台登录的默认账号为“super@dify.com”，该邮箱非实际的邮箱地址，不能进行邮件收发。
实例规格	4核8G、系统盘180GiB	Dify应用镜像的运行配置建议选择4核8GiB及以上，您可根据您的业务需求选择Flexus应用服务器L实例规格。
实例名称	Dify-Example	请自定义方便您识别的实例名称，例如Dify-Example。
您可能需要（可选）	数据盘：10GiB 主机安全云备份：50GB	请根据您的业务需要自主选择数据盘、主机安全、云备份附加服务并设置规格。
购买时长	1个月	单次购买最短为1个月，最长为3年。 Flexus应用服务器L实例支持自动续费功能。勾选后，在Flexus应用服务器L实例到期前自动续费。如果您购买时未开通自动续费，后续仍可以在控制台开通。自动续费的更多信息详见自动续费。
购买数量	1台	设置您购买的Flexus应用服务器L实例数量。

单击“下一步：确认配置”，进入订单详情页面。
根据界面提示，请确认配置信息，阅读并勾选协议。
单击“去支付”，根据页面提示完成支付。
单击“返回华为云Flexus云服务控制台”，查看已创建的Flexus应用服务器L实例。

登录Flexus应用服务器L实例控制台，查看目标L实例是否为Dify应用镜像。
- 如是，请执行步骤二：配置Dify应用；
- 如不是，请执行步骤2。
单击L实例资源卡片上的图标，单击“切换镜像”。按照界面提示切换为Dify应用镜像，待切换成功且L实例为运行中时，进行下一步。

切换镜像会清除原系统盘数据，包括系统盘上的系统分区和所有其它分区，请做好数据备份。

步骤二：配置Dify应用

登录Flexus应用服务器L实例控制台。
单击资源卡片上的“立即使用”，进入应用详情页面。

Dify应用镜像的部分功能（如设置密码及应用模板等）依赖云运维中心（Cloud Operations Center，简称COC），需要先授权并开通COC服务。如果出现下图提示，请按界面提示授权并开通。
在应用管理卡片中可以查看到Dify应用版本以及相关操作。
访问Dify Web界面
1. 如果您需要使用Dify Web界面进行管理，请单击“开启”。确认安全风险后单击“确定”。
  - 如果L实例的安全组中已放开80端口，系统将为您自动开启Dify Web界面。
  - 如果L实例的安全组中未放开80端口，开启后系统将自动放通80端口。
  系统自动放通80端口时，在安全组入方向规则中该端口的源地址为0.0.0.0/0，表示允许所有外部IP地址访问您的实例，可能导致网络入侵，造成业务中断、数据泄露或数据勒索等严重后果。强烈建议您将安全组规则设置为仅允许已知的IP地址访问。
  
  您可以单击页面右上角的，单击“配置安全组规则”，在入方向规则中找到目标端口，修改端口对应的源地址为已知的IP地址。
2. 单击“访问Dify Web界面”，弹窗中显示如下信息，请妥善保管相关信息，以防隐私泄露或资产损失。
  Web界面链接：访问Dify Web界面的链接地址。
  
  端口：80。
  
  邮箱：Dify平台登录的默认账号为“super@dify.com”，该邮箱非实际的邮箱地址，不能进行邮件收发。
3. 单击“立即访问”或者Web界面的链接，即可打开Dify Web界面。输入邮箱（super@dify.com）和Dify平台密码，即可登录到Dify平台。
  该页面由Dify提供，更多详细信息请参见Dify官方文档。
4. 建议您在操作完成后，单击“关闭”，关闭后Dify Web界面将不可访问，已放通端口的安全组规则会自动删除，可以降低信息泄露等安全风险。
重置Dify密码
- 如果您忘记了购买L实例时设置的Dify平台密码，或者需要修改Dify平台密码时，请单击“重置Dify密码”。
  根据界面提示输入新密码并再次输入确认与新密码一致。单击“确定”后完成修改。
- Dify平台登录的默认账号为“super@dify.com”，该邮箱非实际的邮箱地址，不能进行邮件收发。
在智能体应用模板中可以查看和搜索智能体。按需选择适合的智能体后，单击“应用”，在弹窗中输入Dify平台的密码进行校验，密码验证成功后系统会将应用模板导入到Dify平台中。
单击“访问Dify Web界面 > 立即访问”。如未开启请参考步骤3.a操作。
输入邮箱（super@dify.com）和Dify平台密码，登录Dify平台后即可查看到已导入的应用模板。
此处以“智能营销助手”和“产品销售助手（汽车）”智能体应用模板为例，介绍模板应用后的配置操作，您可以按需参考。
智能营销助手
1. 单击“智能营销助手”，进入应用工作流。
2. 单击工作流中的”文档编辑LLM“卡片，选择华为云MaaS平台预先添加的内置大语言模型。如果您还未配置华为云MaaS平台的凭证，请参考“接入华为云MaaS模型”操作。
3. 请按照实际需求修改问答提示词。
4. 单击工作流中右上角的“预览”。在对话输入框输入您的需求，查看是否正常答复。
5. 验证无误后，可以单击工作流右上角的“发布 > 发布更新”，发布应用后您可以分享该应用，更多详情请参考Dify官方文档。
产品销售助手（汽车）
1. 单击“产品销售助手（汽车）”，进入应用工作流。
2. 单击工作流中的“知识检索”卡片，单击添加知识库按钮“+”，选择已上传的知识库，单击“添加”按钮，完成添加。如果您未创建知识库请参考创建知识库操作。
3. 单击知识库右侧的“召回设置”，在RERANK设置中选择“Rerank模型”，Rerank 模型选择“bge-reranker-v2-m3”，Top K设置为3，打开score阈值并设置为0.8。
4. 单击工作流中的“【待配置】联网搜索”卡片。设置联网搜索后，当内部知识库无相关信息时，可以基于网络搜索结果回答用户问题，获取查询结果提供给下游结点进行总结分析。
5. 设置联网搜索的请求路径，为了方便管理工作流中的参数，可通过环境变量使用联网搜索参数。
  单击“ENV”，应用模板中已内置两个环境变量，请修改为已开通的联网增强MCP的实际信息。如果您还未开通请参考开通华为云联网增强MCP操作并获取参数信息。
  - SEARCH_API_KEY：已开通的联网增强MCP的API Key。
  - SEARCH_API_URL：已开通的联网增强MCP的API地址。
6. 分别单击工作流中的“【待配置】问题改写”、”【待配置】大模型服务+外部知识库RAG“、”【待配置】大模型服务+内部知识RAG“卡片，按需选择华为云MaaS平台预先添加的内置大语言模型。如果您还未配置华为云MaaS平台的凭证，请参考“接入华为云MaaS模型”操作。
7. 请按照实际业务需求修改“【待配置】问题改写”、”【待配置】大模型服务+外部知识库RAG“和”【待配置】大模型服务+内部知识RAG“卡片中的问答提示词。
8. 单击工作流中右上角的“预览”。在对话输入框输入您的需求，查看是否正常答复。
9. 验证无误后，可以单击工作流右上角的“发布 > 发布更新”，发布应用后您可以分享该应用，更多详情请参考Dify官方文档。

（可选）步骤三：Dify平台配置

本步骤介绍在Dify平台的常用配置，更多Dify的使用指导请参见Dify官方文档。

如需支持语义查询搜索，需要向量数据库则需创建，参考如何配置Embedding与Reranker（开源模型,如精度要求高，可提工单申请开通华为自研模型），完成配置在Dify平台应用的配置。

创建知识库

登录Dify平台首页，单击顶部“知识库”页签，单击“创建知识库”。
选择数据源步骤中，选择“导入已有文本”，单击“选择文件”，选择本地已整理好的知识文件，上传完毕后，单击“下一步”。
文本分段与清洗步骤中，您可以根据页面引导按需配置参数。
本示例分段设置选择“父子分段”（推荐使用），其余参数保持默认。
索引方式选择“高质量”，Embedding 模型选择“bge-m3”。
检索设置选择推荐的“混合检索”，单击“权重配置”，将语义和关键词比例设置为0.5比0.5。
如果对检索内容匹配度有要求，可以开启“Score 阈值”并设置阈值。
单击“Rerank模型”，选择“bge-reranker-v2-m3”模型，配置完成后单击“保存并处理”。
单击“前往文档”。
当文档状态变成“可用”，表示文档已上传完成。可以在工作流中配置该知识库，例如产品销售助手（汽车）示例。

登录华为云控制台，在MCP广场搜索“联网增强MCP”，单击卡片进入详情页。
单击“立即开通 > 确认开通”，服务开通后根据页面指引，进入ModelArts Versatile控制台。
在AI工具页签下，可以看到已开通的联网增强MCP，单击操作列的“API调用”即可查看API地址和调用示例。
在API Key列表页签下，单击“创建API Key”。
返回Dify平台，在工作流中可以配置联网搜索的参数，即API地址和API Key，例如产品销售助手（汽车）示例。

在Dify平台首页，单击右上角“插件”，查看是否已安装华为云MaaS平台插件。
- 如果已安装则进行下一步。
- 如果未安装，在“探索 Marketplace”页签下，搜索“华为云MaaS平台”并安装该插件。
单击右上角用户信息下的“设置”。
单击“模型供应商”，在待配置的华为云MaaS平台中单击“设置”。
在API密钥授权配置中填写凭据信息后，单击“保存”。
- 凭据名称：用户自定义设置。
- API Key：填写华为云MaaS平台的API Key，您可以使用已有API Key或者根据界面引导前往华为云MaaS控制台创建新的API Key。
配置完成后，您可以为工作流中的节点配置需要的模型。例如“智能营销助手”和“产品销售助手（汽车）”智能体...。

常见问题

问题现象	问题原因	解决方法
应用智能体模板时验密失败，提示"登录失败"。	邮箱或密码填写不正确。	检查邮箱和密码是否正确。若忘记密码，可重置Dify密码。
Dify平台页面无法打开。	未开启访问Dify Web界面，或者安全组未放通Dify服务端口80。	开启访问Dify Web界面，并确认安全组规则中已放通80端口，请参见访问Dify Web界面。