langgraph-graph-api

npx skills add majiayu000/claude-skill-registry --skill langgraph-graph-api --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# langgraph-graph-api (JavaScript/TypeScript) --- name: langgraph-graph-api description: 使用 StateGraph、节点、边、START/END 节点和 Command API 构建图，结合控制流与状态更新 --- ## 概述 LangGraph Graph API 允许您将 Agent 工作流定义为由**节点**（函数）和**边**（控制流）组成的有向图。这提供了对 Agent 编排的细粒度控制。 **核心组件：** - **StateGraph**：构建有状态图的主要类 - **节点**：执行工作并更新状态的函数 - **边**：定义执行顺序（静态或条件） - **START/END**：标记图入口和出口点的特殊节点 - **Command**：结合状态更新与动态路由 ## 决策表：边类型 | 需求 | 边类型 | 何时使用 | |------|-----------|-------------| | 始终转到同一节点 | `addEdge()` | 固定、确定性流 | | 基于状态路由 | `addConditionalEdges()` | 动态分支逻辑 | | 扩散到多个节点 | `Send` API | Map-reduce、并行执行 | | 更新状态并路由 | `Command` | 在单个节点中组合逻辑 | ## 核心概念 ### 1. 图执行模型 LangGraph 使用受 Google Pregel 启发的**消息传递**模型： - 执行以**超级步**（离散迭代）进行 - 并行节点属于同一超级步 - 顺序节点属于不同的超级步 - 当所有节点不活跃且没有消息在传输时，图结束 ### 2. 节点 **节点**是异步函数，它们： - 接收当前状态作为输入 - 执行计算或副作用 - 返回状态更新（部分或全部） ```typescript const myNode = async (state: State): Promise<Partial<State>> => { // 节点只是异步函数! return { key: "updated_value" }; }; ``` ### 3. 边 | 边类型 | 描述 | 示例 | |-----------|-------------|---------| | **静态** | 始终路由到同一节点 | `addEdge("A", "B")` | | **条件** | 基于状态/逻辑路由 | `addConditionalEdges("A", router)` | | **动态 (Send)** | 扩散到多个节点 | `new Send("worker", {...})` | | **Command** | 状态更新