功能说明
对应工具标识mobile_run。
create_mobile_use_tool() 返回一个让智能体在云手机上完成操作任务的工具。
导入路径:from veadk.tools.builtin_tools.mobile_run import create_mobile_use_tool
环境变量与前提
环境变量:MODEL_AGENT_API_KEY:智能体推理模型的 API KeyTOOL_MOBILE_USE_TOOL_ID:云手机实例 ID,格式为product_id-pod_idVOLCENGINE_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],没有默认值。同一设备上连续完成的操作应写在一个字符串中;只有可独立执行的工作才拆为多个元素。返回列表与输入顺序对应,各元素是任务成功、失败或异常的说明,应逐项检查,不要仅判断列表非空