纲要部分格式化概念分步填充模板变量PromptTemplate的partial方法静态值部分格式化先填充已知变量函数部分格式化动态生成变量值如当前时间典型应用场景异步获取变量、时间戳注入完整可运行代码包含静态与动态两种 Partial 用法引言在构建提示词模板时有时模板需要多个变量但这些变量的值并不是同时就绪的。比如一个变量来自用户输入另一个变量需要从数据库异步查询甚至需要动态生成当前时间。如果直接调用format必须一次性传入所有参数这会让代码变得生硬且难以维护。LangChain 的PromptTemplate提供了partial方法支持对模板进行“部分格式化”。你可以先填充已知的变量得到一个仍然包含未填充变量的中间模板待剩余变量就绪后再完成最终格式化。这种方式让提示词的构建过程更加灵活也更符合异步编程的习惯。部分格式化的两种模式静态值填充假设有一个模板需要foo和bar两个变量。foo的值可以提前确定而bar需要稍后才能获取。可以先使用partial传入foo得到一个“半成品”模板随后在获得bar的值时再调用format完成填充。整个过程模板本身不会立即变成字符串而是保留为一个结构化对象方便继续处理。函数动态生成更常见的场景是某些变量需要在每次调用时动态生成比如当前日期时间。你可以将一个无参函数作为部分格式化的值当最终调用format时该函数会被自动执行并将返回值填入模板。这样每次生成提示词时时间戳都是最新的。完整可运行代码以下代码演示了两种 Partial 用法无需外部 API Key可直接运行。安装依赖pipinstalllangchain-core核心代码fromlangchain_core.promptsimportPromptTemplatefromdatetimeimportdatetime# 定义一个包含两个变量的模板templatefoo 的值为{foo}bar 的值为{bar}# 创建 PromptTemplate 对象promptPromptTemplate.from_template(template)# ----- 示例1静态值部分格式化 -----# 先填充 foo保留 bar 未填充partial_promptprompt.partial(foofoo_test)print(部分格式化后的对象)print(partial_prompt)print()# 稍后获得 bar 的值完成最终格式化final_promptpartial_prompt.format(barbarzzz)print(完全格式化后的提示词)print(final_prompt)print()# ----- 示例2使用函数动态生成当前时间 -----# 定义一个返回当前时间的函数defget_current_time():returndatetime.now().strftime(%Y-%m-%d %H:%M:%S)# 新的模板需要 adjective 和 date 两个变量time_template给我讲一个{adjective}的笑话日期是{date}time_promptPromptTemplate.from_template(time_template)# 部分格式化将 date 绑定到时间函数time_partialtime_prompt.partial(dateget_current_time)# 最终格式化时只需传入 adjectivedate 会自动调用函数生成joke_prompttime_partial.format(adjective有趣的)print(带动态时间的提示词)print(joke_prompt)print(再次执行时间会变化)print(time_partial.format(adjective有趣的))运行后会看到final_prompt中foo已被替换为foo_testbar为barzzz而带时间的提示词每次执行都会显示不同的当前时间验证了函数的动态执行。应用场景扩展异步数据注入部分变量来自用户请求另一部分需要查询外部服务。先partial填充已获取的值待异步结果返回后再format。默认参数设置为模板的某些变量设定默认函数如获取用户 ID、会话信息避免在每次调用时重复传递。动态上下文将partial与RunnableLambda结合可在 Chain 中动态注入上下文实现更灵活的流程编排。总结PromptTemplate.partial打破了“必须一次性提供所有变量”的限制将格式化过程拆解为多个步骤使模板可以更好地适应异步和动态场景。无论是提前确定部分参数还是注入动态生成的值这一特性都能让提示词管理更简洁、更强大。