惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

博客园 - 叶小钗
Cyber Security Advisories - MS-ISAC
Cyber Security Advisories - MS-ISAC
Microsoft Security Blog
Microsoft Security Blog
罗磊的独立博客
大猫的无限游戏
大猫的无限游戏
美团技术团队
让小产品的独立变现更简单 - ezindie.com
让小产品的独立变现更简单 - ezindie.com
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
aimingoo的专栏
aimingoo的专栏
腾讯CDC
WordPress大学
WordPress大学
Apple Machine Learning Research
Apple Machine Learning Research
F
Fortinet All Blogs
G
Google Developers Blog
MongoDB | Blog
MongoDB | Blog
Microsoft Azure Blog
Microsoft Azure Blog
小众软件
小众软件
Engineering at Meta
Engineering at Meta
博客园_首页
B
Blog RSS Feed
D
Docker
M
MIT News - Artificial intelligence
爱范儿
爱范儿
I
InfoQ

博客园_首页

Plist 二进制格式 Milvus 和 PGVector,哪个更好? OpenClaw 已过时?在 VS Code 中运行 Hermes Agent! 第30篇文章:一个大三计科生的自白 Manim如何在数学公式中完美显示中文? Docker 部署 RocketMQ 5 并发编程核心概念辨析 C#事务处理最佳实践:别再让“主表存了、明细丢了”的破事发生 CLI 是什么?为什么大厂突然集体卷命令行? 【从0到1构建一个ClaudeAgent】协作-自主Agent UIImageView 设置图片不生效的原因排查 最小二乘问题详解20:无先验约束下的增量式SFM自由网平差 痞子衡嵌入式:大话双核i.MXRT1180之XIP应用里借助MU实现可靠Flash IAP的方法 AI Chat 封装, SemanticKerne.AiProvider.Unified 已发布 Windows下右键编辑js文件无法打开记事本——在注册表中使用环境变量 在后台服务中使用 Scoped 服务,为什么总是报错? H200 安装驱动并使用sglang启动模型 wireshark 抓包Trap上报告警内容 我用 AI 辅助开发了一系列小工具(2):图片压缩工具 [A Primer On MC and CC] 2.1 Memory Consistency 1 - 指令重排序和 SC 模型 Oracle数据库SCN推进技术详解与实践指南 玩转控件:封装个带图片的Label控件 Claude Code 4.7 真正该升级的不是模型,而是你的工作流 前端小白一句话,AI 帮我做了个颜值拉满的桌面媒体播放器。当代码不再是门槛,一句话编程就是现实。 5. WorkBuddy: 小龙虾的灵魂三件套,让你的小龙虾不只是工具 SQLite 分片方案实战:三种分片策略的深度对比 告别简陋 UI!一款基于 Fluent Design 和基于 WinUI 的开源免费、现代化的 Avalonia UI 控件库 关于二进制排列组合枚举的总结 AI开发-python-LangGraph框架(3-27-LangGraph从零实现大模型智能决策工作流) ElasticSearch主分片和副本分片概念详解
15. 别再硬写提示词了!LangChain ChatPromptTemplate核心实战
老陈说编程 · 2026-05-15 · via 博客园_首页

在使用LangChain与AI交互时,想要让对话更有条理、适配多角色、多轮次的沟通场景,ChatPromptTemplate这个工具绝对少不了。它本质上就是一个用来构建聊天消息列表的提示模板,能帮我们规范AI的交互逻辑,让每一次对话都更贴合预期。

如果你喜欢看视频学习,就看 《15. LangChain ChatPromptTemplate核心实战》

prompt_template = ChatPromptTemplate.from_messages([
    SystemMessagePromptTemplate.from_template("你是AI开发助手{name},擅长编程开发。"),
    HumanMessagePromptTemplate.from_template("你能帮我做什么?"),
    AIMessagePromptTemplate.from_template("我可以帮你写代码、改bug。"),
    HumanMessagePromptTemplate.from_template("{user_question}")
])

使用这个模板时,写法可以灵活调整。如果只是简单传递消息内容,不需要额外附带参数,用字符串别名的写法会特别简洁,省去不少冗余操作。

prompt_template = ChatPromptTemplate.from_messages([
    ("system", "你是AI开发助手{name},擅长编程。"),
    ("user", "你能帮我做什么?"),
    ("ai", "我可以帮你写代码、改bug。"),
    ("user", "{user_question}")
])

但如果追求更高的清晰性和可扩展性,想兼容一些高级功能,那字典写法就比元组简写更合适,后续维护和修改也会更方便。

prompt_template = ChatPromptTemplate.from_messages([
    {"role": "system", "content": "你是AI开发助手{name},擅长编程。"},
    {"role": "user", "content": "你能帮我做什么?"},
    {"role": "ai", "content": "我可以帮你写代码、改bug。"},
    {"role": "user", "content": "{user_question}"}
])

这里要重点说一下不同字符串别名的用法,它们对应着不同的消息类,各有明确的用途和使用规则,记清楚这些能避免很多操作失误。

字符串别名

对应消息类

用途

使用规则

system

SystemMessage

给AI设定人设、规则和上下文

必在开头只能有1个

user/human

HumanMessage

代表用户的输入

与“ai”交替,不能连续出现2个

ai/assistant

AIMessage

表示AI的输出约束

跟在“user”后,不能连续出现2个

了解完这些基础规则,就到了实战环节,其实操作步骤很简单,一步步来就能上手。首先要做的就是导入ChatPromptTemplate类,这是所有后续操作的基础。接着,用from_messages方法创建这个类的实例,这个方法需要接收一个消息列表作为参数,列表里的每条消息都是包含role和content字段的字典,其中content里用大括号包裹的部分,就是我们后续要填充的变量占位符。通过system、user、ai这三种角色的搭配,我们就能轻松定义出完整的对话上下文,甚至可以加入回答范例,让AI更清楚该如何响应。

创建好实例后,调用invoke方法,传入一个包含具体填充值的字典,它就会自动替换掉所有的占位符,生成一个完整的PromptValue提示词对象。最后,把这个PromptValue对象传入已经初始化好的大语言模型的invoke方法,就能完成一次规范的AI交互了。

from langchain_core.prompts import ChatPromptTemplate

prompt_template = ChatPromptTemplate.from_messages([
    {"role": "system", "content": "你是AI开发助手{name},擅长编程开发和技术问题解答。"},
    {"role": "user", "content": "你能帮我做什么?"},
    {"role": "ai","content": "我可以帮你写代码、改bug、设计技术方案。"},
    {"role": "user", "content": "{user_question}"}
])
prompt_value = prompt_template.invoke(
    {
        "name": "神算子",
        "user_question": "用Python写一个简单的计算器程序"
    }
)
res = llm.invoke(prompt_value, config=config)
print(res.content)

除此之外,还有一个实用小技巧可以记一下。如果我们需要预先定义部分变量,不用每次都完整传入所有参数,借助partial方法就能轻松指定,后续使用时只需要补充剩余变量即可。

from langchain_core.prompts import ChatPromptTemplate

prompt_template = ChatPromptTemplate.from_messages([
    {"role": "system", "content": "你是AI开发助手{name},擅长编程开发和技术问题解答。"},
    {"role": "user", "content": "你能帮我做什么?"},
    {"role": "ai", "content": "我可以帮你写代码、改bug、设计技术方案。"},
    {"role": "user", "content": "{user_question}"}
])
partial_prompt = prompt_template.partial(name="神算子")
prompt_value = partial_prompt.invoke(
    {
        "user_question": "用Python写一个简单的计算器程序"
    }
)
res = llm.invoke(prompt_value, config=config)
print(res.content)

要是想在模板中嵌入消息列表,比如多轮对话的历史消息,就可以使用MessagesPlaceholder,它的字符串别名是placeholder,用起来特别便捷,能很好地适配多轮交互场景。

from langchain_core.prompts import ChatPromptTemplate

prompt_template = ChatPromptTemplate.from_messages([
    {"role": "system", "content": "你是AI开发助手{name},擅长编程开发和技术问题解答。"},
    {"role": "placeholder", "content": "{chat_history}"},
    {"role": "user", "content": "你能帮我做什么?"},
    {"role": "ai", "content": "我可以帮你写代码、改bug、设计技术方案。"},
    {"role": "user", "content": "{user_question}"}
])
partial_prompt = prompt_template.partial(name="神算子")
prompt_value = partial_prompt.invoke(
    {
    "user_question": "用Python写一个简单的计算器程序",
    "history": [
    {"role": "user", "content": "我想做个编程工具"},
    {"role": "ai", "content": "我来帮你实现"}
    ]
    }
)
res = llm.invoke(prompt_value, config=config)
print(res.content)