解决什么问题
AG-UI 规范了 Agent 与用户应用之间的实时交互边界。事件流覆盖运行生命周期、消息、工具调用、共享状态、活动与自定义扩展。因此它首先是交互协议,而不是视觉组件库。
位于哪一层
AG-UI 位于 Agent Runtime 和前端之间。A2UI 这样的声明式 UI 载荷可以通过 AG-UI 传输,json-render 或 OpenUI 等渲染框架再把结构化输出映射成组件。MCP 与 A2A 分别位于工具/数据和 Agent 协作等相邻边界。
安全边界
把所有事件与工具参数视为不可信输入;校验事件结构,在服务端授权工具副作用,不暴露原始思维链,并从可信状态快照恢复连接,而不是盲目重放客户端状态。
最小示例
用户动作 → RunAgentInput → Agent Runtime
Agent Runtime → 有序 AG-UI 事件 → 前端状态与界面
连接真实模型前,先在事件实验室中完整走通确定性的生命周期。