AgentCore Runtime V2 升级前:先核清运行时契约再迁移代理
AgentCore Runtime V2 不是新服务,而是已有 runtime 上的 platformVersion 字段切换,主要变化在内存按需分页与快照式冷启动。迁移前应先核对三件事:版本字段与数分钟的变更窗口、/ping 必须在 120 秒内报告健康且需在初始化完成后才报、以及内存可被回收对状态存放位置的影响。博客给出的 P75 冷启动约 2 秒来自团队测试,不是本文实测;单价、区域清单与承诺折扣定价仍需按官方文档核实。
如果只问一句“V2 要不要迁”,答案取决于三件事:你的镜像有多大、容器多快能真正就绪、部署流水线能不能容忍一次持续数分钟的变更。AWS 在 2026 年 11 月 9 日的周报里公布了 AgentCore Runtime 的新版本,但那是周报级摘要——够判断方向,不够直接写迁移方案。动手前应拿官方 V2 文档逐项核对运行时契约。本文没有创建或调用任何 runtime,下面的性能数字全部来自该周报转述的团队测试,不是本文实测。
材料能确认的变更点#
根据 AWS News Blog 的周报,V2 改了两件事,其余是入口方式的变化:
- 内存模型:会话从小内存起步,按需换入更多内存,冷下来时把内存归还,而不是一直占着峰值,因此按 agent 实际用量计费。
- 冷启动:AgentCore 把环境准备一次并做快照,之后每个新实例从快照恢复,而不是每次重新初始化。
- 开启方式:在创建或更新 runtime 时把
platformVersion设为V2。周报的原话是“a single field on the runtime you already have”,也就是同一资源上的字段切换,不是另开一个新产品。
这三点是来源事实。由此可以推出一条工程判断(推断):迁移的主要工作量不在业务逻辑,而在部署流程和就绪判定——因为它们决定了你能不能安全地做一次“字段变更”。
迁移前必须核清的三类契约#
1. 版本字段与变更窗口
周报明确说,创建和更新都需要数分钟,因为要准备快照。这带来两个直接后果:
- 部署流水线的超时、重试和并发锁要按“分钟级”重设。如果 CI 默认 60 秒超时并自动重试,一次更新可能变成多次排队更新。
- 回滚路径要提前想好:把
platformVersion改回旧值是否同样需要数分钟,材料未说明,属于待核实项。不要假设回滚是瞬时的。
2. /ping 的 120 秒窗口
周报给出的约束是:容器必须在 120 秒内通过 /ping 报告健康,并且“只在初始化完成后才报告健康”。这一句是整篇材料里最容易踩坑的地方,因为它把两个状态拆开了——进程活着,不等于依赖就绪。
常见的错误写法是 HTTP 服务器一起来就返回 200,模型权重、数据库连接池、下游凭证都还没准备好。在旧运行时下这可能只是偶发超时,在 V2 下会直接决定实例能否进入可用状态。
需要说明边界:材料没有给出 /ping 的响应体格式、非 200 状态码是否被接受、以及 120 秒从哪个时刻开始计。这三点必须查官方文档,本文不猜。
3. 内存可回收对状态位置的影响
“冷下来就归还内存”是计费优化的来源,同时也是一条架构约束(推断):任何放在进程内存里的东西都可能在某次冷却后消失。会话状态、去重缓存、token 缓存如果只存在内存里,就要重新评估——要么接受丢失,要么外置到数据库或缓存服务。这一点材料只描述了机制,没有给出冷却判定条件,具体阈值待核实。
冷启动数字怎么读#
周报转述的团队测试结果如下。这是 AWS 团队的测试,不是本文实测;测试的并发数、区域、镜像内容均未在材料中给出。
| 指标 | 原运行时 | V2 | 性质 |
|---|---|---|---|
| P75 冷启动(200 MB 至 2 GB 镜像) | 随镜像增大从约 5.4 秒升至近 30 秒 | 维持约 2 秒 | 团队测试,转述 |
| 单位价格 | 较低 | 较高 | 来源事实 |
| 账单总额 | — | 团队预计多数 agent 更低,但不保证 | 预期,非承诺 |
两点使用建议:其一,P75 是分位数,意味着仍有四分之一的实例慢于该值,SLO 不要直接按 2 秒写。其二,“多数 agent 账单更低”是把单价与 GB-hours 相乘后的预期,AWS 自己用了“expects”和“isn’t guaranteed”。要判断自己是否属于受益方,只能用自己的镜像大小和内存曲线估算,材料不足以给出通用结论。
一个最小就绪端点示例(未执行)#
下面只是示意“健康检查与初始化分离”的写法,未在 AgentCore 上运行过,也不代表官方推荐的响应格式。语言为 Python,环境假设为自建 HTTP 服务。
# 未执行的示例:仅示意就绪标记与 /ping 分离
import threading
from http.server import BaseHTTPRequestHandler, HTTPServer
ready = threading.Event()
def initialize():
# 占位:加载模型、预热连接池、校验下游凭证
# 完成后才置位
ready.set()
class Ping(BaseHTTPRequestHandler):
def do_GET(self):
if self.path != "/ping":
self.send_response(404)
self.end_headers()
return
if ready.is_set():
self.send_response(200)
self.end_headers()
self.wfile.write(b'{"status":"ok"}')
else:
self.send_response(503)
self.end_headers()
self.wfile.write(b'{"status":"initializing"}')
if __name__ == "__main__":
threading.Thread(target=initialize, daemon=True).start()
HTTPServer(("0.0.0.0", 8080), Ping).serve_forever()
注意:上述 503 分支是否被平台视为“尚未就绪”而非“不健康”,材料未说明,需按文档确认。如果平台把任何非 200 都算失败,这段代码就需要改成提前暴露端口但延迟注册到负载路径,具体做法取决于文档中的判定规则。
建议的迁移顺序#
- 先算账,再改字段:用自己的镜像大小和历史内存曲线,估算 V2 下的 GB-hours 变化,与单价上涨相抵后是否为正收益。材料只给了定性结论,算不出来就别迁。
- 先改就绪逻辑,再切版本:把初始化完成信号独立出来,确保
/ping在真正就绪前不返回健康。这一步与版本无关,先做不会浪费。 - 并行建一个 V2 runtime 做对照:由于 create/update 需要数分钟,建议新建而非原地更新,保留旧 runtime 承接流量,跑一段真实请求后再切。
- 观察窗口覆盖冷却场景:内存回收只在实例冷下来时发生,短时间压测看不出来。观察期要刻意包含空闲后再唤醒的路径。
- 确认区域与计费前提:周报称 V2 在 10 个区域可用,但未列出具体区域;承诺基线定价写的是“coming soon”。这两项在正式排期前必须核实。
动手前仍需核实的清单#
- 官方 V2 优化文档中列出的具体适配项(材料只说“docs cover how to optimize”,未列条目)。
/ping的响应格式、状态码判定与 120 秒计时起点。- 10 个可用区域的具体清单。
- 承诺基线定价的公布时间与适用范围。
- 镜像大小上限、快照准备时长与失败重试行为。
- 把
platformVersion回退到旧版本所需的时长与影响。
结论:V2 的迁移门槛看起来低——只是一个字段。但真正的成本在字段之外:一个必须在初始化之后才成立的健康信号,和一次持续数分钟、需要可回滚的变更。把这两件事核清,再决定要不要在下一个迭代里切。
参考来源
以上为本文写作时的参考资料,引用观点以原文为准。