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

📖用語集

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)に表示。