初めてのLiveKit Agent - onBridge | AIと電話をつなぐ最短ルート

作成するエージェント

シンプルなパイプライン型のエージェントを作成します。

プロジェクトを初期化します

プロジェクト用のフォルダを作成し初期化します。

mkdir onbridge-agent
cd onbridge-agent
pnpm init --init-type module
pnpm add -D typescript tsx
pnpm exec tsc --init

uv init onbridge-agent --bare
cd onbridge-agent

環境変数の設定

LiveKit Cloud, OpenAI からAPIキーを取得し、環境変数として設定します。以下の内容で.env.localファイルを作成してください：

.env.local

# LiveKit Cloud
LIVEKIT_API_KEY=<your API Key>
LIVEKIT_API_SECRET=<your API Secret>
LIVEKIT_URL=<your LiveKit server URL>
LIVEKIT_SIP_URI=<your SIP URI>

# OpenAI
OPENAI_API_KEY=<Your OpenAI API Key>

LiveKit Cloud

API Key の取得

LiveKit Cloud にアクセス
「Sign Up」または「Get Started」をクリック
メールアドレスとパスワードでアカウントを作成
ログイン後、ダッシュボードに移動
「Create Project」をクリック
プロジェクト名を「onBridge Example」として作成
左側メニューの「Settings」→「API Keys」を開く
「Create Key」ボタンをクリック
キー名を「onBridge Example Key」として作成
“Environment variables” をコピーして、.env.local に設定

LIVEKIT_URL=wss://your-project.livekit.cloud
LIVEKIT_API_KEY=your_api_key_here
LIVEKIT_API_SECRET=your_api_secret_here

SIP URI の取得

左側メニューの「Settings」→「Project」を開く
「SIP URI」の値をメモ
以下を .env.localに設定

LIVEKIT_SIP_URI=sip:your-project.livekit.cloud

OpenAI

OpenAI Platform にアクセス
「Sign up」をクリック
メールアドレスとパスワードでアカウントを作成
必要に応じて電話番号認証を完了
ログイン後、ダッシュボードに移動
プロジェクト作成ページにアクセス
「Create new project」をクリック
プロジェクト名を「onBridge Example」として作成
プロジェクトの設定ページに移動
左側メニューの「API Keys」をクリック
「Create new secret key」ボタンをクリック
キー名を「onBridge Example Key」として作成
音声モデルを利用するために、以下の権限を設定：

Permissions: All または Restricted
Models: チェック済み
Model capabilities: チェック済み

作成されたAPI Key をコピーして、.env.local に追記

OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

エージェントを実装

シンプルなパイプライン型のエージェントを作成します。以下のコードをagent.ts（Node.js）またはagent.py（Python）として保存してください：

import {
    type JobContext,
    type JobProcess,
    WorkerOptions,
    cli,
    defineAgent,
    voice,
    stt as sttCore,
} from '@livekit/agents';
import * as livekit from '@livekit/agents-plugin-livekit';
import * as openai from '@livekit/agents-plugin-openai';
import * as silero from '@livekit/agents-plugin-silero';
import { BackgroundVoiceCancellation } from '@livekit/noise-cancellation-node';
import { fileURLToPath } from 'node:url';
import dotenv from 'dotenv';

dotenv.config({ path: '.env.local' });

export default defineAgent({
    prewarm: async (proc: JobProcess) => {
        proc.userData.vad = await silero.VAD.load();
    },
    entry: async (ctx: JobContext) => {
        const vad = ctx.proc.userData.vad! as silero.VAD;

        // Non-streaming STT wrapped for chunked (VAD) processing
        const stt = new sttCore.StreamAdapter(
            new openai.STT({ model: 'gpt-4o-mini-transcribe' }),
            vad
        );


        const assistant = new voice.Agent({
            instructions: 'You are a helpful voice AI assistant.',
        });

        const session = new voice.AgentSession({
            vad,
            stt: stt,
            llm: new openai.LLM({ model: 'gpt-4o-mini' }),
            tts: new openai.TTS({
                model: 'tts-1',
                voice: 'alloy'
            }),
            turnDetection: new livekit.turnDetector.MultilingualModel(),
        });

        await session.start({
            agent: assistant,
            room: ctx.room,
            inputOptions: {
                // For telephony applications, use `TelephonyBackgroundVoiceCancellation` for best results
                noiseCancellation: BackgroundVoiceCancellation(),
            },
        });

        await ctx.connect();

        const handle = session.generateReply({
            instructions: 'Greet the user and offer your assistance.',
        });
    },
});

cli.runApp(new WorkerOptions({ agent: fileURLToPath(import.meta.url) }));

必要なモデルをダウンロードする

turn-detector、silero、noise-cancellation プラグインを使用するために、必要なモデルファイルをダウンロードします：

pnpm pkg set "scripts.download-files=tsc && node agent.js download-files"
pnpm download-files

uv run agent.py download-files
uv run agent.py console

最終的なファイル構成

onbridge-agent/
├── agent.ts          # メインのエージェントファイル
├── package.json      # 依存関係の定義
├── tsconfig.json     # TypeScript設定
└── .env.local        # 環境変数

onbridge-agent/
├── agent.ts          # メインのエージェントファイル
├── package.json      # 依存関係の定義
├── tsconfig.json     # TypeScript設定
└── .env.local        # 環境変数

音声AIエージェントを起動してプレイグラウンドに接続

エージェントを開発モードで実行します：

pnpm pkg set "scripts.dev=tsx agent.ts dev"
pnpm dev

uv run agent.py dev

Playgroud より接続する

LiveKit Agent Playground ( https://agents-playground.livekit.io/ )にアクセス
onBridge Example プロジェクトを選択
ローカルで起動したエージェントと接続され、会話ができる

​作成するエージェント

​プロジェクトを初期化します

​環境変数の設定

​LiveKit Cloud

​OpenAI

​エージェントを実装

​必要なモデルをダウンロードする

​最終的なファイル構成

​音声AIエージェントを起動してプレイグラウンドに接続

​Playgroud より接続する