
要点
- Amazon Bedrock AgentCore Runtime 新增 Session endpoints:每个微虚拟机会话获得经认证的 HTTPS URL,把方法/路径/查询/正文与 WebSocket 转发到允许的端口(约 8000–12000,最多 5 项)。
- 浏览器无法自行签 SigV4;bedrock-agentcore SDK 的本地端点在本机补凭证再转发,从而在同一页面左聊天、右热更新预览 Vite 站点。
- 拒绝语义明确:未允许端口/无凭证 → 403;端口无监听 → 502;会话不存在 → 404——预览被设计为「构建—评审」通道,而非面向终端用户的托管。
AWS 机器学习博客在 2026年10月30日 宣布:可用 Amazon Bedrock AgentCore Runtime 的 Session endpoints,在编码智能体构建 Web 应用时当场预览。产品叙事很容易写成「又一个热重载演示」。更准确的读法是——评审环的时延税不在模型写代码的速度,而在应用是否必须被拷出会话、部署到别处才能点开。 Session 端点把「看得到智能体刚改的那一页」收成运行时一等能力。
[1]机制要点清楚。创建AgentRuntime 时设置 allowedPorts(1–5 项,单端口或范围,落在约 8000–12000,排除保留平台端口);允许端口不等于自动起服务,应用须监听 0.0.0.0。InvokeAgentRuntime 响应头 X-Amzn-Bedrock-AgentCore-Runtime-Session-Endpoint-Url(SDK 字段 sessionEndpointUrl)给出会话级 URL;主机名前缀选择会话内目标端口,对外仍走 443。IAM 运行时要求每条 HTTP/HTTP2/WebSocket 握手带 SigV4,并具备 bedrock-agentcore:InvokeAgentRuntimeProxy;JWT 入站则带 bearer。样本把编码智能体放在 8080(经 Invoke,不进 allowedPorts),Vite 在 8090,状态路由在 8081,本地 PreviewApp 在 localhost 开预览页并打开面向 8090 的本地端点。
可核对的设计选择有三。认证边界: 知道 URL 不等于有权访问;运行时在转发前剥掉自有认证头,网站看不到调用方签名;请求记入 CloudTrail 的 InvokeAgentRuntimeProxy。协议覆盖: HTTP/1.1、HTTP/2(含 SSE、gRPC)与 WebSocket 均可穿过——这对 Vite HMR 不是装饰,而是预览环成立的条件。失败码表: 端口不在允许列表或无有效凭证 → 403 AccessDenied(或 401);允许但无监听 → 502 PortNotReachable;会话不存在 → 404 SessionNotFound。文中还划界:Session 端点服务构建/测试/评审;面向用户应部署到 Amplify 等托管。约束同样明确:同一会话内网站与智能体共享计算,执行角色应最小权限;计算被替换时连接会断,除非配置持久存储。
钢人反驳一:这仍是云厂商运行时锁定——团队若已在本地或自管沙箱做 docker compose 预览,收益有限,还要承受公网 HTTPS Session URL 与 PrivateLink 不支持入站的限制。钢人二:本地端点用调用方凭证监听 127.0.0.1,降低浏览器签签名问题,却把「谁能打开预览」绑在开发者笔记本与短期会话上,远程协作与审计留存要另补。钢人三:样本用 Claude Haiku 5.5 改主题色,证明的是文件工具 + HMR 环,不是复杂全栈应用的安全边界;文中虽提示 Guardrails 与路径限制在站点目录内,企业工具权限矩阵仍是未解问题。
对做编码智能体产品的团队,这篇把 KPI 从「补丁一次通过率」扩展到「从提示到可见 UI 变化的秒级环」。对平台安全,Session 端点把「智能体能否触达会话内服务」变成显式端口策略与代理权限,而不是隐式的 sidecar 端口转发。若评审仍依赖把产物推到共享预览环境,AgentCore 叙事会显得超前;若产品经理已经坐在智能体旁边点按钮,缺少会话内预览就会成为可感知的摩擦。
[1]未来六个月应看三件事:Session endpoints 是否从 notebook 样例进入主流编码智能体 IDE/插件默认路径;allowedPorts 与 InvokeAgentRuntimeProxy 权限是否在企业落地成可审计策略包;以及有多少团队把「会话内预览」与「面向用户托管」严格拆开,避免把临时 Session URL 误当成生产入口。若编码智能体的产品速度越来越取决于会话内真实预览,而非再一次部署流水线,则 Session 端点这类能力会从演示技巧变成运行时标配。