参数名 是否必选 参数类型 说明 默认值 role 是 str 聊天角色，user或者assistant content 是 str 消息内容 type 是 str "text":文本， "image"图片， "browserresult" :互联网检索 ref 否 ChatMessageRef 文件（图片）内容，支持多模态的模型可以使用该字段，带上该字段的消息示例格式 { "role":"user", "content":"图里有什么", "ref":{ "type":"image", "image":[{"url":"", "filesize":60994} ] } }

本节介绍应用市场客户端的应用安装、升级、卸载等功能。 应用管理 搜索应用 支持通过应用名称等关键字搜索相关应用，也可以根据分类与行业快速检索所需应用。 安装应用 用户找到想要安装的应用后，可点击安装按钮安装，或进入应用详情页中下载安装。 安装方式 应用的安装方式可分为“一键安装”（静默安装）和“手动安装”两种。 “一键安装”，用户无需对应用进行设置，应用将直接下载并安装至虚机系统盘； “手动安装”，需要用户根据应用的安装指引进行安装。 注：可一键安装的应用，也支持手动安装。 应用升级 当已安装的应用有新版本可更新时，“我的应用”菜单将出现红点提示，可选择指定应用升级或全部升级。 应用卸载 我的应用菜单中，还可以选择“应用卸载”。应用卸载列表中展示的是桌面内已安装的应用（和控制面板中相同）。点击“卸载”按钮，将拉起桌面内应用的卸载程序。卸载完成后，应用将从列表中消失。

本节介绍翼甲控制台监控首页内容。 监控首页 用户进入翼甲卫士控制台后，可在监控首页页面对防护概览进行了解。 基础信息总览：可看到当前防火墙的各组件版本信息及资源使用率。 防护总览：可看到按照不同时间维度查（最近一小时、一天、一周）询流量趋势以及桌面防护情况。 告警监控总览：可以按照不同时间维度（最近一小时、一天、一周）查阅告警事件详情及处理结果。

登录云网门户，在“控制台”>“个人中心”>“第三方账号绑定 ”，通过创建或者查看获取ak，sk。

天翼AI云电脑服务协议生效，详情请参见++这里++。

参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 ok returnObj Object 返回数据结构体。 returnObj

本节介绍IPSec VPN绑定跨域互联入云使用场景说明。 IPsec VPN与资源池VPC互通 图21 客户侧防火墙或其他VPN设备通过IPsec VPN与资源池A互通 客户办公区防火墙或其他VPN设备通过IPsec VPN与资源池A的VPC互通，创建IPsec VPN实例时只需把资源池的VPC加载到IPsec VPN实例，如图21 IPsec VPN绑定跨域互联 图22 客户侧防火墙或其他VPN设备通过IPsec VPN绑定跨域互联与跨资源池B互通 客户侧防火墙或其他VPN设备结合IPsec VPN通过跨域互联与跨资源池VPC互通，需要将IPsec VPN实例与相关跨域互联实例绑定并加载指定的VPC，如图22，客户办公区需要与跨资源池B的VPC1互通，则在IPsec VPN实例中绑定该跨域互联VPC1即可。

重试建议 可以有限重试的场景： 临时网络抖动。 截图短暂失败。 应用加载未完成。 文件尚未生成。 不建议盲目重试的场景： 删除文件。 覆盖写入文件。 点击提交、确认、支付等具有业务副作用的按钮。 已明确返回鉴权失败或权限不足。 排查信息 提交问题时建议提供以下信息： 调用时间。 租户信息或项目标识。 脱敏后的 AccessKey ID。 桌面编码。 sessionId。 接口名称和请求参数摘要。 错误码和错误信息。 必要的截图或日志。 请勿在工单、邮件或聊天工具中发送完整 AccessKey Secret。

本节介绍企业云网的简介。 企业云网是天翼云自研的一系列云网络产品，通过VPN，企业可以实现一站式快速上云，云上云下高效协同办公。 企业云网可以提供的主要功能有： 跨域互联 IPSece VPN iVPN app 云专线绑跨域互联

并发控制 如果同一台云电脑同时被多个任务操作，可能出现鼠标、键盘和窗口状态互相影响的问题。建议按以下原则控制并发： 同一台云电脑同一时间只执行一个强交互 GUI 任务。 批量任务可分配到不同云电脑并行执行。 对需要共享文件目录的任务，应设计文件命名和锁机制。 对异常退出的任务，应释放会话并恢复桌面到可用状态。 配置检查清单 上线前建议检查： AccessKey 是否已关联正确云电脑。 desktopCode 是否对应目标环境。 服务地址是否为预期环境。 日志是否已脱敏。 异常路径是否会关闭会话。 任务失败后是否保留必要排查信息。

本节介绍Windows防火墙可以设置为关闭状态或者添加入站访问规则的操作流程。 Windows防火墙可以设置为关闭状态或者添加入站访问规则。 下面以Win10为例演示关闭Windows防火墙与设置具体的IP段的入站访问规则。 关闭Windows防火墙 1.打开Windows防火墙，点击“启用或关闭Windows防火墙”。 2.将Windows防火墙设置为关闭状态。 添加入站访问规则 1.打开Windows防火墙，进入“高级设置”； 2.新建入站规则； 3.选择自定义规则类型； 4.点击“作用域”，添加需要放行的远端地址； 5.点击“名称”，输入规则名称，点击“完成”即可。

本节介绍天翼云电脑电教室的功能简介。 功能概述 电教室是教育行业最典型的场景，天翼云电脑可统一控制、集中运维等优势非常适用于电教室场景。极域课堂管理系统能够协助教师进行课堂互动教学，提供多样化的课堂管理功能，从传统PC时代开始积累了大量的教育客户，是最广泛使用的课堂管理软件之一。结合电教室的使用场景，天翼云电脑推出了极域电教室方案，通过与极域联合研发，支持在云电脑中进行局域网广播、一键式批量控制终端、切换课程镜像。 功能特点 局域网广播：将教师云电脑画面通过局域网广播给学生，屏幕广播效果更加清晰、流畅。 一键式终端控制：在极域教师端一键式批量启动/关闭学生终端，终端控制更加便捷。 课程切换：在极域教师端批量切换学生课程镜像，课程切换更加简便、快捷。 使用场景 教育客户建设电教室，使用该方案进行日常教学。

接口 说明 createdirectory 创建目录 readfile 读取文本文件内容，支持按偏移量和长度读取 writefile 写入文本文件内容，支持覆盖、追加和新建 movefile 移动或重命名文件、目录 searchfiles 搜索文件

本节介绍白名单规则下有程序运行被阻止时,用户申请放行的流程。 申请放行 应用放行功能涉及审批流程，请先开通企业审批服务后使用该功能。开通及配置方法与上架审批相似，此处需先在“应用管理设置审批设置”开启应用放行审批，再前往审批流程流程配置中开通相应流程并设置审批人。 用户在桌面内运行不在白名单内的应用会被阻止并出现提示弹窗，可在弹窗中查看详情或发起申请。有多个程序被阻止时，可批量操作。 注： 1、当运行某款应用时出现未执行也未被阻止的无响应状况，可能已被Windows系统默认为风险拦截。遇此情况，右键该应用，并在在属性中解除Windows拦截即可。 2、绑定黑名单规则时，被阻止的应用不允许申请放行。 应用放行审批 申请人提交的应用放行申请，会展示在此列表下，审批人可逐条或批量处理；也可在客户端中进行审批，详细请见处理事项 。 结果通知 应用放行申请经审批人处理后，申请人会收到相关处理结果的通知。

本节介绍天翼量子AI云电脑客户端中的AI云电脑与AI云手机管理操作。 卡片/列表视图切换 在桌面列表页左上角，点击“卡片/列表视图”切换图标，可进行卡片视图和列表视图切换，还可以查看AI云电脑账号有多少台AI云电脑。 卡片视图 列表视图 左侧列表支持展示用户账号下的AI云电脑和AI云手机 编辑桌面名称、复制桌面ID 点击桌面名称，可直接自定义桌面名称，按Enter即可确认；复制桌面ID，点击桌面ID后面的图标即可复制桌面ID。 进入AI云电脑/云智手机 在卡片/列表视图，点击“进入AI云电脑”按钮进入AI云电脑。

本节介绍跨区域互联的开通说明和开通步骤。 产品定义 跨域互联可为客户提供同租户下不同VPC相同资源池或跨资源池互通的能力。 应用场景 场景1：同一租户下A资源池VPC1与VPC2互通。 场景2：同一租户下A资源池VPC1与B资源池VPC1互通（需要开通跨域带宽）。 使用限制 在开通跨域互联前需确认：需互通的资源池和虚拟私有云（vpc）的相关信息。VPC开通详情可查看“管理虚拟私有云”的相关操作指引。 注意 所有互通的VPC子网不可重叠，且跨域互联只能绑定同一个租户下的VPC。 跨域互联开通步骤 （1）创建跨域互联 （2）加载其他VPC或者子网 （3）开通跨域带宽并设置域间带宽 （4）设置桌面安全组与Windows防火墙

本文演示一次完整的 SDK 调用流程:创建会话、执行桌面操作、创建文件、读取文件并关闭会话。 完整示例 plaintext import Client from '@ctyun/desktopagentsdk'; async function main() { const client new Client({ apiKey: process.env.AIUSEAPIKEY, apiSecret: process.env.AIUSEAPISECRET, desktopCode: process.env.AIUSEDESKTOPCODE, serviceURL: process.env.AIUSESERVICEURL ' }); let session null; try { session await client.createSession(); console.log('会话创建成功:', session.sessionId); await session.computer.screenshot(); await session.computer.movemouse({ x: 500, y: 300 }); await session.computer.clickmouse({ x: 500, y: 300 }); await session.computer.typetext({ text: 'Hello from AIuse SDK!' }); await session.filesystem.createdirectory({ path: 'C:/aiusertest' }); await session.filesystem.writefile({ path: 'C:/aiusertest/hello.txt', mode: 'overwrite', content: 'Hello from AIuse SDK' }); const fileResult await session.filesystem.readfile({ path: 'C:/aiusertest/hello.txt', offset: 0, length: 0 }); console.log('文件内容:', fileResult.data?.content); } catch (error) { console.error('操作失败:', error); } finally { if (session) { await session.close(); console.log('会话已关闭'); } } } main().catch(console.error); 运行前检查 已安装 Node.js 18 或以上版本。 已安装 @ctyun/desktopagentsdk。 环境变量 AIUSEAPIKEY、AIUSEAPISECRET、AIUSEDESKTOPCODE 已正确配置。 AccessKey 已关联目标云电脑。 目标云电脑在线。 实践建议 先截图确认桌面状态，再执行鼠标和键盘操作。 复杂 GUI 任务建议拆分为多个阶段，每个阶段记录结果。 文件操作建议使用独立任务目录，避免误覆盖业务文件。 异常场景下也要关闭会话。

请参考API概览

请参考请求状态码

本节介绍天翼云电脑电脑客户端登录的相关操作。 扫码登录 打开天翼AI云电脑电脑客户端，在登录页面左边可以看到扫码登录模块。 天翼云终端扫码登录 ：支持通过天翼AI云电脑手机端App扫码登录或翼连App扫码登录。 天翼账号扫码登录 ：点击二维码下方“切换天翼账号二维码”，使用微信扫码登录，扫码成功并点击确认，即可登录AI云电脑客户端。 账号登录 登录页 右边可以看到账号登录 ，支持AI云电脑账号，手机号码和邮箱登录（手机号码或邮箱登录的前提是用户已绑定手机或邮箱）。 自动登录 登录页选择账号登录时，输入密码后，点击“自动登录”后自动勾选“记住密码”。登录成功后，下次启动客户端将自动登录对应的账号。 若取消“自动登录”，“记住密码”不会取消。 若取消“记住密码”，自动取消“自动登录”。 若切换账号，自动取消“自动登录”。 记住密码 登录页选择账号登录时，输入密码后，点击“记住密码”功能，下次登录无需重复输入登录密码。

枚举参数 无 请求示例 请求url 请求头header 无 请求体body 无 响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ "total":2, "list":[{ "middleOid":"subxxxxxx1", "userOid":"upgxxxxxx1", "tenantOid":"tenantxxxxxx1", "orgOid":"orgxxxxxx", "orgDir":"/根部门/财务部", "email":"user1@example.com", "userName":"张三", "userAccount":"user1.account", "createTime":"20231001T10:00:00Z", "updateTime":"20231010T15:30:00Z", "remark":"财务部子账号" },{ "middleOid":"subxxxxxx2", "userOid":"upgxxxxxx2", "tenantOid":"tenantxxxxxx2", "orgOid":"orgxxxxxx", "orgDir":"/根部门/人事部", "email":"user2@example.com", "userName":"李四", "userAccount":"user2.account", "createTime":"20231002T11:00:00Z", "updateTime":"20231011T16:30:00Z", "remark":"人事部子账号" }] } } 状态码 请参考 状态码 错误码 请参考 错误码

适用场景 云电脑3D模式覆盖11大应用场景： 类型 场景 个人用户 网页浏览 个人用户 影片观看 个人用户 赛事观看 个人用户 游戏体验 个人用户 教学科普 个人用户 相册回忆 企业用户 3D云看房 企业用户 企业办公 企业用户 行业培训 企业用户 商场3D广告 企业用户 酒吧娱乐 企业用户 企业宣传

本机介绍天翼云电脑在移动客户端的手势与操作模式。 悬浮球 通过点击AI云电脑右下角的带有颜色的“悬浮球”，可展开手势、键盘等快捷菜单面板。 触屏式/鼠标式 模式切换的按钮在右下角的快捷菜单中。 默认是触屏式，触屏模式下，手指直接点击屏幕触发该位置的操作。 点击“鼠标式” 切换至鼠标指针式，此时AI云电脑会出现鼠标指针，鼠标模式下，手指在屏幕划动控制鼠标指针的移动。 触屏模式手势指引 在触屏模式下，可以通过手指直接点击屏幕进行操作，具体手势操作如下： 单击：单指轻触屏幕。 右键：单指长按屏幕，震动反馈调出右键，或选择文件文档，长按至震动调出右键。 拖动：单指长按屏幕，震动反馈后，滑动手指拖动文件。 滚动：双指贴着屏幕上下滑动。 唤起键盘：三指轻按屏幕。 缩放屏幕：双指在屏幕上捏合。

本节介绍划词工具的使用方法。 划词工具适用于在办公场景中，当用户在文档、网页等内容里看到需要进一步处理（如搜索、翻译、生成相关内容等）的文字时，通过划选文字，快速调用工具进行操作，提升信息处理效率，比如在阅读资料时划选陌生概念进行搜索，或者划选外文进行翻译等。 1、开启关闭划词工具：在设置划词工具页面，可以开启或者关闭划词工具。 方式一：划词操作 2、划词搜索 / 翻译 / 生成等，在文档、网页等界面中，用鼠标划选需要处理的文字内容。划选后，会弹出划词工具栏，根据需求点击 “搜索”“翻译”“生成” 等相应功能按钮，即可对划选文字进行对应操作，比如点击 “搜索”，会跳转到搜索页面展示相关结果；点击 “翻译”，会显示翻译后的文字内容。 2、划词生成内容插入：划选文字后，在划词工具栏选择 “生成” 相关功能，设置好生成内容的类型（如文案、总结等）。 3、生成内容后，可点击 “继续提问” 按钮，可以进入云智助手中继续对话。 方式二：系统右键菜单入口 1、唤起右键菜单；在弹出的右键菜单中，找到划词“问问AI”功能，点击。 2、在对话页面，文件列表中，出现对应选择的文件，进行解析完成后可引用文件进行提问。

参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj Object 返回数据结构体。 returnObj

接口功能介绍 新增子账号 接口约束 无 URI POST /v3/subManager/create 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 orgOid 是 String 部门ID email 是 String 邮箱地址 userAccount 是 String 子账号登录账号。 1.长度至少为6位，最多24位; 2.仅支持字母、数字和字符.。 password 是 String 用户账号密码。激活方式为管理员激活时，必填。字符数限制：[8,26]。 必须至少包含大小写英文字母、数字和特殊符号三类字符，特殊字符集合：~!@ $%^&()+{[]} ;:,.'?/<>。 密码不能包含与账号相关的信息，不建议包含账号完整字符串、大小写变为或形似变换的字符串。 密码不能使用3个及以上键盘连续相邻字符，如123，Qwe等。 注意：如果传入password参数，建议您使用HTTPS协议发送请求，避免密码泄露。 remark 否 String 子账号备注信息 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj Object 返回数据结构体。 returnObj

参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj Object 返回数据结构体。 returnObj

本节介绍的是场景设置教育场景的使用方法。 场景切换 云智助手支持普通和教育场景切换功能，教育场景下聚焦教与学需求，学生可通过其精准获取教材、真题、辅导资料，还能获得作业解题思路与知识点拓展；教师则能借助其获取备课素材、自动批改客观题，同时 AI 会分析学生学习情况，提供个性化教学建议，适配学生学习、教师教学辅助场景，满足不同用户群体在不同情境下的需求。 【操作步骤】 1.进入设置页面，选择场景设置功能，进入场景选择页面 2.场景设置页面，点击选择教育场景，进行场景切换。 AI教育 AI 教育具备拍照答疑、口算与作业批改、知识点总结、智能出题及相似题推荐等功能，助力学习与作业辅导。 注意 教育相关智能体可以在通用场景AI场景教育 模块中也有对应入口。 功能一：拍照答疑 【操作步骤】 1.左侧入口进入AI教育模块，选择拍照答疑功能； 2.进入拍照答疑智能体，选择上传图片和输入解答问题的相关内容。移动端支持使用设备摄像头拍摄单页口算作业，确保题目清晰完整，拍摄完成后确认上传； 3.拍照答疑智能体会识别用户对话内容，生成解题答案。 功能二：口算批改/作业批改 口算批改适用于学生完成数学口算练习后，快速获取批改结果，了解自己的答题情况；作业批改则适用于各学科作业完成后， 家长、老师或是学生本人能借助该功能高效检查作业完成的正确与否，节省人工批改时间，提高学习与教学反馈的效率。 1.进入功能入口：在 云智助手界面，点击 “口算批改”（或 “作业批改” ）功能按钮，进入相应的批改界面； 2.从设备相册中选择单张作业照片上传。移动端支持使用设备摄像头拍摄单页口算作业，确保题目清晰完整，拍摄完成后确认上传； 3.批改结果系统会自动识别题目和答案，进行批改运算，稍作等待后，就会显示批改结果， 标注出答对和答错（存疑）的题目数量。

本节介绍翼甲卫士的应用场景。 医疗行业，入侵防护+医患资料保护 实现病毒防护和入侵防御，保障医院业务稳定。 有效防止医患资料通过邮件、应用、网站等形式外发。 政务机关，病毒入侵防御+政务内网安全访问 保障政企单位办公环境不受到病毒入侵，保证数据安全。 搭建AI云电脑与政务内网的安全访问通道，保障内网办公。 教育行业，行为管控+实现绿色上网 实现病毒防护和入侵防御，保障教学环境安全。 对课室和电子教室的AI云电脑进行上网管控，限制AI云电脑访问非教育平台的网站。

本节介绍云电脑高可用的产品简介,以便您了解云电脑高可用。 AI云电脑高可用功能可在AI云电脑出现不可预见的故障时，为用户提供持续可用的桌面服务，保障业务连续性。 跨资源池灾备 AI云电脑所在资源池出现异常故障时，可自动切换使用备资源池的灾备AI云电脑。 业务连续性 提供一致的AI云电脑的服务，用户可持续开展业务工作。

本节介绍云智助手支持企业自有大模型配置的功能。 天翼AI云电脑云智助手，提供支持企业新增自有大模型功能。用户将大模型的API地址和APIKey配置后即可在AI助手进行会话。 【操作步骤】 1.使用管理员账号登录AI云电脑，打开云智助手，点击右上角个人头像，打开“设置”功能；（如无管理员账号，请先创建账号，详见管理账号） 2.打开设置页面，点击“基础设置”，选择企业名称，点击新增，添加自己的大模型； 3.新增自有大模型，需要确认并填写以下字段： 大模型显示名称+描述：设置后将会显示在大模型切换列表，名称和描述建议体现企业元素，品牌辨识度更高。 大模型类型：支持选择“官方平台DeepSeek”、“百度平台DeepSeek”、“自有平台DeepSeek”三个选项，如有需求可联系我们拓展更多平台的DeepSeek大模型的支持。 API地址：需填写支持公网访问API地址，API地址格式推荐：{baseurl}/chat/completions。如无法公网访问，请联系天翼云售前人员提供内网解决方案。 Model名称：需填写大模型的Medel名称，可查看相关的接口文档。 APIKey：需填写大模型开放平台申请的有效的APIKey。 4.自有大模型添加后，企业用户在AI助手会话时，可选择自有大模型进行聊天，开启专属大模型智能体验。

本节介绍虚拟电教室的教师机客户端使用指南。 管理学生机上课、下课、广播 前置条件：创建虚拟教室，已经完成教师机和学习机终端绑定。 1.登录教室内终端设备的天翼AI云电脑客户端； 2.进入对应的桌面，点击上方工具栏，点击“电教室”，可查看上课、下课、切换、广播的功能入口。 上课：教师选择镜像后开始上课，支持唤醒局域网同教室学生机，连接桌面后重装。 下课：关闭学生机终端和虚机。 切换：学生在线时，教师选择镜像后，学生桌面进入重装。 广播：广播教师桌面，可控制音频，学生演示，全屏化。 开启终端：启动学生机终端。 关闭终端：关闭学生机终端。