LangGraph 1.x 为长期支持(LTS)版本,该技能汇集构建生产级 LangGraph 工作流的分模块规则,每个类别在 rules/ 下按需加载独立规则文件。
用途:为多节点智能体工作流提供状态与容错设计参考。状态管理含 TypedDict、Pydantic、MessagesState、自定义 reducer 及 DeltaChannel;容错含节点超时(timeout= 接受 float、timedelta 或 TimeoutPolicy,区分 run_timeout 与 idle_timeout,超时抛 NodeTimeoutError 并交给重试策略,基于 asyncio 取消,阻塞 GIL 的节点不会被中断)、错误处理器(error_handler= 注册恢复节点,接收 NodeError 并返回 Command)与 RunControl 优雅排空(request_drain + runtime.drain_requested,在检查点边界停止)。
主要能力:路由与分支(条件边、重试循环、语义路由、跨图导航)、并行执行(Send API 扇出扇入、map-reduce、错误隔离)、监督者模式、工具调用(bind_tools、ToolNode、动态选择、interrupt 审批)、检查点(MemorySaver 开发、PostgresSaver 生产、跨线程 Store)、节点级缓存(CachePolicy + SqliteCache/RedisCache)、延迟节点(defer=True)、模型中间件(before_model/after_model)、人机协同、流式(含 version="v2" 类型安全流式)、子图与函数式 API(@entrypoint/@task)、平台部署(langgraph.json、RemoteGraph、double-texting)。
用法要点:内部用 TypedDict、边界用 Pydantic;入口用 add_edge(START, node) 而非已弃用的 set_entry_point();同时更新状态与路由用 Command API;累加器用 Annotated[list[T], add];create_react_agent 自 v1.0 弃用,改用 langchain.agents 的 create_agent。
限制:DeltaChannel 与部分能力为 beta;缓存不适用于依赖时钟或可变外部状态的节点;每智能体工具建议 5–10 个,并发分支 5–10;常见错误含缺少 reducer、原地修改状态、无 END 兜底、无限重试、用 try/except 包住 interrupt() 等。测试用例见 test-cases.json。