mobile-use-setup

Mobile-Use SDK 设置

设置 mobile-use，使 Agent 在本地对选定的设备运行。

收集需求

只询问尚未提供的信息：

1. 目标：iOS、Android 或两者。
2. 设备路径：本地实体设备／模拟器、BrowserStack 或 Minitap 云设备。
3. LLM 提供商：Minitap API、OpenAI、Anthropic、Google、OpenRouter、本地模型或其他受支持的提供商。

检查先决条件

python3 --version  # Requires 3.12+
which uv

# Android local
which adb
adb devices

# iOS simulator
which idb_companion
xcrun simctl list devices

# iOS physical
which idevice_id
which appium
appium driver list

对于缺失的依赖项，请使用此技能中针对特定设备的参考文件。

创建项目

uv init <project-name>
cd <project-name>
uv add minitap-mobile-use python-dotenv
cp llm-config.override.template.jsonc llm-config.override.jsonc

在 llm-config.override.jsonc 中配置选定的提供商，并仅将所需的提供商密钥放入 .env。将 .env 添加到 .gitignore。

创建起始代码

生成可在本地运行 Agent 的任务代码：

import asyncio

from dotenv import load_dotenv

from minitap.mobile_use.sdk import Agent
from minitap.mobile_use.sdk.builders import Builders
from minitap.mobile_use.sdk.types import AgentProfile

load_dotenv()


async def main() -> None:
    profile = AgentProfile(name="default", from_file="llm-config.override.jsonc")
    config = Builders.AgentConfig.with_default_profile(profile).build()
    agent = Agent(config=config)

    try:
        await agent.init()
        result = await agent.run_task(goal="Your automation goal", name="first-task")
        print(result)
    finally:
        await agent.clean()


if __name__ == "__main__":
    asyncio.run(main())

选用 BrowserStack 或 for_cloud_device(...) 构建器 API 时，请扩展 config。

验证

确认可以看到选定的设备，然后运行：

uv run python -c "from minitap.mobile_use.sdk import Agent; print('SDK OK')"
uv run python main.py

根据实际命令输出诊断设置失败问题。不要悄悄切换设备路径。