> ## Documentation Index
> Fetch the complete documentation index at: https://adcp-docs-ja.pier1.co.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# AAO 管理者向け AAO

> 内部リファレンス — AAO スタッフのための編集モデレーション、エスカレーショントリアージ、システム設定、メンバーディレクトリ運用。

# AAO 管理者向け AAO

このページは、グローバル管理者ロールを持つ AAO スタッフ向けです — 編集レビュー、エスカレーショントリアージ、メンバー運用、システム管理を実行する AgenticAdvertising.org チームの人々。意図的に狭く運用的です。

このページは Addie が管理者の質問に正しく答えられるよう Addie の `search_docs` によってインデックスされますが、検索エンジンには `noindex: true` で、公開ドキュメントサイドバーからは隠されています。

エンドユーザードキュメントについては [メンバー向け AAO](/docs/aao/users) を参照してください。組織管理者ドキュメントについては [組織管理者向け AAO](/docs/aao/org-admins) を参照してください。Addie のツールの完全なリストについては [Addie ツールリファレンス](/docs/aao/addie-tools) を参照してください。

## 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 がときどきサインインに逸らす。レジストリのバグではなく動作ギャップ。