ゲートウェイリソースを作成、保守、使用するための依存関係と認証情報を設定する
AgentCore Gateway サービスには、次の主要なプロセスが含まれます。
-
ゲートウェイリソースの作成とメンテナンス – Amazon Bedrock AgentCore コントロールプレーンサービスを使用して、ゲートウェイとゲートウェイターゲットリソースを作成できます。
-
ゲートウェイの呼び出し – ゲートウェイとゲートウェイターゲットを作成した後、ゲートウェイへの直接 HTTP リクエスト、または MCP クライアントまたはエージェントの助けを借りてゲートウェイを呼び出すことができます。
トピックを選択して、これらのプロセスを実行するためのツールと認証情報の設定について学習します。
ゲートウェイリソースの作成とメンテナンスのためのツールと認証情報を設定する
Amazon Bedrock AgentCore コントロールプレーンサービスを呼び出すことで、ゲートウェイおよびゲートウェイターゲットリソースに関する情報を作成、変更、削除、取得します。Amazon Bedrock AgentCore Control Plane サービス API リファレンスは、このサービスの API オペレーションと構造に関する詳細情報です。
Amazon Bedrock AgentCore コントロールプレーンサービスは、次の方法で操作できます。トピックを展開して、ツールをインストールして認証を設定する方法について説明します。
AWS マネジメントコンソールでは、ウェブブラウザのインタラクティブなグラフィカルインターフェイスを使用して、ゲートウェイとゲートウェイターゲットリソースを作成および維持できます。
-
インストール – 不要。AgentCore コンソールを使用してゲートウェイを管理するには、https://console.aws.amazon.com/bedrock-agentcore/home#
に移動し、左側のナビゲーションペインからゲートウェイを選択します。 -
認証 – AgentCore Gateway アクションを使用するアクセス許可を持つ IAM ID でサインインします。
各 API オペレーションの Amazon Bedrock AgentCore Control Plane サービス API リファレンスページには、API リクエストを行うために必要な情報が表示されます。
-
インストール – 不要。
-
認証 – 認可ヘッダーまたはクエリパラメータ (AWS 署名バージョン 4 を使用) を使用して認証できます。
AWS SDKsを使用すると、任意のプログラミング言語を使用して AWS のサービスに API リクエストを行うことができます。AWS SDKs およびツールリファレンスガイドの以下のリソースを参照してセットアップしてください。
-
インストール — SDK とそのインストール方法については、選択したプログラミング言語に対応するリンクの AWS SDK を選択します。
-
認証 – SDKs と認証の設定については、このガイドの関連セクションのリンクを参照してください。
-
その他のリソース – 言語固有のリファレンスで、Amazon Bedrock AgentCore Core Control サービスを検索して、特定の API メソッドの構文を確認します。
AWS コマンドラインインターフェイス (CLI) を使用すると、コマンドラインインターフェイスで AWS API を操作できます。 AWS CLI をインストールしてセットアップする方法については、AWS 「 コマンドラインインターフェイスユーザーガイド」のAWS 「 CLI の開始方法」を参照してください。
-
インストール — AWS CLI をインストールする方法については、「最新バージョンの AWS CLI のインストールまたは更新」を参照してください。
-
認証 – AWS CLI での認証情報の設定については、AWS 「CLI のセットアップ」を参照してください。
-
その他のリソース – Amazon Bedrock AgentCore コントロールプレーンサービスの特定の API メソッドの構文を確認するには、bedrock-agentcore-control reference」を参照してください。
AgentCore CLI は、AgentCore API を操作するための Node.js コマンドラインツールです。AgentCore CLI リポジトリ
-
インストール – AgentCore CLI をインストールするには、次のコマンドを実行します。
npm install -g @aws/agentcore -
認証 – AWS 認証情報にアクセスして AgentCore CLI 用に設定するには、「IAM アイデンティティセンターを使用して AWS SDK とツールを認証する」の手順に従います。
-
その他のリソース – AgentCore CLI を使用して AgentCore Gateway を操作する方法の詳細については、AgentCore CLI リポジトリ
」を参照してください。
ゲートウェイの呼び出し
ゲートウェイとゲートウェイターゲットを作成したら、直接 HTTP リクエストまたは MCP クライアントまたはエージェントを介してゲートウェイとやり取りできます。
AgentCore ゲートウェイに HTTP リクエストを行うには、ゲートウェイの作成時に設定したゲートウェイエンドポイントに POST リクエストを行います。
-
インストール – 不要。
-
認証 – 認可ヘッダーまたはクエリパラメータ (AWS 署名バージョン 4 を使用) を使用して認証できます。
MCP クライアントを使用して AgentCore ゲートウェイを操作するには、環境のセットアップと、選択したプログラミング言語を選択した後の MCP クライアントの構築の API キーのセットアップの手順に従って、MCP クライアントをインストールする必要があります。 https://modelcontextprotocol.io/docs/develop/build-client
Strands Agents SDK を使用して AgentCore ゲートウェイを操作するには、Strands Agents SDK の手順に従って Strands SDK
Langgraph エージェントを使用して AgentCore ゲートウェイを操作するには、LangGraph に移動し、Docs を選択し、選択したプログラミング言語に対応する LangGraph ページを選択して、LangGraph