让 Agent 用上真实手机：优测云真机 MCP 与 Skills 接入方法

优测平台针对云真机的相关能力，通过Ubox产品包装了对应的 Skill 和 CLI 工具，目的是希望达成“人使用云真机”向“AI agent使用云真机”的飞跃

场景化解决方案举例：云真机SKILL可用于日常终端开发，对不同机型的兼容性适配验证场景，解决本地没有手机设备，并且希望用workBuddy等AI agent智能场景验证的问题。

一、接入后，Agent 和云真机分别做什么

一条完整调用链可以拆成两部分：

自然语言任务
    ↓
Agent 引擎
理解目标、识别页面、规划步骤、判断结果
    ↓
UBox Skill + CLI
完成工具发现、鉴权、参数转换和设备调用
    ↓
优测 UBox 云真机服务
分配设备、执行操作、返回截图和日志
    ↓
Android / iOS / HarmonyOS 真实设备

Agent 引擎可以由团队自建，也可以使用 WorkBuddy、CodeBuddy 等现成工具。它负责“想清楚做什么”。云真机是执行引擎，负责“在真实设备上完成动作”。UBox MCP Server 或 Skill 位于两者之间，把设备查询、连接、操作、截图和日志等能力交给 Agent 调用。

二、接入方法：通过 UBox Skills 接入

Skill 方式把云真机的使用说明、调用约定和 CLI 能力打包成一个技能目录。Agent 加载后，可以根据技能描述判断何时调用云真机，并把自然语言任务交给配套 CLI 执行。根据接入指引，完整流程分为申请凭证、准备云真机资源、获取 Skill 包、加载 Skill 和首次调用。

2.1 申请 Token

联系优测客服，沟通使用场景后由平台侧分配具体 Token 即可使用，需要提供的信息如下：

注册账号：登录优测官网，注册账号并创建团队。
提供团队 ID：访问云真机页面，右上角的团队信息截图，例如：

团队信息示例

平台为您下发 Token，例如：

{
  // 联系官网助手申请 user_token
  "user_token": "",

  // 联系官网助手申请 project_token
  "project_token": "",

  // 登录优测网站，右上角复制团队 ID group_id
  "group_id": ""
}

2.2 云真机产品充值

背景：云真机 SKILL 是通过云真机的能力进行计费，计费标准与云真机完全一致，因此需要在优测官网充值云真机产品。

购买页：云真机产品购买页

您也可以选择在优测注册后，完成邮箱验证，即可获得 10 分钟云真机体验时长。

2.3 获取 SKILL

平台客服会单独发给您对应的 SKILL 包，获取后解压到本地：

SKILL 包示例

三、使用流程

3.1 预期说明

智能体引擎：客户自建 AI Agent，或使用 CodeBuddy、WorkBuddy 等。这部分主要负责对设备页面进行智能识别和调用云真机 SKILL。
执行引擎（云真机设备）：云真机 SKILL 主要负责被智能体引擎发现和调用，并实现云真机调用能力，让您的智能体引擎可以调用到优测云真机。