生活分享

AWS 介绍 AgentCore Session endpoints：AI 代理改代码时，可在浏览器实时预览网页应用

AWS 表示，开发者与产品团队可通过 Amazon Bedrock AgentCore runtime 的 Session endpoints，从自己的浏览器经验证连接到 AI 代理正在修改的网页应用并实时看到变更，不必每改一次就重新部署。

阅读时间约 6 分钟

AWS 介绍 AgentCore Session endpoints：AI 代理改代码时，可在浏览器实时预览网页应用
图片：Mokaair (Original editorial artwork)

AWS 介绍了什么

AWS 在 2026 年 10 月 30 日发表博客文章，介绍 Amazon Bedrock AgentCore runtime 的 Session endpoints。“代码代理”是能自行编写、修改代码的 AI；代理每次执行任务的一段工作期间称为“会话”(session)。AWS 指出，AgentCore runtime 会让每个会话在各自独立的 microVM（一种轻量、彼此隔离的虚拟机）中运行；Session endpoints 则让用户能从自己的浏览器打开该会话中运行的应用程序。

AWS 说明的背景是：若应用程序必须先复制出去、部署到别处，每次修改都要等部署，审查速度就会被拖慢；若应用程序持续在代理编辑的地方运行，每次修改几秒内就能在浏览器中看到。

AWS 的演示是一个代码代理：用户要求把网站改成深色主题，代理保存样式表后，浏览器中的网站无需刷新就更新了。以下内容均为 AWS 的说法。

运作方式与限制

据 AWS 说明，Session endpoints 为每个会话提供一个需验证的网址，会把每个请求的 HTTP 方法、路径、查询字符串与内容，以及 WebSocket 连接（一种让服务器能主动把更新推送给浏览器的长时间连接），转发到用户允许的端口。端口（port）可理解为同一台机器上不同服务的“门牌号码”。

  • 端口：AWS 表示，创建 runtime 时通过 allowedPorts 设置，共 1 至 5 项，每项为 8000–12000 范围内的单个端口或区间，并排除平台保留端口；应用程序本身必须在该端口监听并绑定 0.0.0.0。
  • 网址：AWS 表示，网址会放在 InvokeAgentRuntime 响应的标头（随响应一起返回的附加信息）中。
  • 验证：AWS 表示，使用 IAM（AWS 的身份与访问权限管理服务）的 runtime，每个请求都要带 SigV4 签名（AWS 用来证明请求者身份的签名方式），调用者也需要 bedrock-agentcore:InvokeAgentRuntimeProxy 权限；使用 JWT 授权的 runtime 则带 bearer token（一种访问凭证）。AWS 强调，知道网址并不等于获得访问权。
  • 范围：AWS 表示，网址仅限单个会话，会话结束即失效；要对外提供服务，应部署到 AWS Amplify Hosting 等托管服务。
  • 本地端点：AWS 表示，浏览器无法自行为页面请求加上签名或 token，因此 bedrock-agentcore SDK 的客户端可在本地开一个端点，替请求补上凭证再转发。

AWS 也区分了 Session endpoint 与原本就有的 runtime endpoint：后者是调用代理本身的入口，前者则用来查看代理在会话中运行的内容。

AWS 对两种端点差异的说明
项目Session endpointRuntime endpoint（如 DEFAULT）
用途（据 AWS）查看代理在会话中运行的内容，例如网页预览让调用者连到代理，并控制调用者连到哪个版本
存续与版本（据 AWS）适用会话当下运行的版本，会话结束后即失效让开发与生产环境使用不同版本，可切换或回退版本而不必改动调用端
可达范围（据 AWS）只能连到允许的端口通过 InvokeAgentRuntime 连到代理

对开发团队的意义

按 AWS 的说明，开发团队审查 AI 代理产出的网页原型时，可以在代理工作的同一环境中直接看到结果，不必每次先部署。AWS 也提醒，这个功能用于构建、测试与审查，不是向终端用户提供服务的方式。

AWS 还提到，若其他人也能对代码代理下指令，可考虑使用 Amazon Bedrock Guardrails 过滤有害的指令与响应，并在发布前审查代理的修改。AWS 称演示代理的文件工具会拒绝网站文件夹以外的路径。

请求被拒绝时会看到什么

AWS 列出的常见拒绝响应
情况runtime 响应（据 AWS）
端口不在 allowedPorts403 AccessDenied
没有有效凭证403 AccessDenied 或 401 AuthenticationRequired
允许的端口上没有服务在监听502 PortNotReachable
网址对应的会话已不存在404 SessionNotFound

AWS 另表示，请求会在 AWS CloudTrail（AWS 的操作记录服务）中记录为 InvokeAgentRuntimeProxy 事件；runtime 在转发前会移除自己的验证标头，网站不会收到用户的签名。

适用条件与已知限制

  • AWS 表示，Session endpoints 适用于 microVM runtime，不支持 Instances 计算类型（AWS 提供的另一种运行方式）。
  • AWS 表示，网址通过公开 HTTPS 访问；从外部连入时不支持 AWS PrivateLink（AWS 的私有网络连接服务）。
  • AWS 的演示需要：提供 Session endpoints 的 AWS 区域中的账户、Python 3.10 以上、bedrock-agentcore 1.25.2 以上、boto3 1.43.122 以上、Node.js 22 以上，以及 Amazon Bedrock 中的 Claude Haiku 5.5 访问权。
  • AWS 在 agentcore-samples GitHub 仓库提供完整示例与笔记本；为避免持续计费，AWS 建议结束后停止预览并删除示例创建的 runtime、上传的代码与 IAM 角色。

常见问题

Session endpoints 是什么？

据 AWS 说明，它是每个 AgentCore runtime 会话专属、需验证的网址，可把请求转发到用户允许的端口，让人从浏览器看到代理在会话中运行的应用。

知道网址的人都能打开预览吗？

AWS 表示不能。每个请求都需要有效凭证（SigV4 签名或 bearer token），知道网址并不授予访问权。

可以用它对外提供正式网站吗？

按 AWS 的说明不适合。网址只在会话存续期间有效，要服务用户应部署到如 AWS Amplify Hosting 的托管服务。

通过 Session endpoint 的请求会留下记录吗？

AWS 表示会。请求会在 AWS CloudTrail 中记录为 InvokeAgentRuntimeProxy 事件，事件来源为 bedrock-agentcore.amazonaws.com。

查看同分类最新消息

同主题延伸阅读

资料来源

生活分享