クラウドエージェント

ホワイトラベル

エージェントのページに自社の名前・ロゴ・配色・フォントを表示し、ユーザーには自社の製品だけを見せて Lovely Router の名前は出しません。ブランディングを複数保存し、エージェントごとに選べます。

ホワイトラベルのエージェントは、当社ではなくあなたのブランディングをまとったクラウドエージェントです。Web ページ、ブラウザのタブ、その周辺のページに、あなたのエージェント名、ロゴ、配色とフォント、ウェルカムメッセージが表示されます。自社製品にエージェントを組み込むのに使えます。製品ごと、または顧客ごとに 1 つのブランディングを用意し、それぞれの下に必要なだけエージェントを作れます。

ブランディングをデザインする
クラウドエージェント → ブランディングで新しいブランディングを選びます。ユーザーに見せる名前を設定し、ロゴをアップロードし、テーマ・配色・フォントを選んで、ウェルカムメッセージを書きます。プレビューにエージェントのページがその場で表示されます。POST /v1/agents/brandings でも作成できます。
エージェントに選ぶ
エージェントの作成時にブランディングで選ぶか、あとからエージェントの設定で選びます。API では、エージェントの作成や更新時に "branding": "brd_…" を送ります。エージェントの次回の起動から適用されます。
ユーザーにページを渡す
ui スコープのエージェントトークンをユーザーに渡します。そのリンクで、あなたのブランディングのエージェントページがサインイン済みで開きます。ページを見せず実行だけを使うこともできます。

ユーザーに見えるもの#

エージェントのページ：ページタイトル、サイドバー、ブラウザのタブにあなたのエージェント名。サイドバーのマーク、メッセージ入力欄の上の大きなマーク、ファビコンにあなたのロゴ。見出しにあなたのウェルカムメッセージ。ダークまたはライトのテーマで全体にあなたの配色とフォント。
周辺のページ：エージェントのアドレスに出る起動中…、サインイン、停止中などのお知らせもあなたのブランディングで表示され、Lovely Router へのリンクはありません。残高や予算のためにエージェントを起動できないとき、ユーザーには「現在利用できません」とだけ伝えます。
エージェント自身：あなたのエージェント名で名乗り、提供するモデルもその名前の下に並びます。組み込みツールも Lovely Router に触れません。

独自ドメインを接続するまで、アドレスは agent.lovelyrouter.com/a/<エージェント ID>/（共有リンクは agent.lovelyrouter.com/s/…）です。接続後は agents.yourcompany.com/a/<エージェント ID>/ のように、あなたのドメインになります。

Nova Assistant のように、ユーザーになじみのあるエージェント名を選んでください。会話の中でエージェントが自分を呼ぶ名前にもなります。

料金#

ホワイトラベルのエージェントは、サンドボックスの料金（計算とストレージ）が標準料金の 1.5× です。使うモデル、データツール、ブラウザエージェントは通常料金のままです。

項目	標準	ホワイトラベル
スモール（共有 vCPU 2 個、2 GiB）	1 時間 $0.05	1 時間 $0.075
ミディアム（共有 vCPU 4 個、4 GiB）	1 時間 $0.10	1 時間 $0.15
ラージ（共有 vCPU 8 個、8 GiB）	1 時間 $0.20	1 時間 $0.30
セッション間の待機	月 $0.36 + ディスク GB 月あたり $0.30 + バックアップ GB 月あたり $0.16	月 $0.54 + ディスク GB 月あたり $0.45 + バックアップ GB 月あたり $0.24
アーカイブ（7 日間未使用）	GiB 月あたり $0.20	GiB 月あたり $0.30
LLM トークン、データツール、ブラウザエージェント	通常料金	通常料金
独自ドメイン	—	接続中は 1 日 $0.50

セッションは起動時の料金で請求されます。エージェントのブランディングを付けたり外したりすると、次回の起動から料金が変わります。ストレージは、その日のエージェントのブランディングに応じた料金で日ごとに請求されます。ブランディングの保存自体は無料です。

ブランディング#

ブランディングには次のものが含まれます。

エージェント名：ユーザーに見える名前（1〜40 文字の英字・数字・スペースと . _ -）。
コンソールでの名前：あなた用のラベル。ユーザーには表示されません。
ロゴ：PNG、JPEG、WebP または SVG。正方形が最適で、コンソールは画像を 256 ピクセルに縮小します。ロゴがない場合は、エージェント名の頭文字をアクセント色で表示します。SVG は画像として表示されるため、中のスクリプトは実行されません。
テーマ：ダークまたはライトに、アクセント色と背景色。そのほかの色（パネル、枠線、テキスト、リンク、アクセント上のテキスト）はこれらから生成され、1 色ずつ微調整もできます。
フォント：Google Fonts から本文用とコード用を 1 つずつ、またはページ標準のフォント。
ウェルカムメッセージ：最初のメッセージ入力欄の上の見出し。最大 80 文字。既定：何をお手伝いしましょうか？

ブランディングは 50 個まで保存できます。変更は、そのブランディングを使う各エージェントの次回の起動で反映され、周辺のページは 1 分以内に追従します。エージェントが使用中のブランディングは削除できません。先に別のブランディングか標準の見た目に切り替えてください。

cURL

curl https://lovelyrouter.com/v1/agents/brandings \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"agent_name": "Nova Assistant", "scheme": "light", "colors": {"accent": "#0d9488"}, "font": "Inter", "welcome": "How can Nova help today?"}'

# 次に、それを使うエージェントを作成
curl https://lovelyrouter.com/v1/agents \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"name": "Nova for cust-42", "user": "cust-42", "branding": "brd_6c1f0a9e3b7d2c4e8f5a1b0d"}'

すべてのフィールドはブランディングのエンドポイントを参照してください。

独自ドメイン#

ブランディングのエージェントを、agents.yourcompany.com のような自社のドメインで提供できます。リンク、サインイン、ページ、共有リンクがそのドメインを使い、アドレスバーに当社の名前は出ません。

接続する
ブランディングでブランディングを開き、独自ドメインにドメインを入力するか、PUT /v1/agents/brandings/{id}/domain を呼び出します。
DNS レコードを 1 つ追加する
DNS プロバイダーで、表示された CNAME レコード（あなたのドメイン → 表示されたターゲット）を追加します。ルートドメイン（yourcompany.com）には、ルートに CNAME を置ける DNS プロバイダー（CNAME フラットニングや ALIAS）が必要です。
証明書を待つ
レコードが有効になると証明書が自動で発行され、通常は数分でステータスが有効になります。ドメインを当社に向ける前に証明書を準備したい場合は、表示された TXT レコードも追加してください。

有効になると、新しいオープンリンク、ui エージェントトークン、共有リンクはあなたのドメインを指します。以前に作ったリンクは agent.lovelyrouter.com で引き続き使えます。あなたのドメインで応答するのはそのブランディングのエージェントだけで、Lovely Router のほかの部分は表示されません。

ドメインは接続中 1 日 $0.50 で、接続している日（UTC）ごとに、接続した日から課金されます。削除すると翌日から課金が止まります。ドメインはブランディングごとに 1 つで、ブランディングを削除するとそのドメインも削除されます。残高がマイナスのままのアカウントのドメインは、ワークスペースと同じく 24 時間後に削除されます。