Overview
Tool identifiermobile_run.
create_mobile_use_tool() returns a tool that lets the agent complete operation tasks on a cloud phone.
Import path: from veadk.tools.builtin_tools.mobile_run import create_mobile_use_tool
Environment & prerequisites
Environment variables:MODEL_AGENT_API_KEY: API key for the agent’s reasoning modelTOOL_MOBILE_USE_TOOL_ID: cloud-phone instance ID, in the formproduct_id-pod_idVOLCENGINE_ACCESS_KEY/VOLCENGINE_SECRET_KEY: Volcengine AK / SK
tool_id is in the form product_id-pod_id; obtain it from the instance-management page of the cloud-phone console.
Set environment variables before importing the module. TOOL_MOBILE_USE_TOOL_ID must contain a text representation of a string list, including for a single device:
product_id-pod_id format for each item, with devices from the same product. This tool reads Volcengine credentials and uses its cloud-phone endpoint; CLOUD_PROVIDER does not switch it automatically. Logged-in accounts perform real actions, so this example limits operations to opening the app and searching.
Usage
examples/tools/mobile_run/agent.py
Parameters and results
The returned async tool requires
user_prompts: list[str]. Put consecutive actions that must use one device in a single string. Split only independent work into multiple items. Results follow input order and contain success, failure, or error messages. Inspect each result rather than checking only that the list is nonempty.