ブラックフライデーチャージボーナス
対象のチャージごとに無料クレジットが付き、他の特典とも併用できます。
11月30日まで
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>
組み込みの機能と、自分でつなぐ部分
| 要素 | エージェントがそこに到達する方法 |
|---|---|
| ブラウザ | 組み込みです。すべてのクラウドエージェントは、Web検索、ページ読み取り、データツールに加えて、ブラウザエージェントをMCPツール(browser_run、browser_status、browser_reply、browser_takeover)として利用できます。 |
| Web検索、ページ読み取り、データツール、画像 | 同じサーバー上のMCPツールとして組み込まれています。 |
| Android端末 | エージェントの組み込みツールではありません。アプリ側で /v1/phones を通じて端末を動かすか、自前のMCPサーバーを通じてエージェントに端末ツールを与えます。 |
どちらの方法も同じAPIキーと前払い残高を使うため、エージェントのサンドボックス時間、モデルのトークン、ブラウザのステップ、端末の利用時間はすべて1つのアカウントから引かれます。
パターン1: アプリ側でエージェントと端末を動かす
最もシンプルな構成では、バックエンドが主導権を握ります。Web側の作業は実行としてクラウドエージェントに送り、アプリ側の作業はゴールとして端末に送り、それぞれの結果をもう一方に渡します。クラウドエージェントのruns APIはセッションを保持するので、後続の実行は同じ会話を続けます。
Web側の作業をエージェントに依頼する
タスクを指定して
POST /v1/agents/{id}/runsを呼びます。クリックして進む必要があるページにはbrowser_runを、読むだけでよいページにはweb_fetchを使うかはエージェントが判断します。端末にゴールを渡す
エージェントの回答から組み立てたゴールと、
appsにアプリのAPKを指定してPOST /v1/phones/runsを呼びます。実行が終わるまでポーリングします。端末の回答をエージェントに戻す
端末の
answerを、最初の実行のsession_idを付けた2回目の実行でエージェントに送ります。これにより、エージェントはすでに把握しているすべてを踏まえて比較し、報告し、あるいは作業を続けます。
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 で送ってください。
パターン2: エージェントに専用の端末ツールを与える
エージェント自身に端末が必要なタイミングを判断させるには、端末ツールを与えます。各クラウドエージェントは、自前のリモートMCPサーバーを最大8つまで登録できます(ストリーミングHTTP、公開 https:// URL、任意のヘッダーは暗号化して保存)。自分のキーで /v1/phones をラップする小さなMCPサーバーをホストし、それをエージェントに追加します:
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つ公開できます:
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つ目のツールが必要になることがあります。
ブラウザ側の詳細
エージェント内部では、browser_run がゴールと開始URLから実行を開始し、約45秒後にその状態を返します。browser_status はさらに待ちます。実行は構造化データ(output_schema)を返したり、Vault内のシークレットを名前で使ってログインしたり、人の介入のために一時停止したりできます。browser_reply は質問に答え、browser_takeover はライブビュー付きでブラウザを人に引き渡します。ブラウザはクラウドで動き、localhost やプライベートアドレスは開けないため、公開サイトでは動作しますが、エージェントが自分のサンドボックス内で起動したサーバーには使えません。エージェントのセッションが終わると、それが開始したブラウザ実行も停止します。モードと制限についてはブラウザエージェントのドキュメントを参照してください。
端末側の詳細
端末の実行は、平易な言葉で書かれたゴールを処理します。デフォルトの smart モードではチャットモデルがステップごとに1つのアクション(タップ、入力、スワイプ、スクロール、アプリの起動など)を呼び出し、fast モードでは高速な判断モデルが隣のコーチとともにステップを選びます。SMSで届くコードなど、人にしか持てない情報が必要になると、実行は question を伴って waiting になります。コード側は POST /v1/phones/runs/{id}/reply で回答します。POST /v1/phones/{id}/screen は、人が閲覧したり引き継いだりできるライブ画面リンクを返します。アプリはAPKファイルから導入します。.apk、.apks、.xapk のいずれでも、リンク指定でも一度のアップロードでもかまいません。詳しくは端末のドキュメントを参照してください。
料金
| 料金 | |
|---|---|
| クラウドエージェントのサンドボックス(スモール) | 実行中1時間あたり $0.05、秒単位で課金 |
| ブラウザエージェント | fastモードで1ステップあたり $0.006、accurateモードで $0.012 |
| 端末 | 起動中の1時間あたり $1.20、分単位で課金。スリープ中は無料 |
| モデル | エージェントと端末エージェントのトークンは通常のAPI料金 |
サブスクリプションはありません。クラウドエージェントには予算を設定でき、サンドボックス時間と自身のモデル・ツール消費の合計がそれに達すると停止します。端末は1アカウントにつき同時3台、エージェントは同時20実行までです。1つの前払い残高が上記すべてと、データツールの支払いに使われます。
よくある質問
クラウドエージェントは自分で端末を使えますか+
そのままでは使えません。端末は組み込みツールに含まれていません。アプリ側で端末を動かして結果をエージェントに渡すか、自分のキーで /v1/phones を呼ぶ自前のMCPサーバーを通じてエージェントに端末ツールを与えてください。
クラウドエージェントはブラウザを持っていますか+
はい。設定でツールをオフにしない限り、すべてのクラウドエージェントがブラウザエージェントをMCPツールとして利用でき、Web検索、ページ読み取り、データツールも備わっています。
どちらの側でも人が介入できますか+
はい。ブラウザの実行は人の回答のために一時停止したり、ライブビュー付きでブラウザを引き渡したりできます。端末の実行も質問を投げかけたり、ライブ画面リンクから引き継いだりできます。
すべて1つのアカウントに課金されますか+
はい。エージェントのサンドボックス、そのモデルとツールの呼び出し、ブラウザのステップ、端末の利用時間は、すべて同じ前払い残高から引かれます。
自分の各ユーザーごとにこれを実行できますか+
はい。ユーザーごとに、user にそのユーザーの自前のIDを指定してエージェントを1つ作成し、そのユーザーの端末を作成するときにも同じIDを渡してください。これにより、ユーザーごとのエージェントと端末を一覧できます。
自社ブランドでユーザーに提供するエージェントについてはホワイトラベルエージェントを、自分のアプリを端末でテストする方法についてはAIモバイルアプリテストを参照してください。