🏠 日本語ドキュメント
English →

🏠Aegis Voice Firewall — System Overview

代表電話を AI が一次受付し、spam は遮断・正当な着信は人へ。全体像とこのサイトの歩き方。

Aegis（イージス）は、法人の代表電話にかかってくる着信を AI が一次受付し、 営業・勧誘は遮断、取引先・急ぎの用件は担当者へ取り次ぐ「通話の司令塔」です。

全体像（Route A / Route C）

📞 着信（発信者） 代表電話 / ひかり電話 HGW Raspberry Pi 3B（1階・宅内） Asterisk 22 Voice Edge / Layer 1 bridge.py chan_audiosocket :9092 Route A：Retell（現行運用が主） Route C：OpenAI Realtime（Phase A/C） Retell AI（SIP / inbound webhook） Custom LLM webhook /llm/* OpenAI Realtime GA gpt-realtime Aegis Cloud（Layer 3） classify_call → tools_core → verdict spam → Hangup fail-safe（遮断） allow → 正常転送 ALLOW_DESTINATION unknown → 人へ取次 fail-open（業務継続）
図: Route A（Retell）と Route C（OpenAI Realtime）が Aegis Cloud で合流し、verdict（spam / allow / unknown）で 3 分岐する。spam=fail-safe で遮断、unknown=fail-open で人へ取次。実線の紫枠 = Raspberry Pi 3B（宅内）の機器境界（Asterisk 22 + chan_audiosocket + bridge.py）で、HGW・Retell・OpenAI・Aegis Cloud（NAS）は枠外。

2階建てと2つの関門（SIP・実電話番号の経路）

実電話番号の経路（Phase C）は 2階建てで考える。1階が現場のエッジ（Pi: voice-edge = Asterisk 22 + bridge.py）、2階が頭脳（NAS: aegis-platform）。 守りの門は 2 つある:

  • 第1関門（着信時・通話前）: dialplan が route-decision API に curl で問い合わせ、 block（切る）/ human（人へ通す）/ ai（AI 対応） の 3 分岐。API に届かないときは 静的フォールバック（fail-open で人へ倒れる方向）。
  • 第2関門（通話中）: AI が spam と判定すると bridge が AMI Hangup（B案 / D-1）で 能動切断。切断安全弁（spam_score ≥ 0.8 のときだけ切断・満たさなければ人へ = fail-open）付き。route-decision（通話前）と verdict 遮断（通話中）は別レイヤ （詳細は SSoT）。
2階 — 頭脳（NAS）: aegis-platform / Aegis Cloud route-decision API 通話前の判定: block / human / ai 判定エンジン（classify_call → tools_core） 通話中の spam_score / should_terminate 1階 — エッジ（Pi）: voice-edge = Asterisk 22 + bridge.py Raspberry Pi 3B（1階・宅内） HGW（ひかり電話） Asterisk 22 dialplan 第1関門（着信時・通話前） curl → route-decision で 3 分岐 block → 切る Hangup(21) / 登録番号 human → 人へ通す Dial／fail-open も人へ ai → AI 対応 AudioSocket :9092 bridge.py 音声中継＋ツール呼出 第2関門（通話中） — AMI Status 逆引き → Hangup（B案 / D-1） 切断安全弁: spam_score ≥ 0.8 のときだけ切断（未満は fail-open）
図: 2階建て構成。1階=現場のエッジ（Pi: Asterisk 22 + bridge.py）、2階=頭脳（NAS: aegis-platform）。第1関門は着信時（通話前）: dialplan が curl で route-decision に問い合わせ、block / human / ai の 3 分岐。第2関門は通話中: AI が spam と判定すると bridge が AMI Status でチャンネルを逆引きして Hangup（B案）。切断安全弁（spam_score ≥ 0.8 のときだけ切断・満たさなければ人へ = fail-open）付き。実線の紫枠 = Raspberry Pi 3B（宅内）の機器境界で、HGW と 2階の NAS（aegis-platform）は枠外。※設計構造の図解であり、実機検証はこれから。
⚠️これは設計構造の図解

コード実装と Docker 上の検証は済んでいるが、実機（実電話番号・HGW・Pi）での検証はこれから。 性能値・動作保証はここには書かない。実機テスト後に「できる／できない」を確定する。

リポジトリ構成

リポ役割
aegis-platformクラウド本体（ダッシュボード / API / DB）
aegis-sip-bridgebridge.py（音声中継）
voice-edgePi の Asterisk 22 + dialplan + 繋がる口（メイン）
aegis-docsこのドキュメントサイト

数字でわかる現状

🧩 実装 18/20

Aegis Cloud 機能

Layer 3 の機能マップ

🖥️ 30 ページ

ダッシュボード

operator / reseller / client の3ロール

🔀 92 件

Pull Request

Merged 72 / Open 17 / Draft 2

🔍 19 件 修正済

レビュー指摘

全 26 件中（残課題 6）

主要機能（抜粋）

📞

着信の一次受付（Route A: Retell / Route C: OpenAI Realtime）

🛡️

spam=遮断 / unknown=人へ取次（fail-safe + fail-open）

🔐

Item A 迂回不能ゲート + 4-eyes 承認 + 監査ログ

🔌

MCP server（28 tools）/ Realtime / 録音暗号化 / 監視 v0.1

このサイトの歩き方（トリセツ）

ℹ️どこを見ればよいか
  • アーキテクチャを知りたい → 左メニュー「Layer 1〜4」
  • 進捗・PR・レビュー結果 → 「Phases」「PR Timeline」「Reviews & Findings」
  • 事業・価格 → 「Strategy & Pricing」
  • 言葉が分からない → 「用語集」（fail-safe / fail-open / verdict など）
📌更新のしかた（非エンジニアでも）

このサイトは データとページが分離しています。多くは src/data/*.ts を1行足すだけで反映されます。 詳しくは リポジトリ直下の README.md を参照（PR を増やしたら prs.ts、機能なら features.ts、用語なら glossary.ts に追記）。