AI超级智能开发系列从入门到上天第七篇：PromptTemplate模板

一：什么是PromptTemplate模板

1：概念

PromptTemplate 是 Spring AI 中构建和管理提示词的核心组件，主要作用如下：

核心功能
- 允许创建带占位符的文本模板，在运行时动态替换占位符变量。
- 最基础的能力是变量替换：在模板中定义占位符，运行时传入变量值完成渲染。
设计类比
- 相当于 AI 交互中的「视图层」，类比 Spring MVC 中的视图模板（如 JSP）。
- 用于结构化、可维护地管理提示词，降低硬编码带来的维护成本，便于提示词的优化和扩展。

2：示例

复制代码

// 定义带有变量的模板
String template = "你好，{name}。今天是{day}，天气{weather}。";

// 创建模板对象
PromptTemplate promptTemplate = new PromptTemplate(template);

// 准备变量映射
Map<String, Object> variables = new HashMap<>();
variables.put("name", "鱼皮");
variables.put("day", "星期一");
variables.put("weather", "晴朗");

// 生成最终提示文本
String prompt = promptTemplate.render(variables);
// 结果: "你好，鱼皮。今天是星期一，天气晴朗。"

3：适用场景

模板思路在编程中广泛应用（如数据库预编译语句、日志占位符、模板引擎等），PromptTemplate 在以下场景中特别实用：

动态个性化交互：根据用户信息、对话上下文或业务规则，动态定制提示词内容。
多语言支持：使用同一套变量绑定，配合不同语言的模板文件，快速实现多语言提示词切换。
A/B 测试：轻松切换不同版本的提示词模板，对比不同 Prompt 的效果差异。
提示词版本管理：将提示词外部化（如存入配置文件 / 数据库），便于版本控制和迭代优化。

二：PromptTemplate 实现原理提取

PromptTemplate 是 Spring AI 中用于提示词模板化的核心组件，其底层实现如下

底层依赖
- 底层使用 OSS StringTemplate 模板引擎，这是一个专注于文本生成的强大模板引擎。
接口实现
- PromptTemplate 类实现了两个核心接口：
  
  java
  
  运行
  复制代码
```
public class PromptTemplate implements PromptTemplateActions, PromptTemplateMessageActions {
    // 实现细节
}
```
- PromptTemplateActions：提供基础模板操作能力。
- PromptTemplateMessageActions：提供结构化消息生成能力。
能力范围
- 这些接口让 PromptTemplate 既可以生成普通文本 ，也可以生成结构化消息，满足不同场景下的提示词构建需求。

三：专用模板类

Spring AI 提供了三种对应不同消息角色的专用模板类：

SystemPromptTemplate
- 用于系统消息，核心作用是设置 AI 的行为、背景、角色定位等。
AssistantPromptTemplate
- 用于助手消息，主要用于定义 AI 回复的结构、格式或示例。
FunctionPromptTemplate
- 目前暂无实际用途，属于预留或未启用的模板类。

四：PromptTemplate 外部文件提取

PromptTemplate 支持从外部文件加载模板内容，适合管理复杂提示词，底层依赖 Spring 的 Resource 接口加载资源。

核心代码示例

复制代码

// 从类路径资源加载系统提示模板
@Value("classpath:/prompts/system-message.st")
private Resource systemResource;

// 直接使用资源创建模板
SystemPromptTemplate systemPromptTemplate = new SystemPromptTemplate(systemResource);

这种方式的优势

分离管理：将复杂提示词放在单独文件中，与代码解耦
动态调整：无需修改代码即可更新提示词内容
多场景复用：为不同业务场景准备多套模板，灵活切换
类似配置文件：实现提示词与代码的前后端分离，便于版本控制和维护