一什么是PromptTemplate模板1概念PromptTemplate是 Spring AI 中构建和管理提示词的核心组件主要作用如下核心功能允许创建带占位符的文本模板在运行时动态替换占位符变量。最基础的能力是变量替换在模板中定义占位符运行时传入变量值完成渲染。设计类比相当于 AI 交互中的「视图层」类比 Spring MVC 中的视图模板如 JSP。用于结构化、可维护地管理提示词降低硬编码带来的维护成本便于提示词的优化和扩展。2示例// 定义带有变量的模板 String template 你好{name}。今天是{day}天气{weather}。; // 创建模板对象 PromptTemplate promptTemplate new PromptTemplate(template); // 准备变量映射 MapString, 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);这种方式的优势分离管理将复杂提示词放在单独文件中与代码解耦动态调整无需修改代码即可更新提示词内容多场景复用为不同业务场景准备多套模板灵活切换类似配置文件实现提示词与代码的前后端分离便于版本控制和维护
AI超级智能开发系列从入门到上天第七篇：PromptTemplate模板
一什么是PromptTemplate模板1概念PromptTemplate是 Spring AI 中构建和管理提示词的核心组件主要作用如下核心功能允许创建带占位符的文本模板在运行时动态替换占位符变量。最基础的能力是变量替换在模板中定义占位符运行时传入变量值完成渲染。设计类比相当于 AI 交互中的「视图层」类比 Spring MVC 中的视图模板如 JSP。用于结构化、可维护地管理提示词降低硬编码带来的维护成本便于提示词的优化和扩展。2示例// 定义带有变量的模板 String template 你好{name}。今天是{day}天气{weather}。; // 创建模板对象 PromptTemplate promptTemplate new PromptTemplate(template); // 准备变量映射 MapString, 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);这种方式的优势分离管理将复杂提示词放在单独文件中与代码解耦动态调整无需修改代码即可更新提示词内容多场景复用为不同业务场景准备多套模板灵活切换类似配置文件实现提示词与代码的前后端分离便于版本控制和维护
