【第二周】RAG与Agent实战15：模板类的 format 和 invoke 方法深度解析
在之前学习了
PromptTemplate和FewShotPromptTemplate。这两种模板在使用时有两种不同的“打开方式”：
- 使用
.format()方法，传入关键字参数。- 使用
.invoke()方法，传入一个字典。它们看起来都能生成提示词，但有什么区别？为什么要设计两套接口？本文将结合 LangChain 的底层架构，为你彻底讲清楚这两者的差异。
🏗️ 底层架构：一切皆 Runnable
首先，我们要理解 LangChain 的核心设计理念：LCEL (LangChain Expression Language)。
在 LangChain 中，几乎所有组件（包括模型、模板、检索器）都继承自一个基类 ——Runnable。这意味着它们都遵循一套标准的输入/输出接口，可以像乐高积木一样通过|符号串联起来。
类继承关系图
让我们看看 Prompt 相关类的继承结构：
Runnable：定义了.invoke()方法的标准行为。这是为了支持链式调用。BasePromptTemplate：定义了.format()方法的标准行为。这是为了兼容传统的字符串格式化习惯。- 子类(
PromptTemplate,FewShotPromptTemplate,ChatPromptTemplate)：同时继承了这两套能力。
⚔️ format vs invoke：核心区别对比
虽然两者都能生成提示词，但在返回值类型、传参方式和扩展性上有本质区别。
| 特性 | .format()方法 | .invoke()方法 |
|---|---|---|
| 定位 | 传统字符串工具方法 | Runnable 标准接口(推荐) |
| 功能 | 纯字符串替换，解析{}占位符 | 解析占位符，生成标准化的 PromptValue 对象 |
| 返回值类型 | str(普通字符串) | PromptValue对象(可转换为 string 或 messages) |
| 传参方式 | 关键字参数：template.format(k=v) | 字典输入：template.invoke({"k": v}) |
| 链式调用 | ❌ 不支持直接接入 Chain | ✅完美支持(`template |
| 高级特性 | 仅支持简单{}变量 | 支持MessagesPlaceholder等结构化占位符 |
💡一句话总结：
- 如果你只是想快速打印一下提示词看看效果，用
.format()。- 如果你要构建生产级的 AI 应用、连接 Chain 或处理多轮对话，必须用
.invoke()。
💻 实战代码对比
让我们通过代码直观地感受两者的不同。
1. 使用.format()方法
这是最直观的写法，适合调试。
fromlangchain_core.promptsimportPromptTemplate template=PromptTemplate.from_template("我的邻居是 {lastname}，最喜欢：{hobby}")# 传入关键字参数res=template.format(lastname="张三",hobby="足球")print("📝 结果内容:",res)print("📦 数据类型:",type(res))输出：
📝 结果内容: 我的邻居是 张三，最喜欢：足球 📦 数据类型: <class 'str'>注意：返回的是纯粹的 Python 字符串。
2. 使用.invoke()方法
这是 LangChain 推荐的写法，适合集成到工作流中。
fromlangchain_core.promptsimportPromptTemplate template=PromptTemplate.from_template("我的邻居是 {lastname}，最喜欢：{hobby}")# 传入字典res2=template.invoke(input={"lastname":"张三","hobby":"足球"})print("📝 结果内容:",res2)# 打印对象时会自动显示字符串内容，方便查看print("📦 数据类型:",type(res2))# 如果需要显式获取字符串，可以调用 .to_string()print("🔤 显式转字符串:",res2.to_string())输出：
📝 结果内容: my neighbor is 张三，最喜欢：足球 # (注：这里打印的是 PromptValue 对象的 __str__ 表示) 📦 数据类型: <class 'langchain_core.prompt_values.StringPromptValue'> 🔤 显式转字符串: 我的邻居是 张三，最喜欢：足球注意：返回的是
StringPromptValue对象。它不仅仅是一个字符串，它还包含了元数据，并且知道如何将自己转换为 LLM 或 ChatModel 能理解的格式。
🧐 为什么要区分 StringPromptValue 和 str？
你可能会问：“直接返回字符串不是更简单吗？为什么要搞个对象包一层？”
这是因为 LangChain 需要同时支持LLM (文本模型)和ChatModel (聊天模型)：
- LLM只需要纯字符串 (
str)。 - ChatModel需要消息列表 (
List[BaseMessage])，包含 System/Human/AI 角色。
PromptValue对象是一个适配器：
- 当它连接到 LLM 时，调用
.to_string()提供字符串。 - 当它连接到 ChatModel 时，调用
.to_messages()提供消息列表。
如果你使用.format()得到纯字符串，再传给 ChatModel，LangChain 就不得不猜测这条消息是用户说的还是系统说的（默认通常当作 HumanMessage），这可能导致上下文混乱。而使用.invoke()得到的PromptValue则能明确身份。
🚀 最佳实践建议
在实际开发中，请遵循以下原则：
构建 Chain 时：
永远使用invoke或直接使用|操作符。# ✅ 推荐chain=template|model result=chain.invoke({"lastname":"李四","hobby":"篮球"})调试/日志记录时：
可以使用format快速查看最终生成的提示语文本，方便排查问题。# ✅ 用于调试print(template.format(lastname="王五",hobby="游泳"))处理多轮对话 (ChatPromptTemplate)：
必须使用invoke。因为ChatPromptTemplate内部可能包含MessagesPlaceholder，这种结构化占位符只有invoke能正确解析，format无法处理。
🚀 总结
本节课我们深入理解了 LangChain 模板系统的底层逻辑：
- 继承体系：所有模板类都继承自
Runnable和BasePromptTemplate，因此同时拥有invoke和format能力。 - 核心差异：
format返回str，适合简单调试。invoke返回PromptValue，是标准接口，支持链式调用和复杂场景。
- 未来趋势：随着 LangChain 的发展，
invoke和 LCEL 语法将成为绝对主流。