Cloud 架构

BeeOS Cloud 将管理、智能体执行和最终用户数据信道分开。产品后端管理自己的用户，使用服务端 Key 调用 Cloud API。实例内运行时处理消息和方法；产品应用通过自己的后端获取短期描述符。

点按查看原尺寸图表

实时数据信道由后端授权短期描述符，应用再连接指定端点：

点按查看原尺寸图表

资源生命周期通过 ClusterHub 和集群代理进入实例。实例放置由接入的提供商、区域与集群决定；具体可部署区域以区域目录为准。

边界	职责	凭证
Cloud API	实例、智能体、会话、任务、文件、用量、运行时方法	服务端 bsk_ Key
Agent 网关	运行时身份、文件与 Canvas 端口、A2A 调用	实例运行时 token
产品后端	产品用户认证与授权、经服务端 SDK 发起业务命令，以及签发客户端会话或描述符	产品会话与仅限后端持有的服务端 Key
产品前端	产品自有事件通道，以及连接已授权的数据端点	产品会话或短期、按用途限定的描述符

产品后端通过服务端 SDK 发送业务 CRUD 与命令，再通过自己管理的用户实时通道发布面向产品用户的事件。描述符只授权一个数据连接，不是通用命令通道，也不能代替产品事件流。参阅产品前端集成。

Cloud Server OpenAPI 契约声明了 https://api.cloud.beeos.ai/v1；实际客户端应配置当前环境提供的 API URL。

继续阅读 SDK 选择、认证和快速开始。