エージェントの保守

​

登録のおさらい

• visibility: "members_only" の /api/registry/agents のカタログエントリー（有料 AAO 階層で public にアップグレード）
• コンプライアンスハートビートで該当ストーリーボードを通過すると自動的に発行される AAO Verified バッジの適格性

​

AAO Verified ハートビートの仕組み

• AdCP ワイヤー形式とタスク形状
• エラーセマンティクスとエラーエンベロープ
• メディアバイまたは該当ライフサイクル全体のステートマシン遷移
• 宣言された専門分野が動作するツールにマップ
• スキーマ適合性とフィルター動作
• 冪等性セマンティクス

​

Verified (Spec) 対 Verified (Sandbox)

​

ダッシュボードステータスインジケーター

​

手動で再プローブをトリガーする方法

​

レジストリクロール（メタデータ更新）

curl -X POST "https://agenticadvertising.org/api/registry/crawl-request" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"yourcompany.com"}'

const res = await fetch(
  "https://agenticadvertising.org/api/registry/crawl-request",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ domain: "yourcompany.com" }),
  }
);
// Returns 202 Accepted — crawl runs asynchronously

• あなたのエージェントのレジストリメタデータ（タイプ解決、ケイパビリティスナップショット、adagents.json 認可グラフ）をリフレッシュする
• コンプライアンスハートビートの再実行を トリガーしない — ハートビートストーリーボードはこのエンドポイントで再実行されない

​

ダッシュボード Refresh ボタン

​

コンプライアンス再キュー

​

comply レポートの読み方

​

レポート構造

​

ストーリーボードごとの判定

​

失敗のデバッグ

1. 失敗した行からストーリーボード名をメモ（例: signed_requests、pagination_integrity、comply-controller-mode-gate）。
2. コンプライアンスカタログ でストーリーボード定義を見つける。
3. ローカルに再現:
   npx @adcp/sdk@latest storyboard run signed_requests --agent-url https://your-agent-url.example/mcp
   
4. ローカルランナーはハートビートと同じアサーションを与えます。失敗を修正し、ローカルで検証し、次にデプロイ — すべてのストーリーボードが通過すれば次のハートビートサイクルがバッジを再発行します。

​

関連

• エージェントの登録 — 登録パス、フィールド、プログラマティック登録。
• レジストリ API 概要 — POST /api/registry/crawl-request と完全なエンドポイントカタログ。
• AAO Verified — 完全なライフサイクル状態、軸セマンティクス、バッジ埋め込み。
• コンプライアンスカタログ — ストーリーボードインデックス、専門分野ごとカバレッジ、ストーリーボードをローカルで実行する方法。