Skip to main content

Overview

Tool identifier mobile_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

Requirements:
  1. Purchase the cloud-phone service on Volcengine and order a pod.
  2. Configure the cloud-phone environment as needed (install apps, sign in, and so on).
Environment variables:
  • MODEL_AGENT_API_KEY: API key for the agent’s reasoning model
  • TOOL_MOBILE_USE_TOOL_ID: cloud-phone instance ID, in the form product_id-pod_id
  • VOLCENGINE_ACCESS_KEY / VOLCENGINE_SECRET_KEY: Volcengine AK / SK
The 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:
Use the console’s 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.
Last modified on September 19, 2026