AgentCore Runtime V2 与 Step Functions 工具化:托管运行时升级前要核对的契约
Runtime V2 改变的是启动与内存两条底层契约:用 platformVersion 显式切换、创建和更新时要等快照准备、容器须在 120 秒内于 /ping 报健康、计费从按峰值转向按实际使用。Step Functions 工具化改变的是调用契约:agent 决定何时调用与传什么输入,执行顺序由状态机保证。升级前应逐项核对快照边界、健康上报时序、镜像体积、区域交集、工具输入 schema 与身份注入位置;两份周报未覆盖的部分需以官方文档为准。
- Runtime V2 的迁移面集中在三处:platformVersion 切换带来的数分钟变更窗口、120 秒 /pin
- Step Functions 作为工具时,执行顺序不属于模型:agent 只选调用时机和输入,资格校验、审批、授信仍按状
- 周报未给出 V2 的 10 个区域名单、committed baseline 价格、快照包含哪些状态,也未说明工具调用失
把 agent 放在托管运行时上,升级的代价通常不在新版本本身,而在新旧契约的接缝:变更要等多久、健康检查怎么判、内存怎么计量、工具被调用时输入输出的边界在哪。按目前可查的两份 AWS 官方周报,AgentCore Runtime V2 改的是启动与内存这两条底层契约,Step Functions 工具化改的是 agent 与工作流之间的调用契约。升级前要核对的,就是这两组契约能否在你现有的部署方式下同时成立。
两份材料各自说明了什么#
2026 年 11 月 9 日的 AWS Weekly Roundup 介绍了新的 AgentCore Runtime:会话从小内存起步、按需分页、冷下来后归还内存;运行时准备环境一次并做快照,新实例从快照恢复。文中给出的冷启动数字——P75 约 2 秒、镜像从 200 MB 到 2 GB——被明确表述为团队测试结果,不是独立复现。
2026 年 11 月 2 日的 另一期周报 说明 Step Functions 工作流可以通过 AgentCore Gateway 作为 agent 工具暴露,走 Model Context Protocol(MCP,模型上下文协议)。两篇都是周报体例的编辑综述,细节仍需回到对应技术文档核对。
运行时侧:V2 改动落在哪几条契约上#
platformVersion 与变更窗口
按周报描述,选择 V2 的方式是在创建或更新 runtime 时把 platformVersion 设为 V2。这里有一条容易被忽略的运维契约:创建和更新都要花几分钟准备快照。也就是说,这次切换不是一个瞬时开关,而是一次有持续时间的变更,期间新旧实例如何共存、流量如何过渡,材料没有展开,需要在灰度方案里自行确认。
120 秒的 /ping 健康预算
周报明确要求容器在 120 秒内于 /ping 上报健康,并特别提醒:只在初始化完成后才上报健康。这两句话合起来构成一条硬约束——初始化既不能早报(会被判为未就绪),也不能晚于窗口(会被判为不健康)。如果你的 agent 在启动时要加载模型、建立连接池或拉取远端配置,需要先量一遍这段耗时。
# 未执行的示例:仅示意“初始化完成后才报健康”的顺序
# 响应格式与框架接口以官方文档为准,此处为占位
READY = False
def initialize():
global READY
load_model() # 占位:实际的初始化工作
warm_up_connections() # 占位
READY = True
def handle_ping():
# 初始化未完成时不应返回健康
return "healthy" if READY else "initializing"
快照边界是必须问清的一项
“准备一次、快照、每个新实例恢复快照”这句话留下了关键空白:快照覆盖哪些状态。文件系统、进程内存、环境变量、运行时注入的临时凭据,是否都在快照范围内,材料没有说明。如果临时凭据被固化进快照,恢复出来的实例可能带着已经过期的身份启动;如果快照只覆盖镜像层,那初始化逻辑仍需在每个实例上跑一遍。这项待核实,而且优先级高于性能调优。
内存模型变化会影响行为,不只是账单
从“按峰值持有”改为“按需分页、冷时归还”,对依赖大块预分配或常驻缓存的 agent 是行为层面的改变,而不只是计费口径的改变。核对方法是看现有实现里有没有“启动即申请大内存”或“假设缓存不会被换出”的写法。计费方面,周报的表述是单位费率更高、GB-hours 更少,团队预期多数 agent 账单更低,但明确说了不保证。
区域与价格都还没有完整答案
周报称 V2 在 10 个 Region 可用,未列名单;committed baseline pricing 是“即将推出”,价格待核实。如果你的部署跨区域,或者同时要用 Step Functions 工具,需要核对两个可用区域的交集——Step Functions 工具化的可用范围是“所有 AgentCore Gateway 可用的区域”,这两个集合未必重合。
工具侧:Step Functions 作为 agent 工具时的调用契约#
顺序归状态机,时机归 agent
周报把分工写得很清楚:agent 决定何时运行工作流、传什么输入;Step Functions 按你定义的步骤执行。文中举的例子是退款——资格检查、经理审批、授信仍按那个顺序发生,因为顺序从来不是模型可以即兴发挥的部分。这条契约的含义是:凡是带副作用、需要固定次序的操作,应当落在状态机里,而不是让模型串联多个工具。
工具输入就是状态机输入
既然 agent 只能填状态机接受的输入,那么这个输入结构就是事实上的工具契约。周报没有说明工具描述从何生成、必填字段如何暴露、校验失败以什么形态回传给模型。这三项直接影响模型能否一次调用成功,升级前应当实测确认,而不是假设它会自动补全。
身份不能变成模型可设的参数
同一期周报里的 MoEngage 案例值得单独看:约 400 个内部 REST API 操作、25 个团队、跨 7 个 Region 的私有 VPC,租户身份“永远不会成为模型能设置的参数”。这个案例讲的是 AgentCore Gateway 而非 Step Functions,但约束是通用的:把工作流暴露成工具时,租户标识、权限范围这类字段应由网关或运行时注入,不能出现在工具入参里。
工具目录的 token 成本
同一个案例里还有一个数字:完整的工具列表会让每次连接超过 20,000 tokens,所以改成让 agent 描述任务来检索工具。如果你打算把大量状态机都暴露出去,工具描述本身就是一笔上下文开销,需要提前算进去。
可观测性与版本选择
周报提到 agent 可以查询运行记录,这给了一条独立的排障路径:模型报错时,先看状态机执行记录,而不是只看对话日志。另外,现有 Standard 和 Express 工作流都可作为目标,无需重写;但两者在执行时长与执行语义上不同,选哪一种取决于你对失败重试和长任务的要求,具体差异需查官方文档。
升级前的核对表#
下表中的“依据”列来自上述两篇周报;“需要确认”列包含基于材料描述的推断,并非官方说明。
| 核对项 | 需要确认的契约 | 依据 |
|---|---|---|
| platformVersion | 创建/更新时显式设为 V2,变更持续数分钟 | 11-09 周报 |
| /ping 时序 | 初始化完成后才报健康,全程不超过 120 秒 | 11-09 周报 |
| 快照范围 | 包含哪些状态;临时凭据是否被固化 | 材料未说明,待核实 |
| 内存假设 | 是否存在启动即预分配、缓存常驻的写法 | 基于内存模型变化的推断 |
| 镜像体积 | 团队测试覆盖 200 MB 至 2 GB,超出范围无数据 | 11-09 周报 |
| 区域交集 | V2 的 10 个 Region 与 Gateway 可用区域的交集 | 名单待核实 |
| 计费口径 | 单位费率更高、GB-hours 更少,净额取决于用量分布 | 11-09 周报 |
| 工具输入 | 状态机输入结构即工具契约,校验失败如何回传 | 11-02 周报,细节待核实 |
| 身份注入 | 租户标识不出现在模型可填参数中 | MoEngage 案例转述 |
| 工具目录 | 单次连接的工具描述 token 开销 | 同上,约 20,000 tokens |
材料没有回答的问题#
- V2 具体覆盖哪 10 个 Region,未列名单。
- committed baseline pricing 何时可用、价格如何,周报只写“即将推出”。
- 快照包含的边界,以及更新期间新旧实例的流量处理方式。
- Step Functions 工具调用失败、超时、输入校验不通过时,错误以什么结构返回给模型。
- 工具描述由什么生成,是否支持自定义说明文字。
这些都属于“材料未提供”,而不是“官方没有说明”,应直接查对应技术文档或在自己的账号内验证。
实践顺序建议#
先在一个非关键 runtime 上切到 V2,只观察两件事:容器从启动到 /ping 报健康的实际耗时,以及一周内的 GB-hours 与旧版对比。这两项决定了值不值得全量。Step Functions 一侧则先收敛工具边界——把带副作用的流程做成状态机,把输入 schema 收窄到模型能填对的字段,身份与租户信息留在网关侧注入。等这两步稳定,再讨论把更多工作流暴露出去。
常见问题(FAQ)
升级到 Runtime V2 需要改业务代码吗?
现有 Step Functions 工作流要重写才能给 agent 用吗?
V2 一定更便宜吗?
参考来源
- AWS Weekly Roundup: AgentCore Runtime V2, Amazon DynamoDB bulk put items, and more (November 9, 2026)
- AWS Weekly Roundup: GPT-6.1 Terra on Bedrock, Step Functions as agent tools, and more (November 2, 2026)
以上为本文写作时的参考资料,引用观点以原文为准。