动态Prompt构建：变量插值实战指南

可视化演示

展示TCP三次握手建立连接和四次挥手终止连接的完整流程，切换模式查看各阶段报文交互和状态转换。

变量插值基础

厨师老张每天上班第一件事，就是看冰箱。菜谱模板上写着“今日特供：{{主料}} + {{辅料}}”，他把“主料”填成“鲈鱼”、“辅料”填成“姜葱”，菜单就出来了。这份模板最妙的地方在于：架子不变，内容随时换。这就是“变量插值”——把一段文本里的固定空位，用运行时的值去填充。

在 Prompt 工程里，模板不再是打印在纸上的死文字，而是一个带占位符的“活架子”：

当用户提问时，程序把 role_name 替换成“客服小王”、question 替换成“怎么退货”，一条完整的指令就生成了。主流的 Prompt 框架（如 LangChain 的 PromptTemplate、Jinja2 模板引擎）都采用双花括号 {{var}} 语法，原因很巧妙：单花括号可能会跟其他模板语法打架，双花括号既显眼又安全。

变量还有一个容易忽略的“作用域”问题。模板内定义的临时变量只在模板内部可见，外部代码拿不到；反过来也一样，外部脚本可以注入变量，但模板不能反过来修改外部状态。这就像菜谱上写的“备菜清单”只有后厨看得懂，客人看不到，双方各管各的。

老张把填好食材的菜单递给灶台，一份菜就开始了。你也一样——写好模板、注入变量、生成 Prompt、交给 LLM，一份“动态菜单”就此完成。

你是{{role_name}}。用户的问题：{{question}}

条件渲染技巧

有天早上，老张打开冰箱：鲈鱼卖完了。他不能取消“今日特供”，于是翻到菜谱第二页：“若无{{主料}}，则改用{{替代主料}}”。菜谱还是那张菜谱，但内容会根据现实条件自动切换——这就是“条件渲染”。

Prompt 模板常常需要“看情况说话”。比如智能客服，只有用户提供了订单号才需要附上“正在查询订单”，否则就应该跳过这段，直接问“请提供订单号”。如果不管三七二十一全部注入，模型反而会被无关信息带偏。

实际工程里，条件渲染还常配“默认值兜底”：{{用户名 | default('访客')}}。这就像菜单上写着“今日例汤：{{例汤名}}”，如果今天没熬汤，就自动写“今日无例汤供应”，而不是让一个空白的占位符暴露在主厨面前。条件判断让菜谱有了“应变能力”，默认值则保证了任何情况下模板都不会出现空空洞洞的尴尬。

循环结构应用

周末餐厅接了 20 桌婚宴，每桌的饮品清单一模一样：可乐、橙汁、雪碧各一瓶。老张没有手写 20 遍，而是在菜谱模板里写“{% for 桌 in 20 %}{{桌}}号桌：可乐、橙汁、雪碧各一瓶{% endfor %}”。模板会自己展开 20 行，一行不多，一行不少。

Prompt 中也一样。当你要让 AI 处理一组数据——比如分析五条用户评价、汇总本周七个 bug、遍历三个人物设定——你不需要手工拼接，而是用循环结构让模板自动批量生成。

循环里还能自动编号：{{loop.index}}. {{item}}，生成“1. 买菜 2. 写文档 3. 开会”。这就像婚宴上每桌除了饮品还放一张桌号牌——位置一样，编号不同。批量生成看似只是省了打字，但真正的好处是格式统一、不会漏项：人的手写会出错，循环不会。

上下文动态注入

小李是这家餐厅的熟客，上周来点过红烧肉，还专门叮嘱过“少放糖”。今天他刚坐下，服务员就在传菜小票上写：熟客小李，口味偏咸，上次点过红烧肉。后厨一看就懂了——不用客人开口，菜已经往他心坎里做。

大模型也一样没有记忆。你上次问过它什么，它转头就忘。所以要在 Prompt 里“注入上下文”：把用户画像、会话历史、环境信息像传菜小票一样夹带进去。这样模型才“知道”在和谁说话、之前聊过什么、当前是什么场景。

这三者用“异或”式的拼接还提醒我们：不是所有信息都要堆上去。上下文过长反而会稀释模型注意力，让重点信息淹没在噪声里。好的“传菜小票”就三五行字，精准，不啰嗦。

Few-shot动态拼装

新来的帮厨小王没见过什么叫“合格的摆盘”。主厨没讲大道理，而是端出三个标准成品：“你看，客人点红烧肉，上桌是酱红色、带点油光；客人点清蒸鱼，上桌是白色、铺着葱丝；客人点炒青菜，上桌是翠绿、盘底无汁。”小王看过这三组例子，立刻明白了标准。这就是 Few-shot——用少量“输入→输出”示例，让模型领会任务模式。

动态构造 Few-shot 的关键在于“挑例子”：不是随机抽，而是从示例库里挑选与当前问题最相似的那些。

示例的“质量排序”也很重要：把与当前问题语义最接近的示例排在最前，模型的注意力会天然偏向靠前的内容。就像主厨把“红烧肉”的成品摆在小王面前，而不是把它藏在冰箱深处——距离决定影响力。

模板工程实践

老张的餐厅开了五年，菜谱模板改过上百次：加过新品、砍过滞销、修过配料量、调过辣度。每一版都留着编号：v1.3 加了“少油少盐”备注、v2.1 换了供应商名称。没有这些版本记录，他根本不敢随便改——改坏了怎么回滚？

Prompt 模板也是工程资产，不是写完就完事的“一次性文本”。它会被很多线上请求反复使用，改错一行就会影响所有用户。

工程实践还有几条朴素心法：一是模板独立维护，把模板存成单独文件，别硬编码在业务代码里；二是调试技巧，打印“渲染前模板”和“渲染后 Prompt”来对照，定位是模板问题还是变量问题；三是版本管理，每次改动记录版本号，评审通过再发布。菜谱需要定期清洗、更新、试菜，Prompt 模板也同样需要。

AI 应用场景

Python 演示

# -*- coding: utf-8 -*-"""动态 Prompt 构建器：变量插值实战""" class PromptBuilder:    def __init__(self, template):        self.template = template        self.vars_map = {}        self.examples_list = []        self.history_list = []        self.user_info = ""     def add_var(self, key, value):        self.vars_map[key] = value        return self     def add_example(self, inp, out):        self.examples_list.append((inp, out))        return self     def set_context(self, user_info, history):        self.user_info = user_info        self.history_list = history        return self     def fill(self, text):        for k, v in self.vars_map.items():            text = text.replace("{{" + k + "}}", str(v))        return text     def build(self, question):        parts = []        parts.append(self.template)        if self.user_info:            parts.append("用户信息：" + self.user_info)        if self.history_list:            parts.append("对话历史：")            parts.extend(self.history_list)        if self.examples_list:            parts.append("参考示例：")            for inp, out in self.examples_list:                parts.append("Q: " + inp + " -> A: " + out)        parts.append("当前问题：" + question)        prompt = "\n".join(parts)        return self.fill(prompt)  def main():    builder = PromptBuilder("你是智能客服助手。")    builder.add_var("lang", "中文")    builder.add_example("如何退货", "请提供订单号")    builder.add_example("退款多久到账", "3-5个工作日")    builder.set_context("VIP用户-张先生", ["用户之前咨询过退货流程"])    prompt = builder.build("我想退货")    print(prompt)    print("---")    print("Prompt 长度：", len(prompt))  if __name__ == "__main__":    main()

1. self.vars_map = {}变量字典，存键值对（如 lang → 中文）。用 _map 后缀避免与 add_var 方法混淆。
2. text.replace("{{" + k + "}}", str(v))核心插值逻辑：把 {{key}} 替换成实际值。
3. if self.user_info:条件渲染：用户信息为空时就跳过这段。
4. for inp, out in self.examples_list:循环拼接 Few-shot 示例。
5. parts.extend(self.history_list)把历史记录逐条展开成多行。
6. "".join—"\n".join(parts) 用换行符把所有片段连成完整 Prompt。

常见误区

面试题