跑通 LangGraph：用一个最小示例理解 State、消息流转和流程图

在开始使用 LangGraph 时常见的痛点包括：

• 也不知道该如何定义。按理说，
• 对节点到底是做什么、怎么返回状态一头雾水。
• 想快速看到执行结果，却不知从哪里入手。
• 想把流程图可视化，但不知道怎么导出。

先看效果

运行后终端会输出类似下面的内容：

{'messages':,'extra_field': 0}
================================ Human Message =================================
你好？================================== Ai Message ==================================
你好，我是一个节点

对应的流程图比较简单：

完整代码

from langchain_core.messages import AnyMessage,AIMessage,HumanMessage
from typing_extensions import TypedDict
from langgraph.graph import StateGraph
# 图里传递的数据结构
class State:
# 消息列表
messages: list
# 示例字段
extra_field: int
# 节点函数：处理状态并返回更新后的状态片段
def node -> dict:
messages = state
new_message = AIMessage
return {
"messages": messages +,"extra_field": state.get + 1。}
# 创建图，并指定状态结构
graph = StateGraph
# 加入节点
graph.add_node
# 指定入口点
graph.set_entry_point
# 编译图以便执行
graph_builder = graph.compile
# 执行图，传入初始 state
result = graph_builder.invoke({
"messages":,"extra_field": 0,})
print
# 打印每条消息，便于查看谁说了什么
for message in result:
message.pretty_print
# 导出 Mermaid PNG 并保存为 graph.png
png_bytes = graph_builder.get_graph.draw_mermaid_png
with open as f:
f.write

代码拆解 & 痛点方法

. State 是状态定义

T.TypedDict 用来声明字典结构。 这里的 State 表示在节点之间传递的数据：

• messages: 消息列表，存储使用者与模型的交互。
• extra_field: 示例字段，用于演示如何携带额外信息。

. node: 一个最小处理单元

Nodel 做了两件事：

• 读取当前状态中的消息列表。
• 追加一条新的 AI 消息，并更新额外字段。

. 创建图：StatusGraph

This line tells LangGraph that our graph will carry a state of type Status.

. 指定入口：.set_entry_point

The graph starts execution at node named “node”. If you have multiple nodes,you can chain m here.

. 执行：.invoke

You pass an initial state;here we include a user greeting so you can see how message flows.

. 打印消息：.pretty_print

This helper prints each message line‑by‑line so you can distinguish who said what.

. 可视化：.draw_mermaid_png

The generated PNG shows your workflow graphically—great for debugging and documentation.

最终输出解析与痛点回归检查

The program’s console output looks like this:

{'messages':,'extra_field': 1}
================================ Human Message =================================
你好？================================== Ai Message ==================================
你好，我是一个节点

• The first line is final state after graph runs.
• The subsequent blocks are produced by .pretty_print。showing each message separately.
• You can verify that:

• User input “你好？” appears first.
• The node appends an AI reply “你好，我是一个节点”. The extra field increments from 0 to 1.

  & 接下来建议

  • A single node + one-state cycle already covers: