ブラックフライデーチャージボーナス
対象のチャージごとに無料クレジットが付き、他の特典とも併用できます。
11月30日まで
スクリプト化されたUIテストはボタンが動くたびに壊れ、リリースのたびに同じフローを人がタップして回るのはスケールしません。代わりにAIエージェントにタップさせられます。テストを平易な言葉で書けば(「このメールアドレスでサインアップし、カートに商品を追加し、合計を確認する」)、エージェントは画面を読み、タップし、入力し、スクロールして、やり遂げるか、できないと判断するまで進みます。Lovely Routerのクラウドフォンはクラウド上の実機Android 14端末です。APKをインストールし、/v1/phones にテスト目標を送ると、合否、エージェントの回答、実行したすべてのステップを取得できます。端末の料金は起動中1時間あたり$1.20、分単位の課金で、スリープ中は無料です。
AI エージェントに任せる
このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。
Upload my Android build to a Lovely Router cloud phone and run a short suite of plain-language test goals against it, reporting pass or fail with the agent's steps. - Docs (read first): https://lovelyrouter.com/docs/phone.md and https://lovelyrouter.com/docs/api/phones.md - Create a phone, upload and install the APK, start one agent run per test goal and poll it; collect each run's steps and final answer. Delete the phone at the end (billed while awake). - Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys. - Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large. - Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt. My task: <the APK and the test flows to check>
仕組み
ビルドをアップロードする
PUT /v1/phones/apks/{name}でAPKを一度保存します。1リクエストあたり最大100 MB、50 MBのパートに分ければ最大500 MBです。分割バンドル(.apks、.xapk)も使えます。同じ名前でアップロードするとファイルが置き換わるので、CIは新しいビルドを毎回同じ名前でプッシュできます。アプリを入れて端末を起動する
appsにAPKを指定して端末を作成します。新しい端末の起動には約1分、インストール中はもう少し長くかかります。startup_appsフィールドには、各インストールが成功したかどうかと、インストールされたパッケージが入ります。各テストをゴールとして実行する
各テストは、必要な値をすべて添えた平易な言葉のゴールとして
POST /v1/phones/{id}/runsに送ります。エージェントがゴールに到達すると実行はsucceededで終わり、到達できないと判断するとfailedで終わり、理由がanswerに入ります。trace=1を付けると各ステップが返ります。
APKに対してテストゴールを実行する
ビルドをアップロードし、それを入れた端末を起動して、準備ができるまで待ちます:
curl -X PUT https://lovelyrouter.com/v1/phones/apks/myapp-latest.apk \
-H "Authorization: Bearer $LOVELY_API_KEY" \
--data-binary @app/build/outputs/apk/release/app-release.apk
curl https://lovelyrouter.com/v1/phones \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{"apps": ["myapp-latest.apk"], "name": "release-check", "wait": 50}'次に、同じ端末へテストを順番に送ります。このPythonスクリプトは短いスイートを実行し、テストごとに結果を出力します:
import os, requests
API = "https://lovelyrouter.com/v1/phones"
H = {"Authorization": f"Bearer {os.environ['LOVELY_API_KEY']}"}
PHONE = "ph_..." # the id from POST /v1/phones
TESTS = {
"signup": "Open MyApp. Sign up with the email qa+signup@example.com and the password Test-1234. "
"Pass if the home screen greets the new user; report the greeting.",
"cart": "Open MyApp, search for 'blue mug', add the first result to the cart and open the cart. "
"Report the item name, quantity and total exactly as shown.",
"settings": "Open MyApp's settings, switch the language to German and go back to the home screen. "
"Pass only if the home screen is now in German.",
}
for name, goal in TESTS.items():
run = requests.post(f"{API}/{PHONE}/runs", headers=H, json={"goal": goal, "max_steps": 40}).json()
while run["status"] in ("queued", "running"):
run = requests.get(f"{API}/runs/{run['id']}", headers=H, params={"wait": 50}).json()
if run["status"] == "waiting":
print(name, "needs a person:", run["question"])
continue
trace = requests.get(f"{API}/runs/{run['id']}", headers=H, params={"trace": 1}).json()["trace"]
print(f"{name:<10} {run['status']:<10} {run['steps']:>3} steps {run['answer'] or run['error']}")
for s in trace:
if not s["ok"] or s.get("unchanged"):
print(" step", s["step"], s["action"], s.get("error") or "screen did not change", "-", s["note"])端末は一度に1つのゴールを実行するので、テストは順番に進みます。混み合っている端末への2つ目の実行は 409 になります。並列にテストするには端末を増やします。各アカウントは同時に3台まで持てます。
エージェントがテストを進める仕組み
デフォルトの smart モードでは、各ステップはチャットモデルによる1回のツール呼び出しです。モデルは画面上の要素(Androidのビューツリーから取得し、それぞれ位置と clickable や editable などのフラグ付き)とスクリーンショットを受け取り、ちょうど1つのツールを呼びます: 操作には tap、long_press、swipe、scroll、type、key、open_url、launch、wait、質問には ask_user、回答を添えて終了するには done です。各ステップは、見た内容と行動した理由、アクション、前面のアプリ、成功したかどうかを note に記録し、アクションで画面がまったく変わらなかった場合は unchanged: true を記録します。
デフォルトのモデルは gemini-3.8-flash です。モデル一覧にある任意のチャットモデルを model として渡せます。そのトークンは通常のAPI料金で課金され、実行結果は llm_usd に報告されます。実行はデフォルトで最大40ステップ、max_steps で最大200ステップまでです。上限に達した実行は stopped で終わります。
ゴールはテストケースのように書きます。 必要な値(アカウント、検索語、期待するテキスト)をすべてエージェントに渡し、何をもって合格とするかを伝えます:「合計がユーロで表示されたら合格」。エージェントは見た内容を answer で報告するので、アサートしたいテキストをコピーさせ、コード側で検証します。
ログイン、認証コード、人による介入
SMSで届くコードが必要なテストアカウントや、人だけが承認すべきフローも飛ばさずに済みます。エージェントが ask_user を呼ぶと実行は question 付きの waiting になり、POST /v1/phones/runs/{id}/reply で答えます。あるいはライブ画面を開いて手動でステップをこなし、done と返信します。
POST /v1/phones/{id}/screen は端末のライブ画面へのリンクを返します。プラグインなしでどのブラウザでも開け、自分のダッシュボードのiframeに埋め込むこともでき、リンクを持つ人は誰でも視聴・タップできます。そのため、端末を使うべき人にだけ共有してください。端末コンソールならコードなしで同じことができます。
エージェントは、ゴールに書かれていない限り、支払い、送金、データ削除、公開投稿は行いません。それでもチェックアウトのフローにはテストアカウントとサンドボックスの決済環境を使ってください。
スクリーンショット、リセット、ログ
エージェントの実行の合間に、自分のコードで端末を直接操作できます(直接操作):
GET /v1/phones/{id}/screenshotは画面をテストレポート用にWebPで保存します。短辺540ピクセルです。POST /v1/phones/{id}/actionsに{"action": "shell", "command": "pm clear com.example.myapp"}を送ると、次のテストの前にアプリのデータをリセットできます。logcat -d -t 300 *:Eは最新のエラーをoutputで返します。{"action": "launch", "package": "com.example.myapp"}はアプリを開始画面で開きます。{"action": "rotate", "orientation": "landscape"}は横向きレイアウトを確認します。
curl https://lovelyrouter.com/v1/phones/ph_.../actions \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{"action": "shell", "command": "logcat -d -t 300 *:E"}'すでにアプリが入っている端末に新しいビルドをインストールすると更新になります。POST /v1/phones/{id}/apps に {"apk": "myapp-latest.apk"} を送ると、インストール完了時に返ります。
得意なこと、苦手なこと
AIテストは人が使うフローに向いています: オンボーディング、検索、チェックアウト、設定、一文で説明できるリグレッション。固定のビューIDを探すのではなく、エージェントが各ステップで画面を読むため、レイアウトが変わっても動き続けます。スクリプトテストより遅く(smartモードで1ステップ数秒)、画面に映っているもので判断するので、ピクセル単位の比較やタイミングの検証は自分のテストコードに任せましょう。どの端末もクラウド上の同じAndroid 14端末で、Google Play servicesは入っていますがPlay Storeはありません。そのため、さまざまな実機やAndroidバージョンでのテストを置き換えるものではありません。
料金
| 料金 | |
|---|---|
| 起動中の端末 | 1時間あたり$1.20、分単位の課金 |
| スリープ中の端末 | 無料 |
| エージェント実行 | 通常のAPI料金でチャットモデルのトークン |
| アップロードしたAPK | 最初の1 GBは無料、その後は1か月あたり1 GB $0.30 |
端末は5分間使われないとスリープし、約2秒で画面をそのままに復帰します。1時間使われなかった端末はアプリとデータごと削除されます。スイートが終わったら DELETE /v1/phones/{id} で自分で削除してください。端末の起動には残高に15分分の端末時間が必要です。同じプリペイドキーでモデル、データツール、クラウドエージェントを購読なしで支払えます。
よくある質問
ストアにない自分のAPKをテストできますか+
はい。PUT /v1/phones/apks/{name} でアップロードし、名前でインストールします。または apps にファイルへの https:// リンクを記載します。どんなAPKでも動き、.apks や .xapk バンドルも同様です。
テストが合格したかどうかを知るには+
エージェントがゴールに到達すると実行は succeeded、到達できないと判断すると failed で終わり、理由が answer または error に入ります。気になるテキストを報告させ、自分のコードでアサートしてください。
各ステップでエージェントが何をしたか見られますか+
はい。GET /v1/phones/runs/{id}?trace=1 は各ステップのアクション、見た内容と理由のメモ、成功したか、画面が変わったかどうかを返します。レポート用のスクリーンショットはスクリーンショットエンドポイントで取得します。
アプリが認証コードを要求したらどうなりますか+
エージェントがあなたに尋ねます。実行は question 付きの waiting になり、返信すると続行します。ライブ画面で自分でステップを終わらせることもできます。
テストを並列実行できますか+
各端末は一度に1つのゴールを実行し、各アカウントは同時に3台まで持てるので、最大3つのテストが並行して進みます。
iOSアプリでも動きますか+
いいえ。クラウドフォンはAndroid 14のみです。
代わりに端末でゲームをプレイするエージェントが欲しい場合は、AIゲームプレイエージェントをご覧ください。すべてのエンドポイントとフィールドはphone APIリファレンスにあり、ブラウザエージェントはWebアプリに対して同じことを行います。