SuperAPI AI 工具集

framework-selection

智能体与模型

查看项目

更新于 10-15 23:48

技能介绍

用途:这是 LangChain 官方技能,应在任何 LangChain/LangGraph/Deep Agents 项目开始时、编写智能体代码之前加载,用于确定应使用哪一层框架。所选框架决定后续应调用哪些技能。

三层结构:Deep Agents 为最高层,内置规划、记忆、技能与文件能力;LangGraph 负责编排,提供节点、边、状态与持久化;LangChain 是基础层,提供模型、工具、提示词与 RAG。选择高层不会切断低层能力,可在 Deep Agents 内使用 LangGraph 图,也可在两者内使用 LangChain 原语。

决策顺序:任务是否需要拆分子任务、跨长会话管理文件、持久记忆或按需加载技能?是则选 Deep Agents。否则是否需要复杂控制流,如循环、动态分支、并行 worker、人工介入或自定义状态?是则选 LangGraph。否则是否为接收输入、运行工具并返回结果的单一用途智能体?是则选 LangChain(create_agent)。否则是否为无智能体循环的纯模型调用、链或检索管道?是则选 LangChain(chain)。

各层适用与限制:LangChain 适合固定工具集的单一用途智能体、RAG 与文档问答、模型调用与输出解析、简单原型;不适合需多步规划、跨会话持久状态或条件迭代控制流的场景。LangGraph 适合分支或循环、多步工作流、人工审批、并行扇出/扇入、会话内持久状态;不适合希望由框架代管规划、文件与子智能体委派的场景。Deep Agents 适合长任务待办拆分、跨会话文件读写、子智能体委派、按需加载技能、跨会话持久记忆;不适合简单任务或需精确手工控制每条图边的场景。

Deep Agents 内置中间件:TodoListMiddleware(write_todos,默认开启)、FilesystemMiddleware(ls、read_file、write_file、edit_file、glob、grep,默认开启)、SubAgentMiddleware(task,默认开启)、SkillsMiddleware(按需加载 SKILL.md,需启用)、MemoryMiddleware(跨会话长期记忆,需启用)、HumanInTheLoopMiddleware(敏感工具调用前请求人工批准,需启用)。

混合使用:Deep Agents 编排器可调用 LangGraph 子智能体;LangGraph 编译图可作为子智能体注册进 Deep Agents;LangChain 工具、链与检索器可在两层内自由使用。注意 LangGraph 没有中间件概念,行为需直接写入节点与边。

后续技能:LangChain 对应 langchain-models、langchain-rag、langchain-middleware;LangGraph 对应 langgraph-fundamentals、langgraph-human-in-the-loop、langgraph-persistence;Deep Agents 对应 deep-agents-core、deep-agents-memory、deep-agents-orchestration。