SuperAPI AI 工具集

aiui-cloud-apis

智能体与模型

查看项目

更新于 10-26 16:30

技能介绍

用途 该技能面向调用 Rokid OpenAPI 的 AIUI 应用与页面代码,通过运行时内置的 open 模块调用面向智能体的开放接口。服务端集成另有文档,不在此技能范围内。

主要能力 覆盖六项操作:getProfile 获取账户 ID、名称、头像或手机号;invokeAgentApi 调用灵珠智能体并接收流式输出;checkUserAuth 检查敏感信息权限;saveThirdToken 保存第三方 token;getThirdToken 获取当前智能体的第三方 token;getAIUICacheMessage 消费一条缓存的 AIUI 消息。

使用方式 初始化:从 'open' 导入 createOpenAPI,并 await createOpenAPI() 得到 api。open 是 QuickJS/Ink 运行时内置模块,不是 npm 包;不要从 @yodaos-pkg/ink 导入,不要调用 fetch('/openapi/...'),也不要假设 api 是全局变量。导入、初始化与 API 调用均需用 try/catch 保护。认证由运行时注入,不要手动传入或记录 access_token 或 x-request-agent-id。带请求体的操作必须使用精确的 { body: requestBody } 包装,无请求体的操作不接收参数。

各操作最小调用形态:api.account.getProfile()、api.auth.checkUserAuth()、api.agent.getThirdToken()、api.agent.getAIUICacheMessage() 均无参数;api.agent.saveThirdToken({ body: { company, token } }) 中 company 与 token 必填,refreshToken、meta、expireInMs 可选,成功为 code === 1 且 data === null,expireInMs 为毫秒级有效期,省略时默认 2592000000(30 天);api.agent.invokeAgentApi({ body }) 立即返回 EventSource,绝不能 await,一次智能体会话生命周期内复用同一个 conversation_id。SSE 流处理需解析每个 event.data,仅追加非空 step: 'content' 的 message.content,排除 thought,检查 metadata 中的工具信息,并将 error 事件的 message.content 呈现给用户,同时处理 tool_call_finsh 与 tool_call_finish 两种拼写。操作级请求、响应、字段、事件与错误细节以 references/ 下对应文件为准。

安全规则 手机号、token、refreshToken 视为敏感信息,需空值检查受限字段、掩码手机号,且不记录、不持久化、不暴露凭据。checkUserAuth 仅作参考而非硬性门禁,返回 false 或不可用时仍继续流程并防御性检查受限字段。getThirdToken 返回 code === 1 且 data === null 表示成功的无 token 状态;getAIUICacheMessage 同样情况表示缓存为空,读取为原子删除,不要盲目重试。profile.notification 非空时需原样可见展示。

常见错误 不要展平请求体字段、不要 await SSE 方法、不要为每条消息生成新会话 ID、不要给无请求体方法传参、不要拼接 thought 输出、不要臆造未文档化的响应字段、不要把参考性权限失败当作传输失败。

适用场景与限制 适用于 AIUI 应用与页面中调用上述六项 Rokid OpenAPI 操作的编码场景;不涉及服务端集成。其余细节资料未提供。