Agent Deployment Quickstart

参照元: LiveKit Agents Documentation ロードマップ: 学習ロードマップ

What（何についてか）

LiveKit CloudにAgentをデプロイするための最小ステップガイド。前提条件の確認から、デプロイ実行、デプロイ後のステータス・ログ監視までをカバーする。

Why（なぜ必要か）

ローカルで動作するAgentを本番環境で稼働させるには、コンテナ化・ビルド・デプロイ・スケーリングの仕組みが必要。LiveKit Cloudはこの一連の流れをCLI経由で自動化しており、開発者はインフラ管理ではなくAgentのロジックに集中できる。

How（どう動くか）

前提条件

デプロイに必要な3要素：

• LiveKit CLI（最新版の lk コマンド）
• LiveKit Cloud project（cloud.livekit.io で作成）
• 動作するAgent（Voice AI Quickstartで作成したもの、または公式スターターテンプレート）

公式スターターテンプレートは「デプロイ準備済み」の状態で提供される：

• Python: livekit-examples/agent-starter-python
• Node.js: livekit-examples/agent-starter-node

デプロイフロー

lk agent create 1コマンドで以下が全て自動実行される：

graph LR
    A["lk cloud auth"] --> B["lk agent create"]
    B --> C["Agent登録 + ID割当"]
    C --> D["livekit.toml 生成"]
    D --> E["Dockerfile 自動生成（無い場合）"]
    E --> F["コードアップロード"]
    F --> G["コンテナイメージビルド"]
    G --> H["Cloud projectへデプロイ"]

各ステップの詳細：

1. 認証: lk cloud auth でブラウザ経由でCloud projectとCLIを紐付ける。既存認証がある場合は lk project list / lk project set-default でプロジェクトを選択。
2. 登録: AgentにユニークIDを割り当て、livekit.toml（ID、project、デフォルト設定）を生成。
3. ビルド: Dockerfileが無ければ自動生成し、コードをCloud build serviceにアップロードしてコンテナイメージをビルド。
4. デプロイ: ビルド完了後、Cloud projectにデプロイ。自動スケーリング・ロードバランスが有効になる。

デプロイ後の接続方法

• Agent Playground — テスト用UI
• Custom Frontend — 自作フロントエンド
• Telephony Integration — 電話網経由

ステータス・ログ監視

• lk agent status — ステータス、レプリカ数、その他詳細を表示
• lk agent logs — デプロイ済みAgentインスタンスのログをリアルタイムテール

Key Concepts

用語	説明
lk cloud auth	CLIとLiveKit Cloud projectの認証・紐付け
lk agent create	登録・ビルド・デプロイを一括実行するメインコマンド
livekit.toml	Agent ID・project・設定を記録する設定ファイル
lk agent status	デプロイ済みAgentのステータス確認
lk agent logs	Agentログのリアルタイムテール

一言まとめ

LiveKit CloudへのAgentデプロイは lk cloud auth → lk agent create の2コマンドで完了する。Dockerfileの自動生成からコンテナビルド・デプロイまで全自動。デプロイ後は lk agent status / lk agent logs で運用監視。