LangGraph完整入门：运行一个可核对状态的两节点流程

01 先知道要做成什么

运行一个可核对状态的两节点流程。本篇只教一个能检查结果的首个任务，再扩展到真实工作；不把生成一次等同于专业交付。

02 官方入口、下载与安装

这是Python开发框架，不是下载安装后直接聊天的软件。先安装官方支持的Python，在空目录运行 python -m venv .venv；Windows运行 .venv\Scripts\activate，macOS/Linux运行 source .venv/bin/activate。随后 python -m pip install -U langgraph。下面先跑不调用模型的最小图。

03 账户、费用与准备

新建空目录，不在已有业务项目里练习；以下例子不需要账号或API key，只验证编排基础。 安装工具、下载模型、调用云服务可能分别计费。先查看官方要求与许可，密钥只存凭证设置或环境变量，不放提示词。

04 建立文件

新建main.py，把下面完整代码复制进去。只使用确定性加法，避免第一次就把模型配置问题和图问题混在一起。

05 运行最小图

在已激活的环境执行 python main.py；应看到结果中value为6。

06 理解数据流

输入2经过double变4，再经add变6；节点返回的是要更新的状态字段，边决定执行顺序。

07 再接真实模型

基础通过后再按官方Quickstart配置模型依赖和环境变量。工具执行必须设边界，持久化与人工暂停另做测试。

08 跟做材料／可复制示例

from typing_extensions import TypedDict
from langgraph.graph import StateGraph, START, END

class State(TypedDict):
    value: int

def double(s: State):
    return {"value": s["value"] * 2}

def add(s: State):
    return {"value": s["value"] + 2}

builder = StateGraph(State)
builder.add_node("double", double)
builder.add_node("add", add)
builder.add_edge(START, "double")
builder.add_edge("double", "add")
builder.add_edge("add", END)
print(builder.compile().invoke({"value": 2}))

09 保存、导出与交付

保留main.py和依赖版本；这只是编排练习，不冒充已建立智能体产品。

10 做完怎么验收

输入2输出6，改输入3输出8；可解释每个节点更新。 建议记录：输入、实际输出、是否通过、需修改的地方。先用一条正例和一条反例，确认后再扩大批量。

11 常见卡点与排查

ModuleNotFoundError先查虚拟环境和pip归属；有检查点恢复时注意节点可能重跑，外部写操作必须幂等。

12 使用真实资料前

先用本篇虚构样例练习，再替换成经授权并脱敏的材料。涉及账号、客户、商业和个人信息时先确认平台数据处理规则。对外发布前核对事实、权利和访问权限；官网界面更新时以官方帮助为准。

工具与原始资料

动手验证

继续解决相关问题