PuppyIP 资源中心
开发接入 7 分钟 发布于 2026-11-13

AgentCore Runtime V2 新默认:旧实例迁移与文档差异

AWS 11月12日公告称,新建 AgentCore Runtime 在列出的19个区域默认使用 V2,旧实例保持原平台;当前开发指南却仍写 V1 默认,并只列出10个 V2 区域。先把这处来源差异与目标资源的实际平台分开,再决定是否迁移。

AgentCore Runtime V2 platformVersion 运行时迁移 AWS 区域 快照启动

服务对象与地域限制

PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。

代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。

本文要点

  • 公告中的默认变化针对新建运行时;现有运行时不会仅因公告而自动迁移。公告与当前指南的默认值、区域列表不一致,实际账号与目标区域仍需核对。
  • platformVersion 的 V1/V2 是启动平台;运行时配置的 version 1、version 2 是另一组不可变配置编号。
  • 迁移或新建时可以显式选择平台;只读 get-agent-runtime 查询可用于确认某个资源返回的 platformVersion。
  • V2 先准备已初始化环境的快照,创建或更新可能需要数分钟;首个健康 /ping 的时机影响快照内容。
  • AWS 的启动速度和计费内存数字属于特定示例,不能当作每个工作负载的延迟或总账单保证。

新默认覆盖哪里,为什么还要看文档差异?

AWS 于2026年11月12日宣布,Amazon Bedrock AgentCore 新建运行时默认使用下一代平台 V2,并列出19个已设为默认的 AWS 区域。与此同时,本次核对的 Runtime 平台版本开发指南仍称 V1 是默认值、创建时省略 platformVersion 会使用 V1,并只列出10个 V2 可用区域。这是两份当前官方来源的直接差异,不能据此确认每个账号或目标区域的实际行为。

公告列出的区域为:美国东部(弗吉尼亚北部、俄亥俄)、美国西部(俄勒冈)、加拿大(中部)、南美洲(圣保罗);欧洲(法兰克福、爱尔兰、伦敦、米兰、巴黎、西班牙、斯德哥尔摩);亚太(马来西亚、孟买、首尔、新加坡、悉尼、泰国、东京)。这是公告的清单,不等于我们逐个账号或区域验证过上线。

指南的10区清单则是弗吉尼亚北部、俄亥俄、俄勒冈、法兰克福、爱尔兰、斯德哥尔摩、孟买、新加坡、悉尼和东京。部署前应核对目标区域实际支持与资源返回值,避免仅依赖存在冲突的默认值说明。

旧实例需要主动迁移,两组版本号要分开

公告明确说明:现有运行时保持当前版本,直到使用者主动迁移。若决定切换,应在创建或更新运行时的相应配置中明确设置 platformVersion 为 V2;若要让新运行时继续使用上一代,公告给出的选择是 V1。这里描述的是配置方式,本文没有创建或更新任何 AWS 资源。

platformVersion 的 V1/V2 控制 AgentCore 如何准备和启动 agent。运行时的配置版本则记录容器映像、协议、网络等配置历史:新建资源从配置 version 1 开始,后续配置更新产生新的不可变版本。使用 V2 平台的新运行时仍可以是配置 version 1。

AWS CLI 文档展示的显式选择参数是 --platform-version V2。对更新请求,指南说明省略 platformVersion 会保留当前平台;但对新建请求,指南与新公告的默认值说法不一致,因此应把需要的平台写清楚。

先用只读查询确认单个资源的平台

官方 CLI 的查询形式为:aws bedrock-agentcore-control get-agent-runtime --agent-runtime-id YOUR_RUNTIME_ID --query platformVersion。YOUR_RUNTIME_ID 是示例占位符,应替换成自己获授权访问的资源 ID;在正确账号和区域下,该查询读取资源返回的 platformVersion,不会创建或更新运行时。

本文没有执行命令,也没有访问 AWS 账号或确认任何资源状态。某个资源返回 V1 或 V2,也不能单独证明其他账号、其他区域的默认值或资格。把目标资源的平台值、配置版本与区域一起核对,才能避免把版本编号或区域差异混在一起。

V2 创建更久,要等初始化与健康检查完成

V2 先准备已初始化环境的快照,再从快照恢复新会话。公告说明,每个会话仍在独立、硬件隔离的 Firecracker microVM 中运行,空闲 agent 可缩至零;会话最多扩展至8 vCPU、32 GB 内存,容器映像最大10 GB。

开发指南提醒,V2 的创建和更新会因一次性的快照准备时间开销持续数分钟;这里不是已核实的一笔独立收费。AgentCore 在首个健康 /ping 响应时获取快照,因此应在初始化完成后才报告健康。若容器在启动后120秒内未报告健康,创建会因健康检查错误失败。

创建或更新接口返回时,状态可能仍是 CREATING 或 UPDATING。应通过 GetAgentRuntime 读取状态,等到 READY 或以 FAILED 结束的失败状态后,再进行下一次操作;提前再次更新或删除可能返回 ConflictException。不要把“请求已返回”当作“运行时已就绪”。

更快启动与内存下降,不等于固定节省比例

AWS 公告给出的性能例子是:2 GB 容器映像的会话启动时间在 P75(75百分位)低于2秒,上一代为29.7秒;多轮 agent 场景的每会话计费内存最多减少68%。公告还说明,释放的内存会在数分钟内回收。这些数字有其映像、指标和场景范围,不是我们对实际工作负载的测试。

“每会话计费内存最多减少68%”不能改写成“总账单减少68%”。本文没有核实具体费率、账户折扣或其他 AWS 服务费用。迁移预算应按自己的使用方式与适用价格核对,而不是用公告中的最大变化直接预测应付金额。

迁移前先列清楚要确认的三件事

第一,明确目标账号、区域与需要的平台;遇到公告和指南差异时,显式选择平台并确认目标资源实际返回值。第二,分别记录平台版本与配置版本,检查初始化是否能按时报告健康,并给 V2 的快照准备预留数分钟。

第三,用自己的获授权环境评估兼容性、启动时间和费用,再决定后续发布安排。运行时平台更新不会代替 IAM 权限或区域资格核验;更换代理出口也不能获得平台资格、改变计费规则或证明某个区域已经上线。

资料来源

常见问题

更新后旧快照会立即删除吗?

不一定。指南说明,当没有端点再指向快照时,AgentCore 才会删除它;已使用该快照运行的会话会继续到结束,因此删除可能最多需要8小时。这是快照清理的行为,不能据此承诺立即释放全部相关费用。

更新运行时会影响 DEFAULT 端点指向吗?

开发指南说明,更新运行时配置时,DEFAULT 端点会自动指向最新配置版本。自定义端点可以引用指定版本,用于控制发布安排。应核对现有端点引用;不能把平台版本选择当成对所有调用均无影响的承诺。