📖用語集
fail-safe / fail-open / fail-closed の使い分けと Phase C 用語。
aegis-sip-bridge/docs/glossary.md と整合。混同しやすい *fail- の 3 語**を最初に図示します。
fail-safe / fail-open / fail-closed(最重要)
fail-safe
spam と判定したら Hangup(遮断)
採用(spam への防衛)
verdict=spam → Hangup(21) fail-open
業務側に倒す=正当な着信を人へ転送
採用(Aegis の既定)
verdict=unknown/空/想定外 → Dial(PJSIP/${HUMAN_PEER}) fail-closed
全部切断(誰も通さない)
不採用
旧 dialplan の unknown→Hangup(C-2(b) で廃止) - verdict
- AI(classify_call)の判定を dialplan 用 3 値に正規化したもの。spam / allow / unknown。AstDB に aegis_verdict/${UNIQUEID} として書かれる。
- AstDB
- Asterisk 内蔵の Key-Value ストア。bridge が AMI 経由で verdict を書き、dialplan が ${DB(...)} で読む。
- AudioSocket
- Asterisk chan_audiosocket の TCP 音声プロトコル。[type:1][len:2 BE][payload]。bridge が 127.0.0.1:9092 で待受。type: 0x00=hangup / 0x01=UUID / 0x10=audio(μlaw 8kHz)。
- AMI
- Asterisk Manager Interface。bridge が AstDB に verdict を書く TCP 制御線(127.0.0.1:5039)。Action: DBPut を使う。
- HUMAN_PEER
- C-2(b) 業務側 fail-open の取次先(人手)。extensions.conf の placeholder。verdict が空/unknown/想定外、または bridge 不達のとき Dial(PJSIP/${HUMAN_PEER})。
- ALLOW_DESTINATION
- verdict=allow(正当な着信)時の通常転送先。extensions.conf の placeholder。
- classify_call
- OpenAI Realtime の tool。通話を分類して classification(spam/allow/unknown)等を返す。
- Aegis Cloud
- aegis-platform バックエンド。bridge は tool 実行を /api/realtime/tools/{tool_name} に転送する(AegisCloudProxy)。
- HGW
- ひかり電話などのホームゲートウェイ。Asterisk が内線として REGISTER して着信を受ける相手。
- commodity 箱
- Asterisk 配線とデプロイ手順だけをまとめた汎用パッケージ(bridge 本体は含まない)。
- Item A (strict_approval_mode)
- クライアント単位の迂回不能ゲート。loosen 方向の直接 write を 409 で拒否し、propose→approve→apply のみ許可。
- 4-eyes
- 提案者と承認者を別人に強制する二人承認。strict_approval / change_approval で適用。
✅Aegis の既定
spam だけ確実に切り(fail-safe)、それ以外は人へ繋ぐ(fail-open)。 bridge / AMI / OpenAI が落ちても「全切り(fail-closed)」にはしない(verdict=unknown → 人へ取次)。
ℹ️Phase C 用語
verdict / AstDB / AudioSocket / AMI / HUMAN_PEER / ALLOW_DESTINATION / classify_call / Aegis Cloud / HGW / commodity 箱 / Item A / 4-eyes — 定義は上の一覧(GlossaryView)に表示。