AWS Bedrock AgentCore 集成 AG-UI 协议,支持生成式 UI
AWS Bedrock AgentCore 新增 AG-UI 协议支持,可在代理运行时实现生成式 UI、共享状态与人在环…
Amazon Bedrock AgentCore 近日新增对 AG-UI(Agent-User Interaction Protocol)协议的原生支持。AG-UI 是一套面向 AI Agent 前端交互的开源协议,定义了 Agent 后端向前端传递动态事件的标准方式,覆盖生成式 UI、共享状态和人在环路(human-in-the-loop)三类核心交互场景。借助此次集成,开发者可以在 AgentCore Runtime 上直接部署支持 AG-UI 的 Agent,并通过统一的协议层与 React、Angular、Vue 等前端框架对接。
协议定位:连接 Agent 与用户
AG-UI 解决的是 Agent 后端与前端之间的通信标准问题。此前 AgentCore Runtime 已支持两种主流协议:用于连接工具的 Model Context Protocol(MCP),以及用于 Agent 间通信的 Agent2Agent(A2A)。AG-UI 的加入补齐了「Agent 连接用户」这一环节。
部署时,开发者只需在 Agent 容器中声明 AG-UI 协议标识,AgentCore 即作为透明代理转发请求,并负责身份认证(支持 SigV4 与通过 Amazon Cognito 的 OAuth 2.0)、会话隔离、弹性扩缩和可观测性等运行时能力。Agent 容器对外暴露 POST /invocations(处理 AG-UI 请求)和 GET /ping(健康检查,端口 8080)即可,AgentCore 透传请求内容而不做修改。
FAST 模板:双框架共享前端解析器
全栈 AgentCore 解决方案模板(FAST)是一个基于 AWS CDK 的可部署起步项目,串联了 AgentCore Runtime、Gateway、Identity、Memory 与 Code Interpreter 等组件,前端使用 React 并通过 Cognito 完成认证,内置 Strands Agents、LangGraph 和 Claude Agent SDK 三种 Agent 模式。
FAST v0.4.1 新增两个 AG-UI 模式:agui-strands-agent 与 agui-langgraph-agent。两个模式共用一个前端解析器,开发者无需关心后端运行的是 Strands 还是 LangGraph,解析器均能正确处理事件流。AG-UI 模式下的 Agent 默认启用以下能力:
- 每次请求创建全新 Agent 实例,从 Gateway 获取当前用户的 MCP 工具集;
- 通过 session-manager provider 挂载 AgentCore Memory,按会话线程保持记忆,
MEMORY_ID未设置时自动跳过; - 使用 Amazon Bedrock 上的 Claude Sonnet 4.5 作为底层模型,并集成安全的代码执行工具。
CopilotKit 增强:生成式 UI 与人在环路
在 FAST 内置模式之外,AWS 还提供了 CopilotKit + FAST 独立示例,将默认聊天界面替换为 CopilotKit,重点演示三类进阶交互:
- 生成式 UI:Agent 可在对话流中内联渲染图表和交互组件;
- 双向共享状态:以 Todo 画布为例,Agent 与前端实时同步数据;
- 人在环路:会议排期场景中,Agent 暂停执行并等待用户确认后再继续。
两层方案均部署在 AgentCore Runtime 上,统一使用 Cognito 鉴权、AgentCore Gateway 连接 MCP 工具、AgentCore Memory 保持会话持久化。
部署前提与上手建议
要复现该方案,需要准备以下环境:
- 具有 CloudFormation、Amazon ECR、Bedrock AgentCore、Cognito、Amplify 操作权限的 AWS 账户;
- AWS CLI v2、AWS CDK、Node.js 18+、Python 3.11+ 以及本地运行的 Docker;
- 在 Amazon Bedrock 控制台中为目标模型开启访问权限。
源码已在 FAST 仓库(含 AG-UI 模式)和 CopilotKit + FAST 示例中公开。整体方案面向需要在生产环境中构建可交互 Agent 前端的团队,适合作为 AgentCore 上多协议协作的标准参考实现。
