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 |
描述符不是实时连接,也不是业务命令 API。前端只按已授权用途使用 WebSocket、WebRTC、Yjs 或其他声明的传输;到期后通过后端获取新描述符。业务 CRUD 和智能体命令经后端与服务端 SDK 发送;观察数据流并不代表有权执行这些命令。浏览器或移动端不得保存 bsk_ Key。
终端和 ACP 应使用环境返回的传输与范围,不假设固定 URL 或协议。产品前端集成解释后端边界;UI 与部署架构解释 A2UI 和 A2HTML。
BeeOS Cloud返回文档首页