/api/registry/agents、/api/registry/publishers)は、AAO 証明のメンバー登録エージェントのみを含みます。カタログに現れるには、AAO メンバーがメンバープロフィールでエージェントを明示的に登録しなければなりません。
エージェントがレジストリに入る方法
1 つのパスがあります: AAO メンバーがダッシュボードまたはPUT /api/me/member-profile 経由でエージェントをメンバープロフィールに追加。ダッシュボード経由でエンドツーエンド: 5 分未満。
- サインインまたはサインアップ。 agenticadvertising.org/auth/login に行きます。初めて? Sign up でアカウントを作成し、次に AAO 組織招待を受諾(またはあなたの組織がまだ AAO にない場合 メンバーシップを開始)。
- エージェントダッシュボードを開く。 サインインしたら、agenticadvertising.org/dashboard/agents に行きます。URL は組織コンテキストを自動解決します。
- ページ右上の
+ Register agentをクリック。(エージェントのないまったく新しい組織では、空状態 CTA は Register your first agent と読み、同じフローをトリガーします。) - Addie と話す。 ボタンは、プロンプト “Help me register my agent.” で事前ロードされた Addie とのチャットに入れます。Addie は以下を案内します:
- エージェント URL — 例:
https://agent.yourcompany.com/mcp - 表示名(オプション)
- 認証方法 — 1 つを選ぶ: None · Static bearer · Static basic · OAuth client credentials。(インタラクティブ OAuth ユーザー認可は別途構成 — ここでは None で登録し、次にエージェントカードの Authorize をクリックしてサインイン。)
- 認証フィールド — 選んだ方法が必要とするもののみ(bearer トークン、または client credentials の
token_endpoint+client_id+client_secretなど) - プロトコル — MCP にデフォルト。URL が曖昧な場合のみ Addie が尋ねる
- エージェント URL — 例:
- 完了。 Addie が
save_agentを呼び、あなたのエージェントはvisibility: "members_only"(他の有料 AAO メンバー — Professional、Builder、Member、Leader に可視。公開リストされない)でレジストリカタログに着地します。 - オプション — 公開に。
/dashboard/agentsに戻り、エージェントの可視性を Members only から Public に変更します。公開可視性は有料 AAO 階層(Professional、Builder、Member、Leader)と、エージェントがbrand.jsonに追加できるようメンバープロフィールのプライマリブランドドメインを要求します。
brand、sales、buying、measurement、creative、signals など)はエージェントのケイパビリティスナップショットから解決されます。resolveAgentTypes() はクローラーから最新のスナップショットを読みます。スナップショットがまだ存在しない場合、保存されるタイプフィールドはクライアントが供給したもので、次のクローラープローブがそれを上書きします。どちらの方法でも、誤ったタイプを永久にピン留めできません。
このパスが証明するもの: メンバーが AAO 条件に署名した。URL、名前、連絡先が明示的に宣言された。タイプがプローブ検証された。可視性は public、members_only、private になりえます — 下の Visibility を参照。
クロールされた adagents.json ファイルからの自動投入はありません。サードパーティ adagents.json ファイルにリストされたエージェントは、Operator ルックアップエンドポイント(GET /api/registry/operator?domain=X)、/api/registry/lookup/domain、hasValidAdagents が使うパブリッシャー認可グラフを投入しますが、カタログエントリーを作成しません。
プログラマティック登録(CI、スクリプト、エージェント用)
CI、デプロイフック、または自身のエージェントから — ダッシュボードや Addie なしで — エージェントを登録するには、/api/me/agents 下のエージェントごとの REST エンドポイントを使います。それらはダッシュボードパスと同じ可視性ゲート、サーバー側タイプ解決、監査ログを共有するので、members_only デフォルト、public の tier_required チェック、タイプスマグル保護がすべて同一に適用されます。
WorkOS API キー(Authorization: Bearer sk_…)または OAuth ユーザー JWT で認証します。agenticadvertising.org/dashboard/api-keys で API キーを作成します。
PATCH と DELETE のパスパラメーターはエージェントの
url、URL エンコード(例: https%3A%2F%2Fagent.example.com%2Fmcp)。POST は url で冪等: 新しいエントリーは 201 を返す。同じ url の再ポストは既存エントリーを更新し 200 を返す。各成功した書き込みは { agent, warnings? } を返す — warnings は任意の階層駆動の可視性ダウングレードをリスト(例: public を求める Explorer 階層呼び出し元は visibility_downgraded 警告で members_only として保存)。
前提条件
- あなたの組織の AAO メンバープロフィールが既に存在しなければならない。まずダッシュボードまたは
POST /api/me/member-profile経由で作成。それまでエージェントエンドポイントは404を返す。 visibility: "public"には、組織は有料 AAO 階層(Professional、Builder、Member、Leader)と、エージェントがbrand.jsonに追加できるようプロフィールに設定されたprimary_brand_domainを必要とする。下の Visibility を参照。
AAO メンバーでない場合これが何を意味するか
今日セルフ登録できません。あなたのオペレーターは、レジストリカタログにあなたのエージェントを登録するため AAO メンバーでなければなりません。 クロール発見リスティング(誰かのadagents.json で参照されるあなたのエージェント)はプロパティ認可チェックに使われる認可グラフを投入しますがカタログエントリーを作成しません — /api/registry/agents はメンバー専用です。
登録パスにアクセスするには メンバーになる。
Visibility
メンバー登録エージェントは 3 つの可視性レベルの 1 つを持ちます:/api/registry/operator?domain=X エンドポイントは認証対応: 匿名呼び出し元は public エージェントのみを見る。認証された AAO API 階層呼び出し元は members_only エージェントを見る。プロフィールオーナーは加えて private エージェントを見る。
メンバーシップの利益
登録パスにアクセスするには メンバーになる。
あなたのエージェントがどう現れるか検証
レジストリを直接クエリ:member がリスティングを所有する AAO 組織を識別します。レスポンスにない場合、どの AAO メンバーもそれを登録していません — オペレーターにメンバープロフィール経由で登録するよう頼むか、メンバーになって セルフ登録します。
あなたのエージェントがパブリッシャーの adagents.json で参照されているか(カタログ登録とは別の認可目的)をチェックするには、パブリッシャーのドメインに対して /api/registry/lookup/domain/{domain} を呼びます。
関連
- レジストリ概要 — エンドポイントカタログ、ルックアップフロー、ブランド解決。
GET /api/registry/operator?domain=X— エージェントと認可の認証対応エンティティごとビュー。GET /api/registry/agents— 完全なレジストリカタログ。POST /api/registry/crawl-request- 認可グラフのパブリッシャーのadagents.jsonマッピングをリフレッシュ。