高级配置(1) 本文介绍 SDK 接入时常见的高级配置项和工程化建议,适用于需要在生产环境中稳定调用 AIuse 云电脑能力的场景。 服务地址配置 创建 Client 时可通过 serviceURL 指定服务地址: plaintext const client new Client({ apiKey: process.env.AIUSEAPIKEY, apiSecret: process.env.AIUSEAPISECRET, desktopCode: process.env.AIUSEDESKTOPCODE, serviceURL: ' }); 如未显式配置服务地址,SDK 将使用默认地址。默认地址以 SDK 实际发布版本为准。 环境变量配置 生产环境建议使用环境变量或密钥管理系统保存敏感配置: 环境变量 说明 AIUSEAPIKEY AccessKey ID AIUSEAPISECRET AccessKey Secret AIUSEDESKTOPCODE 桌面编码 AIUSESERVICEURL 服务地址 示例: plaintext const client new Client({ apiKey: process.env.AIUSEAPIKEY!, apiSecret: process.env.AIUSEAPISECRET!, desktopCode: process.env.AIUSEDESKTOPCODE!, serviceURL: process.env.AIUSESERVICEURL }); 超时与重试 GUI 操作依赖目标桌面状态、应用响应速度和网络情况。建议在业务侧为关键步骤设置超时和重试策略。 推荐策略: 对创建会话、截图、文件读取等关键操作设置超时。 对临时网络异常可进行有限次数重试。 对具有副作用的操作,如点击提交按钮、删除文件、覆盖写入文件,应谨慎重试。 重试前应尽量通过截图或状态检查确认当前界面状态。 日志记录 建议记录以下信息: 任务 ID。 AccessKey 名称或脱敏后的 AccessKey ID。 桌面编码。 会话 ID。 关键操作名称和调用结果。 错误码和错误信息。 不建议记录完整 AccessKey Secret、文件正文、敏感业务数据或完整截图地址。
来自: