mobile-use-setup

Mobile-Use SDK のセットアップ

モバイル用をセットアップして、選択したデバイス上でエージェントがローカルに実行されるようにします。

必要な情報を確認する

すでに提供されている情報については尋ねず、未提供の情報のみ確認します。

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 に追加します。

スターターを作成する

エージェントをローカルで実行するタスクコードを生成します。

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

セットアップの失敗は、実際のコマンド出力をもとに診断します。デバイスの接続先を勝手に切り替えないでください。