SuperAPI AI 工具集

agently-langchain-langgraph-migration-playbook

智能体与模型

查看项目

更新于 10-15 19:51

技能介绍

用途:这是一个迁移工作的顶层路由入口,适用于请求起点是已有的 LangChain 或 LangGraph 代码库、概念或架构,而非 Agently API 的场景。它帮助选择正确的迁移路径和对应的 Agently 技能组合,本身不替代具体实现技能。前提条件:Agently >= 4.0.8.5。

主要能力与范围:判断来源设计主要属于 LangChain 侧还是 LangGraph 侧;判断目标是保持单次请求、改为多智能体设计,还是改为 TriggerFlow 编排;选择正确的迁移技能与实施顺序;识别哪些部分可直接映射、哪些需要重新设计。

使用方式(工作流):先阅读 references/scenario-router.md 对来源系统分类;再阅读 references/migration-principles.md 确定迁移策略;然后阅读 references/current-skill-map.md 选择迁移技能或支持的 Agently 技能;最后切换到 agently-langchain-to-agently 或 agently-langgraph-to-triggerflow 执行实际迁移。

路由规则:LangChain 的 create_agent、tools、结构化输出、短期记忆、middleware、检索或服务暴露,路由到 agently-langchain-to-agently;LangGraph 的 StateGraph、节点/边/状态、interrupt、持久化、流式、子图或持久执行,路由到 agently-langgraph-to-triggerflow;若 LangChain agent 建立在 LangGraph 之上且真正复杂度在流程编排,则先走 agently-langgraph-to-triggerflow,再补充 agently-langchain-to-agently 处理 agent 内部;若来源项目在迁移中更适合简化而非逐行翻译,先使用本 playbook 再路由到更窄的迁移技能。

限制与边界:不适用于直接查询 Agently API 实现细节;不适用于孤立的 LangChain 或 LangGraph 特性且没有迁移设计问题的情况;不适用于并非从 LangChain 或 LangGraph 出发的通用业务设计。迁移不是逐行导入重写;部分 LangChain 或 LangGraph 抽象会映射到多个 Agently 技能而非单个 API;部分来源模式应折叠为更简单的 Agently 设计;应先做能力翻译,再重写实现。