导航收藏不迷路—制造业数据与AI践行者老蒋的技术博客全系列文章汇总持续更新文章摘要在LangChain的PromptTemplate中嵌入JSON示例时{line_name: 交互屏组装A线}中的花括号被误解析为模板变量触发INVALID_PROMPT_INPUT错误。本文深入剖析PromptTemplate的变量解析机制揭示{}语法与JSON格式的冲突本质并提供“双花括号转义”与“变量占位符隔离”的解决方案。适用于所有使用LangChain PromptTemplate进行提示词工程的Python项目。问题现象兄弟们前面几篇排坑笔记你们也看了我们搞定了导入链污染、搞定了版本碎片化、搞定了中文括号、搞定了Agent的嵌套JSON。我本以为可以消停一会儿了。然后我继续跑Agent测试输入计算交互屏组装A线在2026-07-12的OEE结果Agent还没开始思考直接给我弹了个大红叉❌ 错误: Input to PromptTemplate is missing variables {\line_name\}. Expected: [\line_name\, \agent_scratchpad\, \input\] Received: [\input\, \intermediate_steps\, \agent_scratchpad\] Note: if you intended {line_name} to be part of the string and not a variable, please escape it with double curly braces like: \{{line_name}}\.我当时的第一反应还是这不科学啊......我只是在Prompt里写了一个JSON示例想告诉Agent应该怎么传参数。LangChain凭什么把我的示例JSON里的花括号当成变量名而且报错信息里那个Note——它明明知道问题在哪为什么不自己处理非要让我手动去改根因分析说实话这个问题的报错信息其实已经把答案写在脸上了——就是那一行Note。但我当时没仔细看还以为是Prompt写错了改了半天格式绕了一大圈才回到这个提示上。第一层PromptTemplate的“占位符”机制LangChain的PromptTemplate有一个核心设计用{变量名}来表示需要动态填充的位置。比如你写template 你好{name}今天是{date} prompt PromptTemplate.from_template(template) prompt.format(name老蒋, date2026-07-20) # 输出你好老蒋今天是2026-07-20这是它的正常工作方式——{name}和{date}是变量占位符运行时会被替换成实际值。第二层JSON的花括号撞上了占位符语法问题出在当我在Prompt里写了一个JSON示例告诉Agent应该怎么调用工具时template ... Action Input: {line_name: 交互屏组装A线, date: 2026-07-12} ... PromptTemplate在解析这个模板时看到{line_name心里想的是“哦这里有一个{开始的花括号后面跟着line_name这是一个变量名。我要找它的右括号}来闭合。但是等一下怎么一直匹配到JSON结束都没有找到不管了先记下来需要用户提供line_name这个变量。”于是它就认为line_name是一个需要用户输入的变量名要求你提供它——但你根本没想用它当变量它只是JSON示例里的一段文本啊说白了就是PromptTemplate只认识{}是占位符它不管你的{}里面写的是什么。只要是{}它就当变量处理。第三层为什么报错信息明明提示了却不自动处理这个是最气人的。报错信息里那句Note写得清清楚楚Note: if you intended {line_name} to be part of the string and not a variable, please escape it with double curly braces like: {{line_name}}.它知道问题在哪也知道怎么解决但它就是不做。非要你手动去把花括号改成双层的。这就像你去餐馆点菜服务员跟你说“先生您的菜里有辣椒如果您不能吃辣可以自己把辣椒挑出来。”——你心里想的是你不应该帮我提醒厨房别放辣椒吗解决方案别慌三步搞定它。第一步找到你的Prompt模板打开common/base_agent_builder.py找到_get_prompt_template方法。在方法的字符串里你一定写了类似这样的JSON示例def _get_prompt_template(self) - str: return 调用工具时Action Input必须是一个JSON对象。 例如{line_name: 交互屏组装A线, date: 2026-07-12} 第二步把单花括号改成双花括号核心规则JSON示例中的花括号用双层的{{和}}变量占位符保持单层的{和}。def _get_prompt_template(self) - str: return 调用工具时Action Input必须是一个JSON对象。 例如{{line_name: 交互屏组装A线, date: 2026-07-12}} 同时确保真正的变量占位符比如{input}、{agent_scratchpad}保持单花括号def _get_prompt_template(self) - str: return ... Question: {input} Thought: {agent_scratchpad} 第三步理解这张“对照表”以后就不会再搞混了你的意图写法PromptTemplate的行为显示一个JSON示例{{key: value}}当作文本原样输出{key: value}定义一个变量占位符{variable}运行时替换为实际值显示文本中的普通花括号{{和}}每个双花括号转义成一个单花括号记住这个表以后就不会再被这个坑绊倒了。经验总结怕你忘了我再啰嗦一遍PromptTemplate里JSON的花括号不是拿来给你当示例用的它是用来定义变量的。你想显示JSON就得用双花括号把它“藏”起来。落到具体操作上就是四条JSON示例全部用双花括号{key: value}→{{key: value}}。只要你的Prompt里包含JSON示例就得这么写没有例外。变量占位符保持单花括号{input}、{agent_scratchpad}、{tools}、{tool_names}这些是真正的变量必须保持单花括号不能乱改。区分规则很简单想显示给用户看的JSON → 双花括号想让LangChain替换内容的变量 → 单花括号。一句话显示的用双层替换的用单层。调试技巧如果遇到missing variables报错先把Prompt里的所有花括号过一遍。看到{就去确认这到底是JSON示例还是变量如果是JSON示例立刻改成{{。90%的情况改完就好了。说白了就是一句话花括号是LangChain的“魔法符号”你想让它显示出来就得用双层的。这就像Markdown里你想显示#号得用转义一样。系列导航本文属于《数据与AI工程排坑笔记》系列上一篇Agent的“嵌套JSON”噩梦当Action Input变成字符串套娃下一篇《Agent无记忆之痛为什么用户说了3次“交互屏组装A线”它还在问》即将发布本文问题源自智联工坊实战制造知识库工具调用Agent从零搭建OEE手册排班-CSDN博客 完整源码及深度教程见该文详细内容。建议关注收藏下次遇到INVALID_PROMPT_INPUT报错可以快速对照本文排查。互动与交流你在使用LangChain或其他模板引擎时有没有被花括号坑过欢迎在评论区吐槽咱们互相安慰一下——也让我知道多少人被标点符号折磨过的人关于作者制造业数据与AI践行者老蒋23年IT老兵。聚焦制造业数据架构与AI融合落地。全流程实战全源码开源。标签#排坑笔记#LangChain#Prompt#踩坑实录