1. Functional API 解决什么问题

前面的文章使用 StateGraph 组织工作流：先定义状态，再注册节点和边，最后调用 compile()。这种方式会把流程图完整地展示出来，分支、循环、并行关系都容易定位。

LangGraph 还提供了 Functional API。它保留普通 TypeScript 函数的写法，用 entrypoint() 声明工作流入口，用 task() 标记需要被 LangGraph 跟踪的步骤。条件判断、循环和并行任务继续使用 if、for 和 Promise.all()。

1
Graph API
2
StateGraph → addNode → addEdge → compile
3

4
Functional API
5
task → entrypoint → invoke / stream

两种 API 运行在同一个 LangGraph 运行时中，都可以使用 Checkpointer、流式输出、中断和恢复。区别在于：Graph API 把流程结构写在节点和边上，Functional API 把流程结构写在普通函数的调用顺序里。

如果流程需要经常查看节点关系，Graph API 更直观；如果已有一段顺序清楚的 TypeScript 业务代码，希望增加重试、恢复和持久化，Functional API 通常更容易接入。