SuperAPI AI 工具集

langgraph-subgraphs

通用与其它

查看项目

更新于 10-16 05:48

技能介绍

用途:帮助在 LangGraph 中把嵌套图组合成模块化、可复用的工作流组件,适用于构建子图、复用工作流组件或协调多智能体系统。

主要能力:提供两种子图模式。模式一“在节点中调用”:当子图需要完全隔离的状态时,在父节点函数中手动把父状态映射为子图输入,调用 analysis_subgraph.invoke(...),再把输出映射回父状态。模式二“直接添加为节点”:当父子共享状态键时,将已编译子图直接作为节点,例如 parent_builder.add_node("agent_team", agent_subgraph),用于消息传递与智能体协调。还说明多层嵌套(父-子-孙)可通过包装节点逐层调用实现。

使用方式:定义各自 StateGraph、add_node/add_edge、compile 后,选择上述两种嵌入方式之一;跨边界建议显式转换状态,并传播 config 以便追踪与检查点。检查点策略方面,推荐仅在父图传入 checkpointer(会自动传播到子图);若子图需独立历史,可对子图使用 compile(checkpointer=True)。流式查看子图可用 graph.stream(inputs, subgraphs=True, stream_mode="updates"),并按 namespace 深度打印;仅在被中断时可用 graph.get_state(config, subgraphs=True) 检查子图状态。

适用场景:多智能体系统、可复用工作流组件、递归或深层嵌套图、需要独立消息历史的智能体。

限制与错误:资料列出常见错误,包括未在边界转换状态导致 schema 不匹配、忘记传播 config 影响追踪与检查点、该隔离时误用共享状态、流式嵌套图时漏传 subgraphs=True。具体价格、平台与更多细节暂未提供。