AgentKit Studio
任务指南

部署到云端

把构建成功的版本部署成常驻云端实例:选规格、跑部署检查、确认创建,并读懂部署状态与未确认结果的处理动作。

部署到云端(cloud deployment)把一个构建成功的冻结版本变成 7×24 常驻的托管运行时实例。 实例有独立 ID、规格和持久化存储,删除重建后会话历史仍保留。

前置条件

  • 至少一个 本地创建的 Agent,且已有 SUCCEEDED 的构建版本。
  • 已配置子账号 AK/SK。主账号不能创建云端资源。
  • 已连接 AgentEngine Server;未连接时部署区会提示「云端发布不可用」,此时只能导出运行包。

操作步骤

打开构建与部署

运行中心 → 构建与部署。页面顶部是三步编号:

步骤编号说明
构建1冻结当前提示词、模型和资源绑定
部署2创建或更新云端实例
云端实例3部署记录与操作

没构建成功时第 2 步是暗色的,提示「构建成功后可以部署」。

选中 Agent 与构建版本

  1. 右上角「目标 Agent」选择器里挑一个。
  2. 在「冻结版本」下拉里选一个 SUCCEEDED 的版本——失败的版本不可选。

只有最新构建的版本能直接部署

当前配置的 revision 与最新成功构建不一致时,第 1 步会提示「配置已更新到 r<n>」。 先重新构建,否则部署出去的仍是旧配置。

选择部署目标

「部署到」下拉有两个选项:

选项行为
更新「<实例名>」的当前实例复用现有实例 ID、规格和存储,只切换冻结版本
创建新的云端实例按下面选的规格新建,产生新的实例 ID 和新的账单

更新已有实例时,「运行镜像」是一个开关:「使用当前推荐的运行镜像」。关掉它才能指定别的镜像版本。

选择实例规格

创建新实例时选规格,比例必须是 1:2、1:4 或 1:8:

分组(比例)可选核数举例
通用 · CPU / 内存 1:21 / 2 / 4 / 8 / 16 核默认 2 核 → 4 GB
更多内存 · 1:41 / 2 / 4 / 8 / 16 核2 核 → 8 GB
更多内存 · 1:81 / 2 / 4 / 8 / 16 核2 核 → 16 GB

更新已有实例时规格是只读的,显示当前值。

确认对话存储

存储固定 20 GiB 持久化云盘,挂载在运行容器的 /home/node。Agent 状态、会话历史和工作区都在这个目录下,实例重建后仍然保留。

按天计费,删除前先备份

云盘按天计费。删除实例前请先备份需要留下的历史——删除后这份目录不会回来。 不再提供「临时存储」选项:那个选择只会改变每天的账单,还会在实例重建时静默丢掉会话历史。

跑部署检查

点 检查部署(更新实例时是 检查更新)。检查是只读的,不会创建任何云端资源,返回一屏「部署检查结果」:

行内容
部署位置环境(pre-online 显示为「预发环境」)· 区域
实例规格CPU 核数 / 内存 GB · 1 个实例
对话存储20 GiB · /home/node
运行时运行时类型 · 当前镜像版本
目标运行镜像镜像版本 · digest —— 升级前要核对的部署身份
已绑定资源N 个模型 · N 个 MCP · N 个 Skill · N 个云端资源
操作人子账号用户名或「主账号」

检查同时验证三件事:冻结版本、资源凭证、部署位置与配额。任何一项不通过,检查就失败,不会走到确认按钮。

下面的警告不要跳过,它们是计费和不可逆操作提示,例如「单副本按所选规格创建;费用以平台实际计费为准」。

确认创建

点 确认创建云端实例。提交后提示「部署已提交,进度会自动更新」,记录出现在第 3 步。

提交结果未确认时不要新建

如果提示「提交结果未确认,请保留当前页面并核对部署记录」,不要刷新后重试创建。 到第 3 步对那条记录点 核对创建结果,用同一个请求标识对账;重复提交会真的多出一个实例。

部署状态:你该关心的 10 个

列表每 5 秒自动刷新一次;页面切到后台时暂停轮询。状态值共 19 个,日常只需要认这 10 个:

状态界面文案含义你要做什么
PREPARED待提交部署记录已生成,还没提交不需要操作
UPLOADING上传运行包正在上传冻结运行包等待
CREATING创建中平台正在创建云端 Agent等待
PROVISIONING准备实例实例已创建,正在准备等待
CONFIGURING配置访问令牌正在写入访问令牌等待
TOKEN_PENDING等待配置生效令牌已写入,等生效超过一两分钟仍是这个状态,用 修复访问配置
STARTING启动中入口已就绪,等版本探测通过等待
READY就绪实例可用点 开始对话
ACTION_REQUIRED需要处理需要人工介入,实例可能仍在运行看「详情」里的失败码再决定
FAILED失败创建失败看「详情」里的 code 与 message

其余状态按需查:UPLOADED(已上传,等创建)、AVAILABLE_UPDATING(入口可用但平台在更新,可以对话,别在这时升级)、DELETING(删除中)、DELETED(已删除,需打开「显示已删除」才看得到)。

*_UNKNOWN 状态怎么处理

带 _UNKNOWN 后缀的四个状态表示平台没有确认上一次写操作的结果。它们不会自己往前走,必须人工对账:

状态界面文案处理动作
UPLOAD_UNKNOWN上传结果待核对点 核对创建结果;确认包已上传后由平台继续创建
CREATE_UNKNOWN创建结果待核对点 核对创建结果。绝对不要重新创建——对账会认领已经创建出来的实例
UPDATE_UNKNOWN更新结果待核对点 刷新状态 触发版本探测;探测通过会自动落到 READY
DELETE_UNKNOWN删除结果待核对点 刷新状态;云端已不存在时会自动落为 DELETED

这四个状态和 ACTION_REQUIRED、FAILED、TOKEN_PENDING 一起算「需要处理」。别的 Agent 有待处理记录时,列表顶部会提示「其他 Agent 有 N 条部署需要处理」,点 查看全部 切到全部范围。

成功后的样子

  • 记录行状态是 READY,色调为绿色。
  • 行内出现 开始对话(READY 和 AVAILABLE_UPDATING 才有)。
  • 展开「详情」能看到:云端 Agent、运行时、运行镜像(含 digest)、构建版本、对话存储。
  • 点 日志 能拿到运行日志;没有日志时显示「暂无日志」。

常见错误

错误码原因处理
CLOUD_SUBACCOUNT_REQUIRED当前身份不是已核验的子账号,或子账号与部署记录不符到设置里更新云端凭证;不会改用主账号创建资源
DEPLOYMENT_AGENT_UNSUPPORTED目标不是本地创建的 Agent Build只部署本地创建的 Agent
DEPLOYMENT_RESOURCE_INVALIDCPU / 内存比例不是 1:2、1:4 或 1:8从规格下拉里选
DEPLOYMENT_TYPE_INVALID部署类型无效用界面发起部署,不要手拼请求
KS3_BUCKET_REQUIRED无法确定账号默认存储桶核验云端身份,或在高级设置里指定 KS3 Bucket
MCP_CREDENTIAL_MISSING绑定的 MCP 缺有效凭证补齐 MCP 凭证后重新检查
DEPLOYMENT_ENV_CONFLICT多个 MCP 生成了冲突的凭证环境变量去掉重复的 MCP 绑定
MANAGED_RUNTIME_MODEL_INVALID运行包缺少默认模型回到 Agent 里指定模型并重新构建
DEPLOYMENT_ACCOUNT_CHANGED云端凭证或环境与部署记录不同切回原配置后再管理该记录
DEPLOYMENT_CREATE_UNCONFIRMED创建结果尚未确认先 核对创建结果,不要重新创建
DEPLOYMENT_PROVENANCE_MISMATCH云端 Agent 与冻结部署记录不一致停止管理操作,核对云端实例来源
DEPLOYMENT_RECORD_CORRUPT本机部署记录损坏保留文件并核对云端结果,不能重新提交创建

相关参考

本页导航