クラウドエージェント

クラウドエージェントは、AI エージェントアプリ Lovely Agent を専用のサンドボックスで動かすものです。Claude・GPT・Gemini と対話し、コマンドの実行、コードの作成、ファイルの編集を行い、Lovely Router のデータツールやブラウザエージェントも使います。各エージェントのファイル・セッション・設定は実行のたびに保持されます。エージェントはいくつでも持てます。プロジェクトごとに 1 つ、あるいは自社プロダクトのユーザーごとに 1 つ作り、それぞれにブラウザや API からアクセスできます。

1. 1

   エージェントを作成する

   クラウドエージェントで 新しいエージェント を選ぶか、POST /v1/agents を呼び出します。名前を付け、自社ユーザーのためのエージェントならそのユーザーの自社 ID も指定します。

2. 2

   使う

   起動 を選び、続いて 開く を選びます。Lovely Agent がエージェント専用のアドレス（agent.lovelyrouter.com/a/<エージェント ID>/）でサインイン済みの状態で開きます。POST /v1/agents/{id}/runs でタスクを送ることもできます。停止中のエージェントは、実行が届いたときや誰かがその Web ページを開いたときに自動で起動します（オフにもできます）。

3. 3

   停止する（または自動で停止させる）

   使い終わったら 停止 を選びます。一定時間使われなかったとき、または許可した最長セッションに達したときにも自動で停止します。ワークスペースは残り、次回の起動では前回の続きから再開できます。

含まれるもの#

• Lovely Agent とその Web UI：チャット、セッション、プランモード、サブエージェント、スキル、スケジュールタスク、プラグイン、ターミナル。
• モデル：Lovely Router が提供するすべてのチャットモデルを設定済みです。既定は最も安価な Claude Haiku 5.5 です。エージェントごとに設定で別のモデルを選べるほか、エージェント内でも切り替えられます。モデルページで独自のモデルプロバイダーを追加することもできます。
• ツール：データツールとブラウザエージェントが MCP ツール（mcp__tools__*）として使えるので、エージェントは Web 検索、YouTube・Reddit・Google マップ・Amazon などのプラットフォームからの構造化データの取得（サイトを自分でスクレイピングするよりこれらのツールを優先するよう指示されています）、画像の作成、ブラウザ操作ができます。設定で独自の MCP サーバーも追加できます。
• Linux サンドボックス：Node.js 22、Python 3、git、ビルドツール、ripgrep 入りで、インターネットにアクセスできます。エージェントはサンドボックス内ではすべての権限を持ち、外には一切アクセスできません。

料金#

各エージェントのサンドボックスの実行中の料金に加え、エージェントが使ったものを通常料金でお支払いいただきます。

サンドボックスは、起動してから停止するまで、実行中は 1 分ごとに請求されます。共有 vCPU はインストールやビルドなどのバースト時にフルスピードで動作し、長時間 CPU を多く使う処理では低めのベースラインで動作します。バーストの追加料金はありません。起動には、そのサイズの 15 分間分以上（最低 $0.25）の残高が必要です。残高がマイナスになるとエージェントは停止し、メールでお知らせします。24 時間以内にチャージしない場合、ワークスペースは削除されます。

セッションの合間もエージェントは待機状態に保たれるため、次回は数秒で起動し、前回の続きから始められます。ディスクは 1 GB から始まり、80% 使うたびに 1 GB ずつ増えます（最大 20 GB）。新しいエージェントの待機中の費用は月およそ $0.66 です。7 日間使われなかったエージェントはアーカイブされ、ファイルの分だけ請求されます。次回の起動は数秒長くかかります。

各エージェントにはこれまでの費用（サンドボックスの時間と、そのセッションが使ったモデルとツール）が表示され、予算も設定できます。予算に達するとエージェントは停止し、それ以上起動も実行もできなくなります。

ユーザーに自社のブランディングを見せるホワイトラベルのエージェントは、サンドボックス料金が上記の 1.5×（スモールは 1 時間 $0.075）です。モデルとツールは通常料金のままです。

設定#

設定はエージェントごとにあり、コンソールまたは PATCH /v1/agents/{id} で変更します。次回の起動から適用されます。

• 既定のモデル：新しいセッションで使う LLM。既定は Claude Haiku 5.5 です。
• データツールとブラウザエージェント：既定でオン。コーディングと対話だけのエージェントにするならオフにします。
• その他のツール（MCP サーバー）：最大 8 つのリモート MCP サーバー（Streamable HTTP）。それぞれ名前、https:// URL、任意のヘッダー（Authorization: Bearer … など）を指定します。ヘッダーの値は暗号化して保存され、二度と表示されません。
• 指示：すべてのセッションに追加される最大 4,000 文字のテキスト。コーディング規約などに使えます。
• サイズ、アイドル時に停止するまで（5 分〜24 時間、既定 30 分）、最長セッション（1〜24 時間、既定 8 時間）。
• 呼び出されたら自動で起動（既定でオン）：API の実行が届いたとき、あなたが開いたとき、または誰かがその Web ページを開いたときに、停止中のエージェントが自動で起動します。起動のたびに通常のセッションとなり、通常どおり課金されます。API で使われたセッションは、実行で起動したか、もともと動いていたかにかかわらず、最後の実行が終わってから約 5 秒後に停止します。セッション中に誰かがエージェントの Web ページを使った場合、そのセッションはアイドル時に停止します（アイドル時の停止、既定 30 分）。API 呼び出しの合間も動かしておくには、実行に stop_when_done: false を付けてください。オフにすると、コンソールまたは POST /v1/agents/{id}/start であなたが起動した場合のみ動き、自社ユーザーの実行やページへのアクセスでは停止したままです。この設定はすぐに反映されます。

誰かがページを使っているとき、エージェントがモデルやツールを呼び出しているとき、実行が進行中のとき、または CPU が忙しいとき（ビルドや時間のかかるコマンド）は使用中とみなされます。タブを開いているだけでは使用中になりません。

自社ユーザー向けのエージェント#

エージェントを自社プロダクトに組み込めます。自社ユーザーごとに 1 つのエージェントを作り、それぞれに専用のワークスペースを持たせ、費用はすべてあなたの残高から支払います。

1. ユーザーごとに、そのユーザーの自社 ID を付けてエージェントを作成します：{"user": "cust-42"}（任意の metadata も可）。あるユーザーのエージェントは GET /v1/agents?user=cust-42 で一覧できます。
2. API キーの代わりにエージェントトークンをユーザーに渡します（POST /v1/agents/{id}/tokens）。使えるのはその 1 つのエージェントだけで、期限が来ると自動で無効になります（1 分〜30 日）：
   • api スコープ：ユーザー（またはその代わりに動く自社バックエンド）がエージェントの実行でタスクを送り、状態を確認します。Web ページを見せたくない場合はこちらを使います。
   • ui スコープ：エージェントの Web ページをサインイン済みで開くリンクが付きます。

   呼び出されたら自動で起動 がオンなら、停止中のエージェントはユーザーの実行やアクセスで起動します。ユーザーがそれ以外の方法で起動することはできません。

3. エージェントごとに予算を設定して各ユーザーの利用額に上限を設け、各エージェントの費用をコンソールや API で確認します。
4. エージェントが作ったものをユーザーに見せます。実行ごとに納品されたファイルが一覧され、共有リンクを使えば、ユーザーがサインインしなくてもファイルや Web ページ全体を開けます。
5. エージェントのページに自社の製品を表示します。ブランディングを 1 つ割り当てれば、ユーザーには当社ではなくあなたの名前・ロゴ・配色が表示されます。

エージェントのトークンはいつでも失効できます。エージェントの削除や、トークンを作成した API キーの失効でもトークンは無効になります。

ワークスペース#

各エージェントには専用のワークスペースがあります。プロジェクト、セッション、設定、スキル、インストールしたプラグインが入ったホームフォルダで、初回起動時に作成され、実行のたびに保持されます。API で始めたセッションも Web ページに表示され、API Requests にまとめられます。ストレージは日次で請求されます。待機中は待機の料金、7 日間使われないとアーカイブに入っているファイルの分です（料金）。エージェントを削除するとワークスペースも完全に削除され、ストレージの請求も止まります。残高がマイナスになってから 24 時間以内にチャージしない場合も、ワークスペースは削除されます。

ファイルと共有ページ#

エージェントが作ったもの（ドキュメント、レポート、グラフ、データ、Web ページや静的サイト全体）はホームフォルダに残り、次の 3 つの方法で取り出せます。

• エージェントの Web ページで：エージェントが納品したファイルは返信の最後に表示されます。選ぶとプレビューでき、HTML ページはサンドボックス化されたフレームで動きます。
• API で：実行ごとに納品されたファイルが一覧され（files、それぞれダウンロード用の url 付き）、GET /v1/agents/{id}/files/… でホームフォルダ内のものを一覧・ダウンロードできます。エージェントの実行中はライブの内容を、停止中は最後に停止したときに保存された内容を読み取ります。読み取りのためにエージェントを起動することはありません。
• 誰でも開けるリンクとして：コンソールのファイル一覧の 共有、または POST /v1/agents/{id}/shares で、サインイン不要のリンクを作れます。ファイルを共有することも、フォルダを共有して Web サイトとして公開することもできます。リンクはフォルダの index.html を開き、ページは CSS・スクリプト・画像を相対パスで読み込みます。リンクの有効期間は 1 分〜1 年（既定は 1 週間）で、エージェントの停止中も使えます。

すべての共有リンクを無効にする で、エージェントのリンクをまとめて無効にできます。エージェントを削除するか、リンクを作った API キーまたはエージェントトークンを失効させても、リンクは無効になります。

セキュリティとプライバシー#

• 各エージェントのサンドボックスは、他のすべてのエージェントやお客様から隔離されています。
• 共有ページはリンクを持つ人なら誰でも見られます。公開してよいものだけを共有してください。
• セッションごとに専用の API キーが発行され、エージェントのモデル・ツール呼び出しに使われ、セッション停止時に失効します。これらの呼び出しはログに表示されます。
• テレメトリと、第三者へのセッションのアップロードはオフにしています。
• コンソールからサインアウトすると、コンソールから開いたエージェントからも 1 分以内にサインアウトされます。

制限#

• 1 アカウントあたり最大 1,000 エージェント、同時に実行できるのは 20 個まで。
• 1 つのエージェントで同時に実行できるセッションは 1 つ。API の実行はエージェントあたり同時に最大 4 件（セッションごとに 1 件）。
• 1 回のセッションは最長 24 時間です。続けるには再度起動してください（ワークスペースは保持されます）。
• GPU はありません。