> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sambanova.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# LiveKit

[LiveKit](https://livekit.io/) は、WebRTC によるスケーラブルなマルチユーザー会議を実現するオープンソースプロジェクトです。アプリケーションにリアルタイムのビデオ・音声・データ機能を追加するためのツールを提供します。

## 前提条件

* [SambaCloud アカウント](https://cloud.sambanova.ai?utm_source=livekit\&utm_medium=external\&utm_campaign=cloud_signup)
* [SambaNova API キー](https://cloud.sambanova.ai/apis?utm_source=livekit\&utm_medium=external\&utm_campaign=cloud_signup)
* [LiveKit Cloud](https://cloud.livekit.io/) アカウントまたはセルフホストの LiveKit サーバー (`LIVEKIT_URL`、`LIVEKIT_API_KEY`、`LIVEKIT_API_SECRET` を用意)
* Python 3.11.5 以上

## インストールとセットアップ

<Steps>
  <Step title="仮想環境の作成と有効化">
    **macOS/Linux:**

    ```bash theme={}
    python -m venv .venv
    source .venv/bin/activate
    ```

    **Windows:**

    ```bash theme={}
    python -m venv .venv
    .venv\Scripts\activate
    ```
  </Step>

  <Step title="LiveKit エージェントのインストール">
    ```bash theme={}
    pip install "livekit-agents[openai,silero,deepgram,cartesia,turn-detector]~=1.0"
    ```
  </Step>

  <Step title="環境変数の設定">
    ```bash theme={}
    export SAMBANOVA_API_KEY="your-sambanova-api-key"
    export SAMBANOVA_URL="https://api.sambanova.ai/v1"
    ```
  </Step>
</Steps>

## ユースケースの例

LiveKit と SambaCloud のモデルを組み合わせることで、強力なリアルタイム AI エージェントを構築できます。代表的なユースケースには以下があります。

* マルチモーダルアシスタント – テキスト、音声、画面共有に対応する AI アシスタント
* 遠隔医療 – オンライン診察におけるリアルタイム AI サポート
* コールセンター – インバウンド・アウトバウンドの顧客対応を AI 音声エージェントで自動化
* リアルタイム翻訳 – 多言語間の会話を即時に翻訳

## 使用例 - SambaCloud を用いた音声エージェント

以下は、LiveKit と SambaCloud の LLM モデルを使用して音声 AI エージェントを構築する例です。

```python theme={}
from livekit import agents
from livekit.agents import AgentSession, Agent, RoomInputOptions
from livekit.plugins import openai, cartesia, noise_cancellation, silero
import os

SAMBANOVA_URL = os.getenv("SAMBANOVA_URL")
SAMBANOVA_API_KEY = os.getenv("SAMBANOVA_API_KEY")

class Assistant(Agent):
    def __init__(self) -> None:
        super().__init__(instructions="You are a helpful voice AI assistant.")

llm = openai.LLM(
    model="Llama-4-Maverick-17B-128E-Instruct",
    api_key=SAMBANOVA_API_KEY,
    base_url=SAMBANOVA_URL,
)

async def entrypoint(ctx: agents.JobContext):
    session = AgentSession(
        stt=cartesia.STT(
           model="ink-whisper"
        ),
        llm=llm,
        tts=cartesia.TTS(),
        vad=silero.VAD.load(),
    )
    await session.start(
        room=ctx.room,
        agent=Assistant(),
        room_input_options=RoomInputOptions(
            noise_cancellation=noise_cancellation.BVC(),
        ),
    )
    await session.generate_reply(
        instructions="Greet the user and offer your assistance."
    )

if __name__ == "__main__":
    agents.cli.run_app(agents.WorkerOptions(entrypoint_fnc=entrypoint))
```

## 参考情報

詳細については、[LiveKit の公式ドキュメント](https://docs.livekit.io/agents/) をご参照ください。

## トラブルシューティング

<AccordionGroup>
  <Accordion title="エージェントが失敗する、またはベース URL が None になる">
    `SAMBANOVA_URL` がエクスポートされていることを確認してください: `export SAMBANOVA_URL=https://api.sambanova.ai/v1`
  </Accordion>

  <Accordion title="認証エラーまたは 401 Unauthorized">
    `SAMBANOVA_API_KEY` が設定されていることを確認してください。新しいキーは [SambaNova API ダッシュボード](https://cloud.sambanova.ai/apis?utm_source=livekit\&utm_medium=external\&utm_campaign=cloud_signup) から取得できます。
  </Accordion>

  <Accordion title="ModuleNotFoundError: No module named 'livekit'">
    仮想環境を有効化した状態で `pip install "livekit-agents[openai,silero,deepgram,cartesia,turn-detector]~=1.0"` を実行してください。
  </Accordion>
</AccordionGroup>