阿里巴巴中间件 8小时前
Dify 开发者必看:如何破解 MCP 集成与 Prompt 迭代难题?
index_new5.html
../../../zaker_core/zaker_tpl_static/wap/tpl_guoji1.html

 

本文探讨了Nacos与Dify的集成,为生成式AI应用的开发提供了新的解决方案。Dify作为一款流行的LLM应用开发平台,在AI领域影响力日益增长,但其在MCP集成和Prompt敏捷性方面存在挑战。Nacos 3.0通过支持MCP动态管理、Prompt运行时动态变更以及Dify部署环境变量托管,有效解决了这些痛点。通过Nacos MCP插件,Dify能够轻松发现和调用MCP服务,降低接入和管理成本,并实现Prompt的快速迭代和运维优化,最终提升AI应用的开发效率和架构灵活性。

🚀 Nacos 3.0 赋能 Dify 应对 AI 应用开发挑战:Nacos 3.0 升级定位为 AI Agent 应用的动态服务发现、配置管理和智能体管理平台,为 Dify 在 MCP 集成困难、Prompt 不够敏捷以及启动配置复杂运维困难等问题提供了解决方案。它支持 MCP Server 的自动注册和动态发现,以及 Prompt 的运行时动态变更,并能托管 Dify 的部署环境变量,显著提升了 AI 应用的开发效率和架构灵活性。

🔧 Dify 轻松集成 Nacos MCP 服务,降低接入与管理成本:通过 Nacos MCP 插件,Dify 应用能够实时感知 Nacos 中配置的所有 MCP Server,实现 0 代码改动将存量微服务 API 转化为 MCP 服务,并支持 MCP 服务的多实例注册和动态变更工具描述。这极大地简化了 Dify 应用中 MCP Server 的接入和管理流程,并能根据任务需求智能路由,有效降低模型调用的 Token 消耗。

💡 Nacos 托管 Dify Prompt,实现敏捷迭代与快速优化:Nacos 的动态配置管理能力完美契合 Prompt 的快速调整和优化需求。将 Prompt 托管至 Nacos,开发者无需重新编辑和部署 Dify 工作流,仅需在 Nacos 中变更配置即可实现 Prompt 的动态调优,支持版本回滚和自动优化,极大地加速了 AI 应用的迭代速度和效果优化。

⚙️ Nacos 集中管理 Dify 环境变量,提升运维效率:Dify 应用的复杂架构和繁多的配置项给运维带来挑战。通过将 .env 文件中的参数转移至 Nacos 进行管理,Dify 可以在启动时从 Nacos 读取配置,实现启动参数的白屏化变更和历史版本管理,从而简化 Dify 应用的运维复杂度,提高部署配置的可维护性和复用性。

朱桐(濯光) 2025-07-10 20:04 浙江

Nacos与Dify的结合,为生成式AI应用的开发效率与架构灵活性提供了新的解决方案。

Dify 是一个面向 AI 时代的开源大语言模型(LLM)应用开发平台,致力于让复杂的人工智能应用构建变得简单高效,目前已在全球范围内形成显著影响力,其 GitHub 仓库 Star 数截至 2025 年 6 月已突破 100,000+,目前,Dify 已经成为 LLMOps 领域增长最快的开源项目之一。

然而,AI 领域正处于蓬勃发展,快速变化的阶段,每天都有新技术,新的应用场景在出现,Dify 也有其力所不逮的地方:

Nacos 是阿里巴巴开源的一款注册配置中心产品,被广泛应用于各种云原生应用的构建中。面对 AI 浪潮带来的技术革命,全新的 Nacos 3.0 版本将定位进行了升级,致力于打造一个易于构建 AI Agent 应用的动态服务发现、配置管理和 AI 智能体管理平台,为模型 / MCP Server / Agent 等新型业务智能场景架构提供更高效的运行支撑。

对于 Dify 面临的这些问题,我们可以在 Nacos 中找到对应的答案:

灵活集成,Dify 轻松发现 MCP 服务

Aliware

目前,Dify 应用通过社区插件对接 MCP 服务主要存在以下两个痛点:

而在 3.0 版本中,Nacos 在 MCP 生态中迈进了一大步,支持了 MCP Registry 能力,多种类型、不同版本的 MCP Server 可以轻松注册至 Nacos 中,消费端只需要连接 Nacos,就可以获取所有可用的 MCP Server 和访问方式,免去了手动配置的痛苦。而除了动态发现 MCP Server 之外,Nacos 3.0 MCP Registry 还支持以下 MCP 相关企业级特性:

目前,Nacos 官方 MCP 插件 Nacos MCP【1】 已经登录 Dify 官方市场。Dify 应用通过接入 Nacos MCP 插件,即可实时感知 Nacos 中配置的所有 MCP Server,享受以上 MCP 企业级特性,大大降低了 Dify 应用中 MCP Server 的接入和管理成本。同时,Nacos MCP 插件还能帮助模型按需挑选并路由 MCP 服务,有效降低模型调用的 Token 消耗。


接下来,就让我们通过一个简单的实践教程,来实际体验下吧。


实践: Dify 应用轻松路由 Nacos MCP 服务

假设我们正在开发一个 AI 导购,在功能刚上线的时候,我们希望 AI 导购能够调用 goods-mcp-server 的工具来根据用户提供的关键字返回相关的商品列表,后面根据用户的反馈再接入新的 MCP Server 进行能力的增强。

通过接入 Nacos MCP 插件,Dify 应用即可以动态感知新增的 MCP 服务,实现能力的快速迭代。同时,在实际的调用过程中,Nacos MCP 会首先返回所有 MCP 的简要信息供模型进行挑选,模型根据实际任务需要再查询对应 MCP 的 Tools 供模型进行调用,通过这种方式,能够降低模型 Token 消耗,特别是在 MCP 服务数量和工具数量过多的场景下,优势明显。

1. 注册 MCP 服务 至 Nacos

首先,我们要将所需的 MCP Server 信息注册到 Nacos 中,目前 Nacos MCP Registry 支持多种注册方式:

注册完成后,我们可以在 Nacos 控制台上看到对应的 MCP Server 信息:


2. Dify 应用 Nacos MCP 插件配置

完成 MCP Server 在 Nacos 上的注册之后,为了让 Dify 应用能够访问到 Nacos 中注册的 MCP Server,我们需要安装并配置 Nacos MCP 插件。目前,Nacos 官方 MCP 插件 Nacos MCP【4】 已经登录 Dify 官方市场。在 Dify 官方插件市场中搜索 Nacos MCP 插件【5】,安装后配置 Nacos Server 的访问地址和访问凭证:



现在,让我们在 Dify 中构建一个简单的 AI 导购助手。在 Dify 中创建一个 Agent 应用并配置 Nacos MCP 以下的工具:

模型会根据实际的任务,首先查询可用的 MCP Server 列表,并根据自己的需要,智能挑选依次调用 Nacos MCP 的三个工具来完成任务的执行。


点击部署,让我们在对话中体验下:


查看调用历史,大模型通过调用 Nacos MCP 插件的三个工具,顺利完成了对于 goods-mcp-server 的调用。

3. 实时发现并路由 MCP 服务

而完成配置之后,在随后的运行时中,Dify 可以实时的感知 Nacos 中注册的 MCP Server 服务,而无需对 Dify 应用进行重新编辑和部署,并根据任务实现对于 MCP 的路由。

以 AI 导购为例,在上线之后,我们觉得单纯推荐物品的逻辑有些单薄,我们希望他除了推荐物品之外,还可以进一步的给出每类物品在各个平台上的最低价格以及对应的商品链接,相关的价格查询逻辑已经由 price-mcp-server 进行了实现。在不依赖 Nacos 的情况下,添加一个全新的 MCP Server 我们需要重新对 Dify 应用进行部署,而现在,我们只需要在 Nacos 中注册对应的 price-mcp-server 即可。

通过自动注册或者手动配置的方式在 Nacos 注册 price-mcp-serverMCP 服务:


现在,再让我们调用 AI 导购:


可以发现,在给出推荐的商品列表之外,AI 导购进一步的利用了 price-mcp-server 来进行了价格的查询和比较,而无需重新部署。

此外,查看模型的工作链路,我们看到模型首先查询了所有可用的 MCP 服务列表,根据任务判断需要调用 goods-mcp-server 以及 price-mcp-server再去查找了具体的 Tools 信息。


如果我们只希望获取物品的列表,则模型只会查询 goods-mcp-server 的工具列表。


当 MCP 数量和 Tools 数量较多时,可以显著减少模型 Token 消耗。

而在实践中,为了实现更好的路由效果,MCP 本身以及工具的描述是否精准也是重要因素。通过 Nacos MCP 插件接入的 MCP 服务,支持在 MCP 运行时对 MCP 的工具描述和工具开关进行动态调整,根据实际需要向 Dify 应用暴露可用工具进行调优。


快速迭代,

Nacos 托管 Dify Prompts

Aliware

Prompt 是生成式 AI 的核心,生产中往往需要根据应用场景不断的进行调整和优化,Dify 已经大大降低了应用开发的成本,但是 Prompt 变化依然要重新发布。而 Nacos 解决的一大痛点就是就是配置“动态”,其提供的动态配置管理能力,天然契合 Prompt 快速调整优化的场景。通过将 Prompt 托管至 Nacos,无需重新编辑部署 Dify 工作流,只需要在 Nacos 中进行简单的配置内容变更,即可实现 Prompt 的动态调优。

依然是以 AI 导购为例,让我们看看如何实现 Prompt 的快速进化吧。


实践:AI 导购 Prompt 迭代

1. Prompts 托管至 Nacos

首先,我们要将 Prompt 迁移到 Nacos 上。在 Nacos 控制台上创建一个配置文件,DataId 为 Prompt.template,Group 为默认的 DEFAULT_GROUP,内容为 AI 导购 Prompt 模版对应的内容:

你是一个AI导购助手,请查看所有可用的工具,调用工具根据用户的需求给出相关的商品推荐列表,并查询在各个平台上对应的价格,给出性价比最高的选择


2. Nacos 插件安装和配置

为了从 Nacos 中读取 Prompt 动态配置,我们需要在 Dify 中安装 Nacos 插件,并配置插件的连接信息:


然后,让我们创建对应的工作流应用,在工作流中创建对应的读取 Nacos 工具节点,配置 Prompt 配置的命名空间、配置 ID 和分组的信息。


创建 Agent 节点,配置 Nacos MCP 工具列表,在指令一栏配置读取 Nacos 工具节点的输出作为输入,查询一栏配置 sys.query 作为输入。


3. 动态变更 Prompt 实现快速迭代

通过以上两步,我们实现了 Nacos 对于 Dify 应用 Prompt 的托管,接下来即可实现在 Dify 应用运行时动态调整和迭代 Prompt。

首先,我们调用 AI 导购,希望他给我们一些露营的装备建议:


可以发现,Agent 根据 Prompt 的内容给我们返回了预期之内的结果。

但是,在应用实际上线之后,我们发现这些结果都是以文字格式展示的,客户反馈这种方式不够直观,希望调整为表格的形式展示。因此我们要对 Prompt 进行修改。没有 Nacos 时,我们需要修改 Dify 工作流并进行重新部署,而将 Prompt 托管到 Nacos 上之后,我们只需要在 Nacos 控制台上修改对应的 Prompt 内容为:

你是一个AI导购助手,首先查看所有可用的工具,调用工具根据用户的需求给出相关的商品推荐列表,并查询在各个平台上对应的价格,给出性价比最高的选择,以表格的形式进行展示。

再次询问 AI 导购,发现结果根据我们 Prompt 的要求做了相应的调整,Prompt 变更成功生效了。

Nacos 还支持变更历史,在历史版本界面,可以查看所有使用过的历史 Prompt 版本,并进行回滚,这样即使 Prompt 效果不够满意,也可以一键复原:


此外,Nacos 插件中还包含了配置修改的工具,用户也可以在专门的 Dify 应用中结合大模型的能力实现 Prompt 的自动优化。

高效运维,

Nacos 托管 Dify .ENV 启动配置

Aliware

Dify 平台拥有强大的功能,但也提升了其应用架构的复杂度,各个组件所用到的配置项数量繁多,难以管理。而目前,Dify 支持了将启动参数托管至 Nacos 中,通过读取 Nacos 中的配置获取启动参数。

1. 采取源代码方式启动 Dify 服务【6】

2. 将 .env 中的参数转移至 Nacos 配置中。



3. 在启动 API 服务时将以下环境变量进行注入。

REMOTE_SETTINGS_SOURCE_NAME=nacos
DIFY_ENV_NACOS_SERVER_ADDR=<nacos_addr>
DIFY_ENV_NACOS_DATA_ID=<启动参数配置文件的data_id>
DIFY_ENV_NACOS_GROUP=<启动参数配置文件的分组>
DIFY_ENV_NACOS_NAMESPACE=<启动参数配置文件所在的命名空间>
DIFY_ENV_NACOS_USERNAME=
DIFY_ENV_NACOS_PASSWORD=
DIFY_ENV_NACOS_ACCESS_KEY=
DIFY_ENV_NACOS_SECRET_KEY=

在启动时,Dify 应用会从 Nacos 读取相应的配置。通过这种方式,基于 Nacos, 即可实现启动参数白屏化变更和历史版本管理,提高运维效率。

结语

Aliware

Nacos 与 Dify 的结合,为生成式 AI 应用的开发效率与架构灵活性提供了新的解决方案。通过动态发现 Nacos MCP 服务,Dify 能快速集成标准化的模型工具接口,简化服务调用流程;借助 Nacos 托管 Prompt 配置,开发者无需重新部署即可实现提示词的实时优化,真正释放敏捷开发潜力;而 Nacos 对环境变量的集中管理,则进一步简化了 Dify 应用的运维复杂度,让 Dify 的部署配置更易维护和复用。这一整合不仅解决了 Dify 在 MCP 协议适配和动态配置管理上的痛点,也体现了云原生技术与 AI 开发工具的务实协作。

未来,随着 AI 应用场景的不断扩展,Nacos 将进一步的拥抱 AI 生态,从基础的配置管理和服务发现,到 MCP 生态的持续拓展和集成,再到多 Agent 的协同,Nacos 将持续演进,帮助开发者提升效率,降低复杂环境下的开发与运维成本,让 AI 应用的构建更加高效、稳定。

附:

【1】Nacos MCP

https://marketplace.dify.ai/plugins/nacos/nacos_mcp?language=zh-Hans&theme=system

【2】MCP Server 自动注册手册

https://nacos.io/docs/latest/manual/user/ai/mcp-auto-register/?spm=5238cd80.6f0ee98.0.0.3bbf480cbJHznr&source=blog

【3】存量 API 转换 MCP 手册

https://nacos.io/docs/latest/manual/user/ai/api-to-mcp/

【4】Nacos MCP

https://marketplace.dify.ai/plugins/nacos/nacos_mcp?language=zh-Hans&theme=system

【5】Nacos MCP 插件

https://marketplace.dify.ai/plugins/nacos/nacos_mcp?language=zh-Hans&theme=system

【6】源代码方式启动 Dify 服务

https://docs.dify.ai/zh-hans/getting-started/install-self-hosted/local-source-code

阅读原文

跳转微信打开

Fish AI Reader

Fish AI Reader

AI辅助创作,多种专业模板,深度分析,高质量内容生成。从观点提取到深度思考,FishAI为您提供全方位的创作支持。新版本引入自定义参数,让您的创作更加个性化和精准。

FishAI

FishAI

鱼阅,AI 时代的下一个智能信息助手,助你摆脱信息焦虑

联系邮箱 441953276@qq.com

相关标签

Nacos Dify 生成式AI LLMOps MCP
相关文章