Skip to main content

​
AAO 管理者向け AAO

このページは、グローバル管理者ロールを持つ AAO スタッフ向けです — 編集レビュー、エスカレーショントリアージ、メンバー運用、システム管理を実行する AgenticAdvertising.org チームの人々。意図的に狭く運用的です。 このページは Addie が管理者の質問に正しく答えられるよう Addie の search_docs によってインデックスされますが、検索エンジンには noindex: true で、公開ドキュメントサイドバーからは隠されています。 エンドユーザードキュメントについては メンバー向け AAO を参照してください。組織管理者ドキュメントについては 組織管理者向け AAO を参照してください。Addie のツールの完全なリストについては Addie ツールリファレンス を参照してください。

​
AAO 管理者になる

AAO 管理者ステータスは、デプロイされたアプリの ADMIN_EMAILS 環境変数と（別途）ユーザーレコードの is_aao_admin カラム経由で付与されます。完全なアクセスには両方が設定されなければなりません — ADMIN_EMAILS は Addie から管理者ツールを呼べるようにし、is_aao_admin は /admin の管理者ウェブ UI を使えるようにします。

​
エスカレーショントリアージ

メンバーと訪問者は、Addie が助けられないときエスカレートを依頼できます。エスカレーションはデータベースに着地し、構成されたエスカレーションチャネルに Slack 通知が発火します。
  • キューをレビュー。 /admin/addie（Escalations タブ）のウェブ UI、または Addie に 「list open escalations」（list_escalations）と尋ねる。
  • 自動トリアージ提案。 server/src/addie/jobs/escalation-triage.ts の予定ジョブが、証拠（URL プローブ、関連エスカレーション ID）を伴うオープンなエスカレーションのステータス遷移を提案します。提案は escalation_triage_suggestions に着地し、適用前に管理者の承認/拒否を必要とします — すべてのクローズに背後にオペレーターがいます。
  • 任意のスレッドから解決。 「Resolve escalation 142, paid the invoice」（resolve_escalation） — リクエストが意図的に実行不可能なとき wont_do が正しいステータス。resolved は依頼されたことが起こったことを意味します。
  • カテゴリー。 capability_gap（Addie の知識が更新を必要とする）、needs_human_action（管理者が何かをしなければならなかった）、complex_request（マルチステップ / 判断）、sensitive_topic（法務/コンプライアンス/政治）、other。

​
編集モデレーション（パースペクティブ）

  • レビューキュー。 /admin/perspectives のウェブ UI が pending_review を表示。または Addie に 「list pending content」（list_pending_content）と尋ねる。
  • 承認 / 辞退。 「Approve perspective [slug]」（approve_content）、「reject perspective [slug] with reason …」（reject_content）。
  • テスト投稿。 レビューをバイパスして公開されたテストパースペクティブ（インシデント #271）は古い公開パスから来ます。正準パスは propose_content → レビュー → 承認です。レビューなしでテストコンテンツがライブになっているのを見たら、インシデントを提出してください — それはワークフローではなく実際のバグです。

​
メンバーディレクトリ運用

  • メンバーのリスト / 取得。 「Show member directory for [filter]」（list_members、get_member）。公開ルックアップは匿名安全。完全な連絡先詳細には管理者が必要。
  • 見込み客に支払いリクエストを送る。 send_payment_request（admin-tools.ts）が、受信者がサインインして受諾する招待を発行します。彼らのメールは受諾時に結果の Stripe 顧客にバインドされ、呼び出し元供給の入力から決して信頼されません。
  • メンバーシップの無料提供 / 割引。 $0 製品またはクーポンで send_payment_request を使う。異常なケース（チャプターリード、コントリビューター）については、エスカレートするか課金と手動で調整。
  • 組織内での昇格 / 降格。 今日これはデータベース操作です。scripts/ 下の CLI スクリプトが一般的なケースをカバーします。ツール表面に取り組んでいます。

​
ポートレート管理

メンバーはプロフィールページから自身のイラストポートレートを管理できます。Addie のメンバースコープのポートレートツール（check_portrait_status、offer_portrait_generation）は呼び出し元自身のメンバー組織コンテキストでのみ動作します。 管理者モデレーションは管理者ポートレート API を使います:
  • ポートレートのリスト。 GET /api/admin/portraits?status=generated がレビュー用の生成済みポートレートを返します。他のキューを検査するには status=approved を使うか status を省略。
  • アクティブなポートレートのマップ。 GET /api/admin/portraits/map がディレクトリチェック用の軽量なユーザー対ポートレートマッピングを返します。
  • ポートレートの削除。 DELETE /api/admin/portraits/:id がポートレートを拒否し、それがアクティブなポートレートならメンバーからクリアします。

​
システム設定

  • エスカレーションチャネル。 system_settings.escalation_channel が Addie がエスカレーション通知を投稿する場所を制御します。管理者ウェブ UI 経由で更新。
  • ワーキンググループチャネル。 system_settings.wg_channel_* が各 WG を Slack チャネルにマップします。
  • 監査ログ。 system_settings_audit がすべての変更を記録します — /admin/audit でレビュー。

​
内部フラグとゲート

  • ADMIN_EMAILS — カンマ区切り環境変数、Addie 管理者ツール登録を制御。
  • ALLOW_INSECURE_COOKIES — 開発のみ。本番で設定しない。
  • ANTHROPIC_API_KEY — Addie チャットが機能するために必須。
  • ANONYMOUS_DAILY_LIMIT_USD — 日次匿名使用上限。anonymousChat モデルをゲート。

​
さらにエスカレートすべきこと（運用ではなくエンジニアリング）

  • 短いフォローアップでの空のアシスタントメッセージ — claude-client.ts で調査が必要。
  • 重複メッセージバグ（#124） — 同じレスポンスが 2 回投稿される。
  • 古い search_docs インデックスの症状 — ローカルで npm run start 経由でプローブを実行し、searchDocs(query) を直接呼んで確認。
  • 匿名モードツール拒否 — ツールが ANONYMOUS_SAFE_KNOWLEDGE_TOOLS にあっても Addie がときどきサインインに逸らす。レジストリのバグではなく動作ギャップ。