概念と用語
今後の名前空間の移行
AWS エージェントレジストリは現在、bedrock-agentcore 名前空間のパブリックプレビュー中です。2026 年 8 月 6 日以降、サービスはエージェントレジストリ名前空間に移動します。 AWS エージェントレジストリを使用する場合は、エンドポイント、IAM ポリシー、SDK クライアント、CLI スクリプト、レジストリデータを更新する必要があります。パブリックプレビューからの移行の詳細については、「包括的なレジストリ移行ガイド」を参照してください。
レジストリ
レジストリは、リソースを整理および管理するために AWS アカウントで作成する一元化されたカタログです。各レジストリには、名前、説明、コンシューマーが検索 API と MCP APIs にアクセスする方法を制御する認可設定、および検出可能になる前にレコードを手動でレビューする必要があるかどうかを判断する承認設定があります。
レジストリの整理方法は、ニーズによって異なります。例えば、さまざまなリソースタイプの専用レジストリ (エージェントレジストリ、MCP サーバーレジストリ、スキルレジストリ）、さまざまな開発段階のレジストリ (本番、QA、開発）、さまざまなチームやビジネスユニットの独立レジストリ、組織全体の単一のレジストリなどです。
レジストリレコード
レジストリレコードは、レジストリに公開された個々のリソースのメタデータを表します。各レコードは、基盤となるリソースを記述するキーメタデータをキャプチャします。つまり、リソースの内容、動作、および検出方法に関する情報を提供します。レコードには、名前、オプションの説明、バージョン、タイプ、resource-type-specificメタデータがあります。
リソースタイプ:
MCP サーバー — Model Context Protocol (MCP) サーバーは、AI エージェントが検出して呼び出すことができるツールを提供します。MCP サーバーレコードには、入力パラメータや出力形式など、サーバーが提供するすべてのツールのサーバー設定とツール定義を記述するサーバー定義が含まれています。 AWS エージェントレジストリは MCP サーバーレコードを MCP プロトコルスキーマ
エージェント — エージェントは、タスクを達成するための理由、計画、およびアクションを実行できる自律型プログラムです。エージェントレコードには、A2A (Agent-to-Agent) プロトコル仕様に従ってエージェントの機能、スキル、および通信インターフェイスを記述するエージェントカードが含まれています。 AWS エージェントレジストリは、エージェントレコードを A2A プロトコルスキーマと照合して検証し、正確性を確認します。 Agent-to-Agent
スキル — スキルは、エージェント間で共有できる再利用可能な機能です。スキルレコードには、名前、説明、パッケージやリポジトリの詳細などのオプションのアクセス情報、スキルの動作とその使用方法を説明するオプションのマークダウンドキュメントなどの基本的な記述子メタデータが含まれています。
カスタムリソース — 上記の標準タイプに適合しないリソースの場合、任意の有効な JSON 構造を使用して独自のメタデータスキーマを定義できます。
認証情報プロバイダー
外部ソース (アウトバウンド認可) からのメタデータを同期するようにレジストリレコードを設定する場合、 AWS エージェントレジストリには、そのソースにアクセスするための認証情報が必要です。認証情報プロバイダーは、 AWS エージェントレジストリが同期中に外部リソースのエンドポイントを呼び出すために使用する OAuth 認証情報または IAM ロールのいずれかの承認の詳細を保存します。レコードで同期を設定するときに、ARN で認証情報プロバイダーを参照します。詳細については、「認証情報プロバイダーの管理」を参照してください。
レジストリ認可には 2 つのタイプがあります。
-
インバウンド認可: この設定により、レジストリ管理者は、コンシューマーがレジストリを検索する方法を制御できます ( AWS CLI、 AWS SDK、または MCP エンドポイントを呼び出す）。レジストリは、IAM ベースおよび JWT ベースのインバウンド認可をサポートしています。レジストリ管理者は、レジストリを作成するためのワークフローの一部としてこれを指定します。
-
アウトバウンド認可: MCP レコードと A2A レコードをリモートエンドポイントと同期する (同期がセットアップされているレコードの場合) の一環として、レジストリには、指定されたエンドポイントでリモートリソースを呼び出してメタデータを取得するためのアウトバウンド認証情報が必要です。パブリッシャーは、特定のレジストリレコードの同期ジョブの設定の一環として、これらの認証情報を提供します。
キーペルソナ
レジストリを使用するペルソナは、組織によって異なる場合があります。ただし、 レジストリとやり取りする以下の一般的なペルソナは、組織全体に共通しています。
- 管理者
-
管理者はレジストリインフラストラクチャの所有者です。 AWS アカウント内でレジストリを作成および設定し、各レジストリの編成方法 (チーム、環境、リソースタイプ別) を決定し、コンシューマーがレジストリにアクセスする方法を決定する認可方法 (IAM または JWT) を選択します。管理者は、レコードに手動レビューが必要か自動承認かを決定し、レジストリを組織の既存の通知およびレビューシステムに接続するように Amazon EventBridge 統合を設定します。IAM アクセス許可を管理し、どのパブリッシャー、キュレーター、コンシューマーが各レジストリにアクセスできるかを制御します。管理者であるため、レコードを作成、更新、削除するためのフルアクセスもでき、必要に応じてレコードを承認、拒否、または廃止できます。
- パブリッシャー
-
パブリッシャーは、MCP サーバー、エージェント、スキル、またはその他のツールなどのリソースを作成した組織内のビルダーであり、他のユーザーが見つけられるようにしたいと考えています。パブリッシャーは、リソースを記述するレジストリレコードを作成し、他のユーザーがリソースの動作を見つけて理解するのに役立つメタデータ、定義、バージョン情報を提供します。ドラフトステータスのレコードを反復処理し、レコードの準備ができるまで説明とスキーマを絞り込み、承認のために送信します。レコードが拒否された場合、パブリッシャーはキュレーターのフィードバックを確認し、必要な変更を行い、再送信します。パブリッシャーは、手動更新なしでレコードがライブ MCP サーバーと同期されるように URL ベースの同期を設定することもできます。
- キュレーター/承認者
-
Curator はレジストリの品質ゲートキーパーであり、多くの場合、レジストリの管理者でもあります。パブリッシャーが承認のために送信したレコードを確認し、セキュリティ、コンプライアンス、メタデータの完全性、および組織が定義するその他の基準に関する組織の標準に照らして各レコードを評価します。キュレーターは、これらの基準を満たすレコードを承認します。レコードは検索結果や MCP エンドポイントを通じて表示され、表示されないレコードは拒否され、修正が必要な点について明確なフィードバックが提供されます。リソースが廃止されるか、既知の問題がある場合、または新しいバージョンに置き換えられると、キュレーターはレコードを非推奨にして検出から削除します。キュレーターは、組織全体のビルダーが信頼できる高品質のカタログを維持できるようにします。
- コンシューマー
-
コンシューマーは、リソースを見つけて使用する必要がある人間またはエージェントです。コンシューマーは、自然言語クエリまたはキーワード検索を使用してレジストリを検索し、承認および公開された MCP サーバー、エージェント、スキル、その他のリソースを検出します。また、任意の MCP 互換クライアントを使用してレジストリの MCP エンドポイントに接続し、利用可能なツールをプログラムで検出することもできます。コンシューマーは承認されたレコードのみを表示するため、レジストリで見つかったすべてがレビューされ、組織の品質基準を満たしていることを信頼できます。コンシューマーは、レジストリの設定方法に応じて、IAM 認証情報または企業 ID プロバイダーからの JWT トークンを介して を承認できます。
