> ## Documentation Index
> Fetch the complete documentation index at: https://docs.veadk.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# 迁移已有智能体

`migrate` 命令将已有的 LangChain、LangGraph、ADK、Strands 或 Bedrock AgentCore 智能体封装为 AgentKit 应用：生成通过 AgentKit 智能体服务对外提供服务所需的文件，而无需重写原有智能体。命令会打印本次迁移计划——新建或更新的文件、依赖变更以及可能的告警——便于在部署前审阅。加 `--dry-run` 只打印计划、不写入任何文件。

## migrate

将已有智能体封装为 AgentKit 应用。

| 标志/参数 | 说明 | 默认值 |
| - | - | - |
| `[project-dir]` | 源项目目录。 | 当前目录 |
| `--framework <name>` | 源框架：`langchain` \| `langgraph` \| `adk` \| `strands` \| `agentcore`。必填。 | — |
| `--entry <file.py:object\|langgraph.json[:graph_id]>` | 要封装的 Python 对象；使用 LangGraph Server 模式时也可指定 `langgraph.json` 与可选的图 ID。必填。 | — |
| `-n, --name <name>` | AgentKit 应用名称。 | 项目目录名 |
| `-o, --output <dir>` | 生成文件的写入目录。 | 项目根目录 |
| `--input-key <key>` | 读取用户输入所用的自定义 LangChain dict / LangGraph state 字段；标准 LangGraph messages 可省略。 | — |
| `--stream-node <node>` | 指定向 `/run_sse` 输出事件的 LangGraph 节点。可重复传入。 | — |
| `--compat <profile>` | 额外暴露服务兼容路由：`langserve` \| `fastapi-mount`。 | 不启用 |
| `--compat-prefix <path>` | 将兼容路由挂载到此路径。 | 取决于所选 profile |
| `--legacy-app <file.py:app>` | 要挂载的已有 FastAPI 应用；仅在 `--compat fastapi-mount` 时有效。 | — |
| `--model-id <id>` | 启用目标模型替换，并指定火山方舟模型 ID。 | — |
| `--model-base-url <url>` | 目标模型替换使用的火山方舟或 OpenAI 兼容 Base URL。 | — |
| `--model-api-key-env <name>` | 保存火山方舟 API Key 的环境变量名称。 | — |
| `--server-mode <mode>` | 保留 LangGraph Server 应用；当前仅支持 `langgraph`。省略时生成默认 AgentKit 应用。 | — |
| `--allow-blocking` | 在 LangGraph Server 模式下放宽阻塞 I/O 检查。 | `false` |
| `--verify` | 导入生成的应用并执行本地端点检查。 | `false` |
| `--dry-run` | 只显示迁移计划，不写入任何文件。 | `false` |
| `-f, --force` | 生成文件已存在时覆盖。 | `false` |
| `--json` | 以 JSON 打印迁移计划。 | `false` |

```bash lines theme={null}
# LangChain 智能体 → AgentKit 应用
agentkit migrate . --framework langchain --entry agent.py:agent --name support-agent

# 仅预览计划，不写入任何文件
agentkit migrate . --framework langgraph --entry graph.py:agent --input-key question --dry-run

# 指定由 /run_sse 输出事件的 LangGraph 节点，并验证生成结果
agentkit migrate . --framework langgraph --entry graph.py:agent --stream-node chatbot --verify

# 在 AgentKit 应用之外继续保留已有的 LangServe 或 FastAPI 服务
agentkit migrate . --framework langchain --entry agent.py:agent --compat langserve
agentkit migrate . --framework langchain --entry agent.py:agent --compat fastapi-mount --legacy-app api.py:app

# 保留 LangGraph Server 原生路由
agentkit migrate . \
  --framework langgraph \
  --server-mode langgraph \
  --entry langgraph.json:lead_agent \
  --allow-blocking

# 将目标模型替换为火山方舟模型；API Key 从指定的环境变量读取
agentkit migrate . \
  --framework agentcore \
  --entry deploy/agentcore/app.py:app \
  --model-id doubao-seed-2-1-pro \
  --model-api-key-env MODEL_AGENT_API_KEY

# ADK 智能体
agentkit migrate . --framework adk --entry agent.py:root_agent

# Strands 智能体
agentkit migrate . --framework strands --entry agent.py:build_agent
```