ブラックフライデーチャージボーナス·$50以上のチャージで$10プレゼント · $100以上のチャージで$25プレゼント·11月30日までチャージ →
ユースケース

ブラウザとAndroid端末を備えたクラウドAIエージェント

ホスト型AIエージェントに、Webサイト用の本物のブラウザとアプリ用のクラウドAndroid端末を与え、1つのAPIキーと1つの残高で両方をまたいで作業させます。

最終更新日 2026-11-05

プリペイド、サブスクなしREST でも MCP でもモデル・データ・エージェントを 1 つのキーで
portal.example.com/apply氏名Ada Lovelaceメールアドレスada@example.comパスワード••••••••••2FA コード492 817送信agentopen pagetype nametype emailfill passwordenter 2FAclick Submit✓ done
ブラックフライデー

ブラックフライデーチャージボーナス

対象のチャージごとに無料クレジットが付き、他の特典とも併用できます。

11月30日まで

$50をチャージ
+$10
20%ボーナス
$100をチャージ
+$25
25%ボーナス
登録して受け取る

Webとアプリの境界をまたぐ作業は数多くあります。サービスのWebサイトでの提供内容と、そのAndroidアプリでの表示を比べる。Webのダッシュボードで何かを設定し、それが端末に反映されたか確認する。一方で注文を読み、もう一方でそれに対応する。ブラウザしか持たない、あるいは端末しか持たないエージェントでは、こうした作業の半分しかこなせません。Lovely Router はその両方を備えています。それぞれ専用のサンドボックスで動き、ブラウザエージェントを通じて本物のブラウザを操作するクラウドエージェントと、専用の端末エージェントを備えた本物のAndroid 14端末であるクラウドフォンです。このページでは、今日それらを組み合わせる方法を示し、どの部分が組み込みで、どの部分を自分でつなぐのかを正確に説明します。

AI エージェントに任せる

このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。

Create a Lovely Router cloud agent that does the web part of a task with its browser tools, run the app part on a cloud phone, and combine the answers.

- Docs (read first): https://lovelyrouter.com/docs/agents.md and https://lovelyrouter.com/docs/api/agents.md and https://lovelyrouter.com/docs/api/phones.md
- Cloud agent: POST https://lovelyrouter.com/v1/agents, then POST .../<id>/runs with the task (it has the browser agent among its tools). Phone: create one with POST https://lovelyrouter.com/v1/phones and start an agent run there from this project; pass the phone's answer into the next agent run.
- 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 website, the app and what to compare or do on each>
01

組み込みの機能と、自分でつなぐ部分

search_toolsrun_toolget_run
要素エージェントがそこに到達する方法
ブラウザ組み込みです。すべてのクラウドエージェントは、Web検索、ページ読み取り、データツールに加えて、ブラウザエージェントをMCPツール(browser_run、browser_status、browser_reply、browser_takeover)として利用できます。
Web検索、ページ読み取り、データツール、画像同じサーバー上のMCPツールとして組み込まれています。
Android端末エージェントの組み込みツールではありません。アプリ側で /v1/phones を通じて端末を動かすか、自前のMCPサーバーを通じてエージェントに端末ツールを与えます。

どちらの方法も同じAPIキーと前払い残高を使うため、エージェントのサンドボックス時間、モデルのトークン、ブラウザのステップ、端末の利用時間はすべて1つのアカウントから引かれます。

02

パターン1: アプリ側でエージェントと端末を動かす

最もシンプルな構成では、バックエンドが主導権を握ります。Web側の作業は実行としてクラウドエージェントに送り、アプリ側の作業はゴールとして端末に送り、それぞれの結果をもう一方に渡します。クラウドエージェントのruns APIはセッションを保持するので、後続の実行は同じ会話を続けます。

  1. Web側の作業をエージェントに依頼する

    タスクを指定して POST /v1/agents/{id}/runs を呼びます。クリックして進む必要があるページには browser_run を、読むだけでよいページには web_fetch を使うかはエージェントが判断します。

  2. 端末にゴールを渡す

    エージェントの回答から組み立てたゴールと、apps にアプリのAPKを指定して POST /v1/phones/runs を呼びます。実行が終わるまでポーリングします。

  3. 端末の回答をエージェントに戻す

    端末の answer を、最初の実行の session_id を付けた2回目の実行でエージェントに送ります。これにより、エージェントはすでに把握しているすべてを踏まえて比較し、報告し、あるいは作業を続けます。

Python
import os, requests

BASE = "https://lovelyrouter.com/v1"
H = {"Authorization": f"Bearer {os.environ['LOVELY_API_KEY']}"}

agent = requests.post(f"{BASE}/agents", headers=H, json={"name": "web-and-app check"}).json()

# 1. The web part: the agent uses its browser tools.
web = requests.post(f"{BASE}/agents/{agent['id']}/runs", headers=H, timeout=320, json={
    "input": "Open https://example.com/plans in the browser. List every plan's name and what it includes, "
             "as a JSON array of {plan, features}. Reply with the JSON only.",
    "wait": 300,
}).json()

# 2. The app part: a phone with the app installed works a goal built from that answer.
phone_run = requests.post(f"{BASE}/phones/runs", headers=H, json={
    "goal": "Open the Example app, go to the plans or upgrade screen, and list every plan's name and "
            "what it includes, exactly as the app shows them.",
    "apps": ["example-app.apk"],
}).json()
while phone_run["status"] in ("queued", "running"):
    phone_run = requests.get(f"{BASE}/phones/runs/{phone_run['id']}", headers=H, params={"wait": 50}).json()

# 3. Back to the agent, in the same session.
report = requests.post(f"{BASE}/agents/{agent['id']}/runs", headers=H, timeout=320, json={
    "input": "Here is what the Android app shows:\n" + (phone_run["answer"] or phone_run["error"] or "")
             + "\nCompare it with the website's plans you found. Write compare.md and present it.",
    "session_id": web["session_id"],
    "wait": 300,
}).json()
print(report["output"])
for f in report["files"]:
    print(f["path"], f["url"])

wait 以内に終わらなかった実行は未完了のまま返ります。GET /v1/agents/{id}/runs/{run_id}?wait=30 で再度読み取るか、"stream": true を送ってイベントを発生順に追ってください。停止したエージェントは実行のために自動で起き上がり、最後の実行が終わってから約5秒後に停止するので、このようなパターンのステップの合間にはコストがかかりません。端末は実行後も、アプリとログイン状態を含めて1時間アイドルになるまで自分のものとして残ります。次のゴールは POST /v1/phones/{phone_id}/runs で送ってください。

03

パターン2: エージェントに専用の端末ツールを与える

エージェント自身に端末が必要なタイミングを判断させるには、端末ツールを与えます。各クラウドエージェントは、自前のリモートMCPサーバーを最大8つまで登録できます(ストリーミングHTTP、公開 https:// URL、任意のヘッダーは暗号化して保存)。自分のキーで /v1/phones をラップする小さなMCPサーバーをホストし、それをエージェントに追加します:

cURL
curl -X PATCH https://lovelyrouter.com/v1/agents/agt_... \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"mcp_servers": [{"name": "phone", "url": "https://tools.yourcompany.com/mcp",
        "headers": {"Authorization": "Bearer your-own-server-secret"}}]}'

公式MCP Python SDKを使った最小限のサーバーなら、端末上でゴールを実行して回答を返すツールを1つ公開できます:

Python (your MCP server)
import os, time, requests
from mcp.server.fastmcp import FastMCP

API = "https://lovelyrouter.com/v1/phones"
H = {"Authorization": f"Bearer {os.environ['LOVELY_API_KEY']}"}
mcp = FastMCP("phone")

@mcp.tool()
def phone_goal(goal: str, phone_id: str = "") -> str:
    """Work a goal on a cloud Android phone and return the answer. Pass phone_id to reuse a phone."""
    body = {"goal": goal, "wait": 50, **({"phone_id": phone_id} if phone_id else {"apps": ["example-app.apk"]})}
    run = requests.post(f"{API}/runs", headers=H, json=body, timeout=70).json()
    while run["status"] in ("queued", "running"):
        run = requests.get(f"{API}/runs/{run['id']}", headers=H, params={"wait": 50}, timeout=70).json()
    return f"phone {run['phone_id']}: {run['status']}: {run.get('question') or run['answer'] or run['error']}"

mcp.run(transport="streamable-http")

HTTPSの背後に置き、すべてのリクエストでヘッダーを検証してください。サーバーに到達できる人は誰でもあなたの残高から消費できます。設定はエージェントの次回起動から適用されます。サーバーからの端末呼び出しはあなたのキーを使うため、エージェント自身の予算ではなく、そのキーの制限に計上されます。多くのMCPクライアントは約1分でツール呼び出しを諦めます。長い端末ゴールでは、待つのではなくIDで実行を読み取る2つ目のツールが必要になることがあります。

04

ブラウザ側の詳細

エージェント内部では、browser_run がゴールと開始URLから実行を開始し、約45秒後にその状態を返します。browser_status はさらに待ちます。実行は構造化データ(output_schema)を返したり、Vault内のシークレットを名前で使ってログインしたり、人の介入のために一時停止したりできます。browser_reply は質問に答え、browser_takeover はライブビュー付きでブラウザを人に引き渡します。ブラウザはクラウドで動き、localhost やプライベートアドレスは開けないため、公開サイトでは動作しますが、エージェントが自分のサンドボックス内で起動したサーバーには使えません。エージェントのセッションが終わると、それが開始したブラウザ実行も停止します。モードと制限についてはブラウザエージェントのドキュメントを参照してください。

05

端末側の詳細

端末の実行は、平易な言葉で書かれたゴールを処理します。デフォルトの smart モードではチャットモデルがステップごとに1つのアクション(タップ、入力、スワイプ、スクロール、アプリの起動など)を呼び出し、fast モードでは高速な判断モデルが隣のコーチとともにステップを選びます。SMSで届くコードなど、人にしか持てない情報が必要になると、実行は question を伴って waiting になります。コード側は POST /v1/phones/runs/{id}/reply で回答します。POST /v1/phones/{id}/screen は、人が閲覧したり引き継いだりできるライブ画面リンクを返します。アプリはAPKファイルから導入します。.apk、.apks、.xapk のいずれでも、リンク指定でも一度のアップロードでもかまいません。詳しくは端末のドキュメントを参照してください。

06

料金

料金
クラウドエージェントのサンドボックス(スモール)実行中1時間あたり $0.05、秒単位で課金
ブラウザエージェントfastモードで1ステップあたり $0.006、accurateモードで $0.012
端末起動中の1時間あたり $1.20、分単位で課金。スリープ中は無料
モデルエージェントと端末エージェントのトークンは通常のAPI料金

サブスクリプションはありません。クラウドエージェントには予算を設定でき、サンドボックス時間と自身のモデル・ツール消費の合計がそれに達すると停止します。端末は1アカウントにつき同時3台、エージェントは同時20実行までです。1つの前払い残高が上記すべてと、データツールの支払いに使われます。

07

よくある質問

?
クラウドエージェントは自分で端末を使えますか+

そのままでは使えません。端末は組み込みツールに含まれていません。アプリ側で端末を動かして結果をエージェントに渡すか、自分のキーで /v1/phones を呼ぶ自前のMCPサーバーを通じてエージェントに端末ツールを与えてください。

クラウドエージェントはブラウザを持っていますか+

はい。設定でツールをオフにしない限り、すべてのクラウドエージェントがブラウザエージェントをMCPツールとして利用でき、Web検索、ページ読み取り、データツールも備わっています。

どちらの側でも人が介入できますか+

はい。ブラウザの実行は人の回答のために一時停止したり、ライブビュー付きでブラウザを引き渡したりできます。端末の実行も質問を投げかけたり、ライブ画面リンクから引き継いだりできます。

すべて1つのアカウントに課金されますか+

はい。エージェントのサンドボックス、そのモデルとツールの呼び出し、ブラウザのステップ、端末の利用時間は、すべて同じ前払い残高から引かれます。

自分の各ユーザーごとにこれを実行できますか+

はい。ユーザーごとに、user にそのユーザーの自前のIDを指定してエージェントを1つ作成し、そのユーザーの端末を作成するときにも同じIDを渡してください。これにより、ユーザーごとのエージェントと端末を一覧できます。

自社ブランドでユーザーに提供するエージェントについてはホワイトラベルエージェントを、自分のアプリを端末でテストする方法についてはAIモバイルアプリテストを参照してください。

モデル・データ・エージェントを 1 つのプリペイドキーで

サブスクリプションなし。チャージして必要な分だけ使い、すべての請求をログで確認できます。