エージェントごとにプライベートなサンドボックスを持つホスト型 AI エージェント API

1. エージェントを作成する

   名前を付け、自社のユーザーのためのエージェントなら、そのユーザーの自社 ID も指定します。予算を設定すると、使える金額に上限を設けられます。

   cURL

   curl https://lovelyrouter.com/v1/agents \
     -H "Authorization: Bearer $LOVELY_API_KEY" \
     -H "content-type: application/json" \
     -d '{"name": "Support bot", "user": "cust-42", "budget_micros": 5000000}'

2. タスクを送る

   エージェントの runs にタスクを POST します。停止中のエージェントは自動で起動し、自身のツールと設定を使ってサンドボックスで作業を行い、最後の実行が終わってから数秒後に再び停止します。

   cURL

   curl https://lovelyrouter.com/v1/agents/agt_3f9a1c7e0b2d4e6f8a9b0c1d/runs \
     -H "Authorization: Bearer $LOVELY_API_KEY" \
     -H "content-type: application/json" \
     -d '{"input": "Summarize README.md in three bullets.", "wait": 120}'

3. 作成物を受け取る

   実行結果として、エージェントの回答、トークン使用量、作成したファイル（それぞれダウンロード URL 付き）が返されます。共有リンクを使えば、リンクを知っている人なら誰でも、ファイルを開いたり、フォルダー全体を Web サイトとして開いたりできます。

POST /v1/agents/{id}/runs は、最大 100,000 文字のタスクを 1 つ送ります。wait を指定すると、結果が出るまで最大 300 秒リクエストを保持します。stream を指定すると、実行のイベントを Server-Sent Events で受け取れます。イベントには、トークン使用量付きのステータス、ツール呼び出しとその結果、テキスト、最終回答があります。以前の実行の session_id を渡すと、その会話を続けられます。

完了した実行には output、usage、steps、tool_calls、files が含まれます。実行の一覧取得、実行イベントのあとからのストリーミング、実行のキャンセルもできます。各エージェントは同時に最大 4 件の実行を処理します。

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

コンソールまたは PATCH /v1/agents/{id} で、エージェントごとに次の項目を設定できます。既定のモデル、データツールとブラウザエージェントのオン・オフ、自社のリモート MCP サーバー（最大 8 つ。ヘッダーの値は暗号化して保存）、すべてのセッションに追加される最大 4,000 文字の指示、サイズ、アイドル時に停止（5 分〜24 時間、既定は 30 分）、最長セッション（1〜24 時間、既定は 8 時間）、そして既定でオンの呼び出し時に起動です。最後の設定がオンなら、実行やページへのアクセスで停止中のエージェントが起動します。

各エージェントのサンドボックスの実行中の料金を秒単位で支払い、さらにエージェントが使ったもの（モデルのトークン、データツールの結果、ブラウザのステップ）を通常料金で支払います。

ビルドなどのバーストに追加料金はかかりません。セッションの合間もエージェントは待機状態に保たれ、数秒で再び起動します。待機は月 $0.36 + ディスク 1 GB・月あたり $0.30 + 毎日のバックアップ 1 GB・月あたり $0.16 です（新しいエージェントで月およそ $0.66）。7 日間使われないとアーカイブされ、ファイル 1 GiB・1 か月あたり $0.20 になります。エージェントを起動するには、そのサイズの 15 分ぶんの料金をまかなえる残高が必要です。サブスクリプションはありません。料金を参照してください。