LangGraph：定位、第一个图与两种 API

LangGraph 适合需要显式阶段、条件分支、循环、并行、中断或恢复的执行过程。简单的一次模型调用不一定需要图；图的价值来自可控制和可观察的流程。

Graph API 使用 StateGraph 声明状态 Schema、节点和边，编译后再执行。Functional API 使用任务和入口点把持久化与流式能力加入普通函数式代码。两者共享运行时能力，可以按团队习惯选择，也可在系统中组合。

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

class State(TypedDict):
    text: str

def normalize(state: State):
    return {"text": state["text"].strip()}

builder = StateGraph(State)
builder.add_node("normalize", normalize)
builder.add_edge(START, "normalize")
builder.add_edge("normalize", END)
graph = builder.compile()

编译会检查图结构并绑定 Checkpointer、中断点等运行参数。定义图并不自动获得数据库持久化或长期记忆。

官方入口：概览、Graph API、Functional API。