文档中心

AgentKit

请输入

进阶入门：存量 Agent 迁移

存量 Agent 迁移概述

能力概述

agentkit migrate 是一条命令行迁移链路，用于把客户已有的 Agent 项目转换成可在 AgentKit 平台部署、调用的标准应用。

它能够解决的问题：

存量 Agent 用各种框架和平台构建，运行入口、协议、会话模型、可观测各不相同，无法直接进入 AgentKit 云端运行。

迁移的边界：

AgentKit 统一接管服务入口、协议、部署配置、会话上下文和可观测，原有业务编排和执行模型保持不变。

迁移后的应用默认对外提供 AgentKit 协议 /run、/run_sse、session 和 A2A，即同一份业务逻辑无需重写即可获得云端部署、统一鉴权和链路追踪能力。

迁移能得到什么：

统一运行入口：所有框架收敛到 AgentkitAgentServerApp（AgentKit 框架），对外协议一致。

零业务改写：原 Agent、Graph、工具、模型调用逻辑保留，迁移只在旁侧生成承载层或按语义重建。

云端可部署：生成 deploy 部署配置、Dockerfile 和迁移计划，agentkit deploy 后即可使用 invoke调用。

默认可观测：产物默认接入 AgentKit runtime 的 OTel / APMPlus 采集，请求 span 与 bridge span 串在同一条 trace。

支持迁移的框架

迁移工具按「是否有可加载的框架源代码」把存量项目分成两类。高代码框架在本地生成接入层，低代码平台走远端 sandbox 重建。

框架	迁移方式	入口形态（--entry）	迁移说明
LangChain	高代码	file.py:object	兼容 Runnable、LCEL 编排、Agent 执行器全能力；原有 LangServe 接口无需改造，启动时加 --compat langserve 即可兼容旧调用端。
LangGraph compiled graph	高代码	graph.py:graph	适合已经写好 Graph 流程图的项目。默认直接兼容标准对话消息结构（messages state）；自定义 state 字段用 --input-key，指定流式节点用 --stream-node。
LangGraph Server	高代码	langgraph.json[:graph_id]	官方 LangGraph 线上服务项目，启动需追加 --server-mode langgraph。迁移后服务同时支持原生 LangGraph 接口（/threads、/runs/stream）、AgentKit 标准双协议，原有业务调用不受影响
ADK	高代码	agent.py:root_agent	原生 ADK 智能体无缝迁移，无需中间转换层。完整保留原有工具（ADK tools）、回调函数（callbacks）、子智能体调度逻辑（sub-agent），最终部署为标准 AgentKit 线上服务。
Strands	高代码	agent.py:build_agent	推荐使用零参数 factory 工厂函数作为程序入口 entry。迁移后每个对话会话 session 独立创建智能体实例 Strands agent，避免多用户对话之间状态错乱、数据互相干扰。
Bedrock AgentCore	高代码	app.py:app	项目已使用 Bedrock 官方服务框架（BedrockAgentCoreApp）时选用。迁移后同时提供 AgentKit 标准接口，保留原健康检测（/ping）、调用（/invocations）接口，不会替换原有 Bedrock AgentCore Runtime 完整平台能力。
Dify	低代码	远端 create / status	无需大量改代码，上传 Dify 工作流（workflow） / 对话流（chatflow）配置文件，工具自动解析提示词（prompt）、模型、工具配置，一键生成完整 VeADK 工程、配套测试用例与迁移说明文档。
any（任何 Agent 框架）	低代码	远端 create / status	通用兜底迁移方案，适合任意有源码的 Agent 项目。Codex 自动分析现有项目代码，按照 VeADK 最佳实践重建整套工程，同步自动生成批量测评用例，降低人工改造工作量。

最近更新时间：2026.07.28 19:37:05

这个页面对您有帮助吗？

有用

无用