文档产品前端与数据信道

BEEOS CLOUD / DEVELOPER REFERENCE

数据信道

通过受限描述符连接消息、ACP、终端、Canvas、文件和查看器

Cloud 管理请求、产品用户事件和实时数据走不同路径。产品后端先授权用户,通过服务端 SDK 发送业务命令,再通过自己管理的用户实时通道发布面向产品用户的事件。实时数据信道由后端签发或获取短期、按用途限定的描述符,前端再连接指定端点。

信道用途入口集成方式
产品用户事件聊天状态、通知及面向产品用户的更新产品后端经认证的用户实时通道按产品会话与 ACL 订阅
ACP智能体协议流后端授权的 ACP 描述符按返回的传输与范围连接
终端交互式 shell后端授权的终端描述符按返回的传输与范围连接
Canvas / A2UI结构化智能体 UI智能体 canvas.token;后端授权的 Canvas 描述符渲染授权 UI 状态
Yjs共享文档状态Canvas 协作传输授权文档访问
WebRTC 查看器远程视频与输入后端授权的查看器描述符交换信令与媒体
文件预签名传输服务端 files.prepareUpload;智能体 files.presign将字节传给存储 URL

产品应用通过后端取得受限描述符,再连接消息、ACP、Canvas 或查看器端点点按查看原尺寸图表

描述符不是实时连接,也不是业务命令 API。前端只按已授权用途使用 WebSocket、WebRTC、Yjs 或其他声明的传输;到期后通过后端获取新描述符。业务 CRUD 和智能体命令经后端与服务端 SDK 发送;观察数据流并不代表有权执行这些命令。浏览器或移动端不得保存 bsk_ Key。

终端和 ACP 应使用环境返回的传输与范围,不假设固定 URL 或协议。产品前端集成解释后端边界;UI 与部署架构解释 A2UI 和 A2HTML。