AVA: AudioSocket と RTP で Asterisk と話す AI ボイスエージェント
Audiosocket/RTP テクノロジーを使用して Asterisk/FreePBX と統合するオープンソース AI 音声エージェント。
ひと目でわかる
- これは何？
- AVA は Asterisk と FreePBX を音声認識、LLM、音声合成プロバイダーにモジュール式パイプラインで接続し、管理 UI、エージェント単位のルーティング、ツール呼び出しを備えています。
- 誰に向いている？
- README は AVA を、管理 UI、ゴールデンベースライン設定、AI_AGENT で制御するエージェントモデルを備えた導入向けプロジェクトとして説明しています。リポジトリだけから検証しにくいのは、実際の本番動作、セキュリティ体制、サポートの約束です。
- 商用利用できる？
- できます。MIT は寛容なライセンスで、著作権表示とライセンス表示を残せば、使用・改変・販売が可能です。
- 今もメンテナンスされている？
- されています。最後のコミットは 1 日前です。
- 何の言語で書かれている？
- 主に Python です（GitHub の言語統計による）。
回答はプロジェクトの GitHub データ（最終同期：2026年9月14日）と当サイトの分析に基づくもので、法的助言ではありません。
オープンソース詳細解説
Asterisk と FreePBX 向けのオープンソースボイスエージェント
AVA は、リポジトリの説明によると、AudioSocket と RTP 技術を使って Asterisk と FreePBX に統合するオープンソースの AI ボイスエージェントです。README は、音声認識、LLM、音声合成プロバイダーを組み合わせられるモジュール式パイプラインアーキテクチャとして説明しています。コードベースは Python で、README は Python 3.11+、Docker Compose、Asterisk 18+ を要件として挙げています。リポジトリメタデータは demo.agent6789.com のライブデモも示しており、README は音声ラインを試すための米国電話番号を別途記載しています。
クイックスタートと管理 UI
最初の通話までの文書化された経路は、リポジトリをクローンして `sudo ./preflight.sh --apply-fixes` を実行することから始まります。README によると、これにより `.env` が作成され、JWT シークレットが生成されます。次に `docker compose -p asterisk-ai-voice-agent up -d --build --force-recreate admin_ui` で管理 UI を起動し、ポート 3003 を開きます。初回起動時、一回限りの管理者パスワードがコンテナログに出力されます。README は、初回ログイン時にパスワードを変更し、ファイアウォール、VPN、リバースプロキシでポート 3003 を制限するよう指示しています。セットアップウィザードがプロバイダーを設定し、Asterisk ダイヤルプランを生成します。README は、preflight をスキップした場合の動作や、ウィザードが既存のダイヤルプランをどう扱うかを明らかにしていません。
ゴールデンベースラインとプロバイダー選択
README は 7 つのゴールデンベースライン設定を挙げています: OpenAI Realtime、Deepgram Voice Agent、Google Live、ElevenLabs Agent、Local Hybrid、Telnyx AI Inference、xAI Grok Voice Agent。それぞれに `config/ai-agent.golden-openai.yaml` のような YAML 設定パスがあります。また、MiniMax を含む追加の LLM プロバイダー、CPU、GPU、分割サーバートポロジを備えた完全ローカルモード、API キーを必要としない Ollama ベースのパイプラインも文書化されています。README は複数のホスト型ベースラインで 2 秒未満の応答時間を主張していますが、これはプロジェクト自身の記述であり、独立した測定結果ではありません。リポジトリメタデータにはパフォーマンステストデータは含まれていません。
エージェント、ダイヤルプランルーティング、設定
README によると、v7.0.0 以降、エージェントは YAML context ブロックではなく管理 UI で管理されます。ダイヤルプラン変数 `AI_AGENT` はスラッグで運用者管理のエージェントを選択し、`AI_PROVIDER` はコール単位のオーバーライドとして利用できます。サンプルの FreePBX スニペットは `AI_AGENT=sales-agent` を設定し、`Stasis(asterisk-ai-voice-agent)` を呼び出します。設定は 3 ファイル方式に分割されていますが、README はこの方式に言及するだけで、提供されたセクションでは 3 つのファイルを列挙しておらず、優先順位と例についてはドキュメントを指しています。レガシー `AI_CONTEXT` から `AI_AGENT` への移行は、アップグレード時に自動的に行われ、`AI_CONTEXT` は非推奨の互換エイリアスとして残ると説明されています。
ツール呼び出しとエージェント単位のリソースアクセス
README は AI を利用したアクションを文書化しています: 内線、キュー、リンググループへの転送、転送キャンセル、別れの言葉を伴う通話終了、ボイスメール、メール要約、発信者要求のトランスクリプトです。2 つのメールツールはデフォルトで無効です。v7.4 以降、各エージェントは転送先、Google カレンダー、Microsoft カレンダー、ボイスメールボックスを継承、選択、拒否できます。README はまた、コール前、コール中、コール後の HTTP ツールを YAML の例とともに説明しています。レート制限、再試行ポリシー、HTTP ツールが任意のエンドポイントに対する認証をどう処理するかは指定されていません。
リリース履歴と README が残した検証の余地
README の変更ログは v7.5.4 から v4.1 までをカバーしており、最近のリリースはプライバシー保護診断、音声復旧、ワイドバンド AudioSocket、より安全なアップグレードに焦点を当てています。README は一部のローカル AI 設定について検証マトリクスとコミュニティテストの証拠を主張し、v7.5.4 の検証マトリクスにリンクしています。リポジトリメタデータは 29 件の未解決 issue と 252 件の fork を示していますが、それらの issue が解決済みであることや、プロジェクトが活発にメンテナンスされていることは確認できません。MIT ライセンスは使用、コピー、変更、マージ、公開、配布、サブライセンス、販売を許可し、保証を否認します。サポート、セキュリティ保証、本番環境への適合性については何も述べていないため、別途確認する必要があります。
Asteriskの通話経路へ組み込む場合は、AudioSocketまたはRTPのどちらを使うか、音声形式の変換点、AIサービスの待ち時間、発話終了の判定を先に固定します。READMEが列挙する設定例は導入の手掛かりになりますが、回線事業者、ダイヤルプラン、ローカルモデルの組み合わせごとの通話品質までは保証しません。
編集部の結論
README は AVA を、管理 UI、ゴールデンベースライン設定、AI_AGENT で制御するエージェントモデルを備えた導入向けプロジェクトとして説明しています。リポジトリだけから検証しにくいのは、実際の本番動作、セキュリティ体制、サポートの約束です。
コミュニティノート