当前位置：首页 > news >正文

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

news 2026/5/12 13:01:44

一：什么是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);

这种方式的优势