SuperAPI AI 工具集

langgraph

智能体与模型

查看项目

更新于 10-16 03:13

技能介绍

用途:该技能用于设计、实现和调试 LangGraph 工作流,强调显式状态契约、确定性路由和健壮的 interrupt 处理。当任务涉及图节点/边、条件路由、检查点、线程状态或 HITL 中断时使用。若任务主要是提示/工具链组合而无图级编排,改用 $langchain;若为与前端客户端的协议级事件同步,改用 $ag-ui;若为 CopilotKit 的 provider/hooks/共享状态 UI 集成,改用 $copilotkit。

工作流程:先定义状态 schema,只保留路由、重试和输出所需字段;定义节点契约,每个节点单一职责并明确输入输出假设;定义边与路由器,在实现节点内部逻辑前映射所有正常、重试和终止路径;添加持久化策略,尽早选定检查点配置与线程身份契约;添加中断策略,定义人工审批位置及恢复载荷解析方式;编译并可视化,在运行大规模测试前验证图形状;用场景测试验证,覆盖通过、重试、跳过和最大重试终止路径。

默认模式:路由谓词保持纯函数、无副作用;节点输出显式且最小化;验证与生成使用独立节点以降低耦合;按失败类别(可恢复与终止)路由,而非笼统的“error”。

失败模式:隐式状态变更导致路由漂移;无上限或无回退出口的重试循环;后端与 UI 之间中断载荷不匹配;缺少线程/检查点身份导致流程不可复现。

参考映射:按当前子任务按需加载。图设计模式见 references/graph-design-patterns.md;状态与检查点见 references/state-and-checkpointing.md;HITL 中断见 references/hitl-interrupts.md;调试手册见 references/debugging-playbook.md。