aiui-cloud-integration

用途

AIUI Cloud Integration 用于服务端 AIUI 云集成场景。它面向需要在服务器侧对接 AIUI 智能体与 Rokid 相关云能力的开发者，提供账号查询、一次性消息缓存和 Rokid Glasses 通知三类集成能力。技能文档建议按需选择对应参考，而不是一次性加载全部 API 契约。

主要能力

• 账号服务：系统智能体专用的账号令牌端点，详见 references/account-services.md。
• 消息：为智能体临时存储一条消息，供其消费一次，详见 references/messaging.md。
• 通知：Rokid Glasses 通知投递，以及通知触发的页面跳转，详见 references/notifications.md。

使用方式

安装零运行时依赖的包：

npm install @yodaos-pkg/cloud-integration

从包中导入 CloudIntegration，并使用 Rokid 账号 SK 构造实例。令牌应保存在环境变量或密钥管理器中，不要放入 AIUI 页面代码、源码管理、日志或用户可见数据。

import { CloudIntegration } from '@yodaos-pkg/cloud-integration'

const cloud = new CloudIntegration({
  token: process.env.ROKID_SK,
})

await cloud.sendNotification({
  messageId: 'message-unique-id',
  accountId: 'target-account-id',
  message: {
    agentId: 'agent-id',
    content: 'Notification text shown on the Glasses.',
  },
})

当不适合使用 Node.js 时，可使用相关参考中完整的 curl 示例。需保留文档规定的端点、认证头和 JSON 字段命名；SDK 使用 camelCase，而部分 HTTP API 使用 snake_case。

凭证与安全

账号 accessToken 与通知令牌（Rokid 账号 SK）是不同的凭证。二者都应保存在服务端的环境变量或密钥管理器中。切勿将任一凭证复制到页面代码、客户端包、源码管理、日志或用户可见的错误信息中。

适用场景

适用于服务端 AIUI 云集成，包括需要查询 Rokid 账号、为智能体暂存一次性消息，或向 Rokid Glasses 发送通知并触发页面跳转的场景。

限制与补充

关于包的签名与当前实现细节，在仓库内工作时可阅读 packages/cloud-integration/README.md。资料未提供收费、价格、平台支持范围或效果方面的信息。