我要投稿

Spring AI Alibaba 动态 Prompt 最佳实践：用 Nacos 实现 Prompt 实时更新

发布日期：2025-08-07 18:56:38 浏览次数： 1741

作者：Fox爱分享

微信搜一搜，关注“Fox爱分享”

一、引言：AI 应用的“Prompt 痛点”

在 AI 应用开发中，Prompt（提示词） 是连接人类意图与 AI 模型的核心桥梁。例如：

电商推荐：“根据用户最近浏览的手机，推荐 3 款性价比高的机型”；
客服回复：“针对用户的退款问题，生成友好的安抚话术”；
内容生成：“列出鲁迅最著名的 5 本小说，只需要书名”。

然而，传统 Prompt 管理方式存在明显缺陷：

静态 Prompt：Prompt 写死在代码中，修改需重启应用，影响开发效率；
分散管理：不同模块的 Prompt 散落在各处，难以统一维护；
动态需求：业务需要根据用户行为、场景变化实时调整 Prompt（如促销活动期间的推荐话术）。

为解决这些问题，Spring AI Alibaba 提供了 Nacos 动态 Prompt 管理方案，通过 Nacos 配置中心实现 Prompt 的实时更新、统一管理、版本控制，无需重启应用即可调整 AI 模型的输入。

二、技术背景：Spring AI Alibaba 与 Nacos 的协同

1. Spring AI Alibaba

Spring AI Alibaba 是 Spring 生态下的 AI 开发框架，整合了阿里云的 AI 服务（如通义千问）和配置中心（如 Nacos），简化了 AI 应用的开发流程。其核心功能包括：

Prompt 模板管理：支持静态模板、动态模板（从配置中心加载）；
AI 模型集成：无缝对接通义千问、ChatGPT 等模型；
配置动态刷新：通过 Nacos 实现 Prompt 实时更新。

2. Nacos 配置中心

Nacos 是阿里巴巴开源的动态服务发现、配置管理工具，具备：

实时配置推送：配置变更后，立即通知所有订阅的应用；
版本管理：保存配置的历史版本，支持回滚；
高可用性：支持集群部署，保证配置服务的稳定性。

三、环境准备

1. Nacos 安装

下载 Nacos：Nacos 官方下载页；
启动 Nacos：sh bin/startup.sh -m standalone（单机模式）；
访问 Nacos 控制台：http://localhost:8848/nacos（默认用户名/密码：nacos/nacos）。

2. 项目依赖

在 pom.xml 中添加以下依赖（需引入 Spring AI Alibaba Bom 和 Spring Boot Bom）：

<!-- Web 依赖 --><dependency>    <groupId>org.springframework.boot</groupId>    <artifactId>spring-boot-starter-web</artifactId></dependency>
<!-- 阿里云 AI 模型依赖（如通义千问） --><dependency>    <groupId>com.alibaba.cloud.ai</groupId>    <artifactId>spring-ai-alibaba-starter-dashscope</artifactId></dependency>
<!-- Nacos 动态 Prompt 依赖 --><dependency>    <groupId>com.alibaba.cloud.ai</groupId>    <artifactId>spring-ai-alibaba-starter-nacos-prompt</artifactId></dependency>

四、实现步骤：动态 Prompt 管理

1. 配置文件：application.yml

在 application.yml 中配置 Nacos 连接信息和 Prompt 监听：

server:  port: 10010
spring:  application:    name: nacos-demo
  # Nacos 配置中心  nacos:    server-addr: 127.0.0.1:8848  # Nacos 服务地址
  ai:  # 开启 nacos 的 prompt template 监听功能  nacos:    prompt:      template:        enabled: true  dashscope:    api-key: ${AI_DASHSCOPE_API_KEY}

2. 代码实现：动态获取 Prompt

在 Controller 中使用 ConfigurablePromptTemplateFactory 动态获取 Nacos 中的 Prompt：

@RestController@RequestMapping("/nacos")public class PromptController {
    private static final Logger logger = org.slf4j.LoggerFactory.getLogger(PromptController.class);
    private final ChatClient client;
    private final ConfigurablePromptTemplateFactory promptTemplateFactory;
    public PromptController(            ChatModel chatModel,            ConfigurablePromptTemplateFactory promptTemplateFactory    ) {
        this.client = ChatClient.builder(chatModel).build();        this.promptTemplateFactory = promptTemplateFactory;    }
    @GetMapping("/books")    public Flux<String> generateJoke(            @RequestParam(value = "author", required = false) String authorName,            HttpServletResponse response    ) {
        // 防止输出乱码        response.setCharacterEncoding("UTF-8");
        // 1. 获取模板实例（优先使用Nacos配置）        ConfigurablePromptTemplate template = promptTemplateFactory.getTemplate("author");
        // 2. 无配置时使用默认值        if (template == null) {            template = promptTemplateFactory.create(                    "author",                    "请列出这位{author}最著名的三本书。",                    Map.of("author", "鲁迅")            );        }
        Map<String, Object> model = new HashMap<>();        if(StringUtils.hasText(authorName)){            // 3. 添加动态参数（覆盖模版变量）            model.put("author", authorName);        }
        // 4. 创建Prompt对象        Prompt prompt = template.create(model);
        // 5. 记录日志（便于调试）        logger.info("最终构建的 prompt 为：{}", prompt.getContents());
        // 6. 调用AI服务        return client.prompt(prompt)                .stream()                .content();    }
}

3. Nacos 配置：添加 Prompt 模板

DataID：spring.ai.alibaba.configurable.prompt（参考源码ConfigurablePromptTemplateFactory）；
Group：DEFAULT_GROUP；
配置内容：

[  {    "name": "author",    "template": "列出 {author} 有名的著作，只需要书名清单",    "model": {      "author": "鲁迅"    }  }]

五、功能演示：动态更新 Prompt

1. 启动验证

启动项目后，查看日志：

说明 Nacos 中的 Prompt 已成功加载。

2. 发送请求

发送 GET 请求：http://127.0.0.1:10010/nacos/books?author=鲁迅，返回结果：

3. 动态更新 Prompt

在 Nacos 控制台修改配置中的 template：

[  {    "name": "author",    "template": "介绍 {author}，列出其生平经历和文学成就",    "model": {      "author": "鲁迅"    }  }]

点击“发布”后，无需重启应用，再次发送请求，返回结果：

六、应用场景

1. 电商推荐

根据用户浏览记录动态调整推荐 Prompt：


[  {    "name": "product_recommendation",    "template": "根据用户最近浏览的 {product_type}，推荐 3 款性价比高的产品，包括价格和特点。",    "model": { "temperature": 0.6 }  }]

2. 客服回复

根据用户问题类型动态切换回复 Prompt：


[  {    "name": "refund_reply",    "template": "针对用户的退款问题，生成友好的安抚话术，说明退款流程。",    "model": { "temperature": 0.5 }  },  {    "name": "delivery_reply",    "template": "回答用户的物流查询问题，提供预计送达时间和快递单号。",    "model": { "temperature": 0.5 }  }]