Skip to main content

功能说明

对应工具标识 mobile_run。 create_mobile_use_tool() 返回一个让智能体在云手机上完成操作任务的工具。 导入路径:from veadk.tools.builtin_tools.mobile_run import create_mobile_use_tool

环境变量与前提

附加要求:
  1. 在火山引擎购买云手机服务并订购 pod;
  2. 按需在云手机上配置环境(安装 App、登录账号等)。
环境变量:
  • MODEL_AGENT_API_KEY:智能体推理模型的 API Key
  • TOOL_MOBILE_USE_TOOL_ID:云手机实例 ID,格式为 product_id-pod_id
  • VOLCENGINE_ACCESS_KEY / VOLCENGINE_SECRET_KEY:火山引擎 AK / SK
tool_id 格式为 product_id-pod_id,在云手机控制台的实例管理界面获取。 在导入模块前设置环境变量。TOOL_MOBILE_USE_TOOL_ID 必须是字符串列表的文本表示,即使只有一个设备也应写成:
每个元素按控制台的 product_id-pod_id 格式填写,多个实例需属于同一产品。该工具读取火山引擎凭证并使用云手机服务端点,不随 CLOUD_PROVIDER 自动切换。云手机已登录的账户会执行真实操作,示例将权限限制为打开应用与搜索

使用方法

examples/tools/mobile_run/agent.py

参数与结果

返回的异步工具接收 user_prompts: list[str],没有默认值。同一设备上连续完成的操作应写在一个字符串中;只有可独立执行的工作才拆为多个元素。返回列表与输入顺序对应,各元素是任务成功、失败或异常的说明,应逐项检查,不要仅判断列表非空
最后修改于 2026年9月19日