摘要本文围绕 LangChain 中 Message 这一与大模型沟通的基本数据结构展开系统讲解消息类型system、user、assistant、tool、消息内容Content与元数据metadata的构成并通过 message 实例与带角色的类SystemMessage、HumanMessage、AIMessage、ToolMessage说明其用法。文章还结合 Agent 使用实例、普通使用实例以及提示词工程演示如何正确设置系统提示词并调用大模型完成实际任务。内容参考于图灵AI大模型全栈在LangChhain中Message是跟大模型沟通的基本数据结构就是说知道message的结构后就能知道什么样子后才能和大语言模型进行交互消息类型system、user、assistant、toolsystem是系统提示词它最优先遵循的user是用户提示词就是我们向大模型提问的问题assistant是大模型的回复tool是工具的回复消息内容Content它是实际的消息消息内容包含文本、图片等通过与消息类型的配合就能知道是谁的消息了元数据metadata它是可选字段可以用来描述 Content 的内容、消息的id、Token消耗情况等message实例{ messages: [ { id: msg_a1b2c3d4e5f6, role: system, content: 你是一个专业的中文翻译助手擅长将英文翻译成地道准确的中文。请保持原文的语气和语境。, metadata: { timestamp: 2026-06-10T13:40:00Z, version: v1 } }, { id: msg_b2c3d4e5f6g7, role: user, content: Could you please recommend some popular cafes near Koto Ward?, metadata: { timestamp: 2026-06-10T13:40:30Z, token_usage: { input_tokens: 12 } } }, { id: msg_c3d4e5f6g7h8, role: assistant, content: 你能给我推荐一些附近比较受欢迎的咖啡馆吗, tool_calls: [], metadata: { timestamp: 2026-06-10T13:41:00Z input_tokens: 12, output_tokens: 156, total_tokens: 168 } } ] }LangChain为我们提供了带角色的类从而让我们不需要手动写上方的 messagesSystemMessage, HumanMessage, AIMessage, ToolMessageSystemMessage表示系统消息HumanMessage表示用户消息AIMessage表示助手消息ToolMessage表示工具消息Agent使用实例效果图通过LangSmith可以看出它的系统提示词是用的 SystemMessage 里的内容但是不要这样设置系统提示词一般使用下图红框的 system_prompt 参数来设置系统提示词代码from langchain.messages import SystemMessage, HumanMessage, AIMessage, ToolMessage # create_agent是LangChain提供的创建Agent的核心模块 from langchain.agents import create_agent # 引入调用模型的openai from langchain_openai import ChatOpenAI # 引入 把.env文件中的内容加载成环境变量 的库 from dotenv import load_dotenv import os # 把.env文件中的内容加载成环境变量 load_dotenv() # 初始化模型 llm ChatOpenAI( modelqwen3.7-flash, api_keyos.getenv(DASHSCOPE_API_KEY), base_urlos.getenv(DASHSCOPE_BASE_URL), ) # 创建一个工具获取天气的工具 def get_weather(city): # 工具描述新版本LangChain会获取这个字符串当做工具的描述写到提示词中 获取指定城市的天气信息 # 工具逻辑 return f{city}天气是美好的 agent create_agent( modelllm, tools[get_weather], # 系统提示词 system_prompt你是一个智能助手能够回答用户关于天气的问题可以使用提供的天气工具来获取天气信息 ) system_msg SystemMessage(你是一个助手) human_msg HumanMessage(大模型是什么?) messages {messages:[system_msg, human_msg]} result agent.invoke(messages) print(result)普通使用实例效果图代码它跟create_agent有区别它的message只需要一个数组就可以了而create_agent需要一个字典对象{messages:[]}这样的格式这个messages不能写错了写错了就无作用from langchain.messages import SystemMessage, HumanMessage, AIMessage, ToolMessage from langchain.chat_models import init_chat_model from dotenv import load_dotenv import os # 加载环境变量 load_dotenv() # 初始化模型 llm init_chat_model(modelqwen3.7-flash, api_keyos.getenv(DASHSCOPE_API_KEY), base_urlos.getenv(DASHSCOPE_BASE_URL), model_provideropenai) # 指定模型提供商为OpenAI # 创建消息列表 # SystemMessage系统消息, HumanMessage用户消息, AIMessage助手消息, ToolMessage工具消息 system_msg SystemMessage(你是一个知识渊博的老者说话方式风趣幽默喜欢用成语和典故来表达观点。) human_msg HumanMessage(大模型是什么?) messages [system_msg, human_msg] # 也可以使用字典格式的消息列表 # messages [ # {role: system, content: 你是一个知识渊博的老者说话方式风趣幽默喜欢用成语和典故来表达观点。}, # {role: user, content: 写一首关于春天的诗句。} # ] # # # 普通对话 result llm.invoke(messages) # 会返回一个AIMessage print(result)提示词工程普通用户的提示词只需要提出问题但是系统提示词是需要很专业的一般由 系统指令、工具或函数、上下文或背景知识、历史消息、用户输入 组成系统指令设定大模型的角色比如 你是一位xxx专家请使用中文回答通过这样的角色限定大模型再回答问题时就会偏向找xxx相关的知识来回答工具或函数告诉大模型可以调用的外部工具或者函数也就是Agent中的手和脚上下文或背景知识就是给大模型的参考资料就是给大模型提问时问题中需要到的资料历史消息就是大模型的记忆我们跟大模型的聊天记录用户输入就是最新提问的问题比如 今天天气怎么样更细节的实例去看第2节代码实例效果图代码from langchain.agents import create_agent from langchain.messages import HumanMessage from langchain_openai import ChatOpenAI import os from dotenv import load_dotenv # 加载环境变量 load_dotenv() # 初始化模型 llm ChatOpenAI(modelqwen3.7-flash, api_keyos.getenv(DASHSCOPE_API_KEY), base_urlos.getenv(DASHSCOPE_BASE_URL) ) # 创建系统提示词 system_prompt # 角色 你是一位小红书爆款推文作者。 # 目标 根据用户提供的主题创作一篇小红书推文。 # 输出格式 Markdown # 内容要求 1. **标题**提供3个不同风格的爆款标题 - 公式数字形容词关键词情绪词如3款巨显白发色 | 黄皮必冲 2. **正文** - 开头2行内抓眼球痛点提问或直接安利 - 中间分点陈述用emoji加粗重点写真实体验而非堆砌参数 - 结尾引导互动评论区聊聊你的看法 3. **话题标签**提供10个精准标签组合策略大流量词细分词场景词 4. **视觉建议**一句话描述封面/配图风格 # 风格要求 口语化、有情绪感、善用绝了谁懂啊真的会谢等小红书高频词。 # 创建代理 agent create_agent( modelllm, system_promptsystem_prompt ) # 进行流式输出 for token, metadata in agent.stream( {messages: [HumanMessage(content-)]}, stream_modemessages, ): print(token.content, end, flushTrue)