Amazon Bedrock AgentCore Gateway の主な概念

AgentCore Gateway は、エージェントがツール、他のエージェント、モデルにアクセスするための単一の安全なアクセスポイントを提供します。ゲートウェイは、MCP、HTTP、推論の 3 つのカテゴリにまたがる複数のターゲットを持つことができます。MCP ターゲットの場合、ゲートウェイは集約モードで動作し、すべての MCP ターゲットの機能を統合仮想 MCP サーバーに結合する MCP サーバーとして機能します。HTTP ターゲットの場合、ゲートウェイは集約やプロトコル変換を行うことなく、トラフィックをターゲット (別のエージェントや A2A サービスなど) に直接送信します。推論ターゲットの場合、ゲートウェイは、統合されたモデルベースのルーティングエンドポイントを介して LLM リクエストを 1 つ以上のモデルプロバイダーにルーティングします。

ターゲットは、ゲートウェイが接続するバックエンドを定義します。ターゲットには 3 つのカテゴリがあります。MCP ターゲットは、ゲートウェイが統合 MCP サーバーに集約する APIs、Lambda 関数、MCP サーバー、またはツール定義を定義します。HTTP ターゲットは、ゲートウェイがリクエストを直接プロキシする AgentCore ランタイムエージェントやその他のエージェントなどの HTTP ベースのサービスを定義します。推論ターゲットは、LLM トラフィックを統合エンドポイントを介して 1 つ以上のモデルプロバイダーにルーティングし、リクエストされたモデルに基づいて送信先を選択します。

各ゲートウェイには、クライアントアクセスを制御するためのインバウンド認可設定が必要です。ゲートウェイは、トークンベースの認可用の OAuth (JWT)、 AWS アイデンティティベースの認可用の IAM (AWS 署名バージョン 4)、ターゲットに認可を委任中のトークンの検証用の認証のみ、開発およびテストシナリオ用の認可なしのインバウンド認可タイプをサポートしています。ゲートウェイを作成または更新するときに、オーソライザーを設定できます。

Gateway が APIs または Lambda 関数を呼び出すときは、いくつかの認証情報を使用してそれらの機能にアクセスする必要があります。Smithy または Lambda ターゲットを作成すると、Gateway はアタッチされた実行ロールを使用してそれらのターゲットを呼び出します。OpenAPI または MCP サーバーターゲットを作成するときに、API キーまたは OAuth 認証情報を保存する AgentCore 認証情報プロバイダーをアタッチしたり、SigV4 署名を使用して IAM ベースの認可を設定したり、パブリックにアクセス可能なエンドポイントに対して認可を使用しないしたりできます。

MCP ターゲットは集約モードで動作します。ゲートウェイは、すべての MCP ターゲットの機能を 1 つの統合仮想 MCP サーバーに結合します。クライアントには、アタッチされたすべての MCP ターゲットのツールを含む 1 つの統合tools/listレスポンスが表示されます。MCP ターゲットは、ターゲットレベルで機能同期、セマンティックツール検索、3 レッグ OAuth (3LO) をサポートしています。MCP ターゲットタイプには、Lambda 関数、API Gateway REST APIs、OpenAPI 仕様、Smithy モデル、MCP サーバー、組み込み統合プロバイダーテンプレート、ツールへの組み込みコネクタなどがあります。

HTTP ターゲットは、集約やプロトコル変換を行うことなく、トラフィックをターゲットに直接送信します。HTTP ターゲットは、機能同期またはセマンティックツール検索をサポートしていません。クライアントは、パスベースのルーティングを通じて各ターゲットに個別に対応します。HTTP ターゲットタイプには、Amazon Bedrock AgentCore ランタイムエージェント、他のエージェント (Agent-to-Agent (A2A) サービスを含む）、外部 MCP サーバー、パススルーターゲットを介して到達した HTTP エンドポイントが含まれます。

推論ターゲットは、統合エンドポイントを介して 1 つ以上のモデルプロバイダーに大規模言語モデル (LLM) トラフィックをルーティングします。ゲートウェイは、リクエストの modelフィールドに基づいて送信先プロバイダーを選択し、Amazon Bedrock、OpenAI、Anthropic などのプロバイダー間で一貫した単一のインターフェイスをエージェントに提供します。

OpenAPI 仕様を提供することで、既存の REST APIs を MCP 互換ツールに変換します。ゲートウェイは MCP 形式と REST 形式間の変換を自動的に処理します。

Lambda 関数をツールとして接続することで、任意のプログラミング言語でカスタムビジネスロジックを実装できます。ゲートウェイは Lambda 関数を呼び出し、レスポンスを MCP 形式に変換します。

Smithy モデルを使用して API インターフェイスを定義し、MCP 互換ツールを生成します。Smithy は、 サービスで使用できる AWS サービスと SDKs を定義するための言語です。ゲートウェイは Smithy モデルを使用して、 AWS サービスまたはカスタム APIs。

リモート MCP サーバーを使用して、ツール、プロンプト、リソースをエージェントのランタイムに接続します。Gateway は MCP ツール、プロンプト、リソース機能をサポートしています。ツールは必須です。プロンプトとリソースはオプションです。プロンプトは、引数を持つ再利用可能なプロンプトテンプレートを提供します。リソースは、URIs によって識別されるコンテキストデータを提供します。同期中、ゲートウェイは MCP サーバーがアドバタイズするすべての機能を検出します。

統合プロバイダーの事前設定済みテンプレートを使用します。

ツールへの組み込みコネクタを使用します。