View a markdown version of this page

AWS マネジメントコンソールを使用して AgentCore ゲートウェイを作成する - Amazon Bedrock AgentCore

AWS マネジメントコンソールを使用して AgentCore ゲートウェイを作成する

コンソールを使用してゲートウェイを作成するには

  1. https://console.aws.amazon.com/bedrock-agentcore/home# で AgentCore コンソールを開きます。

  2. 左側のナビゲーションペインで、ゲートウェイを選択します。

  3. ゲートウェイ セクションで、ゲートウェイの作成 を選択します。

  4. (オプション) ゲートウェイの詳細セクションで、次の操作を行います。

    1. 生成されたゲートウェイ名を変更する

    2. 追加設定セクションを展開し、次の操作を行います。

      1. Gateway description フィールドに、ゲートウェイの説明を入力します。

      2. 指示 フィールドに、ツールが呼び出されたときに渡す特別な指示やコンテキストを入力します。

      3. ゲートウェイでツールを検索するための組み込みツールを有効にするには、セマンティック検索を有効にする を選択します。このツールを有効にすると、後で無効にすることはできません。詳細については、「自然言語クエリを使用して AgentCore ゲートウェイでツールを検索する」を参照してください。

      4. ゲートウェイレスポンスで詳細なデバッグメッセージが返されるようにするには、例外レベルのデバッグ を選択します。メッセージのデバッグは後で無効にできます。詳細については、「デバッグメッセージの有効化」を参照してください。

  5. インバウンド認証設定セクションで、次のいずれかのオプションを選択します。

    • Amazon Cognito が認可リソースを作成できるようにするには、Cognito でクイック作成設定を選択します。

    • すでに設定した認可設定を使用するには、既存の ID プロバイダー設定を使用するを選択し、次のフィールドを設定します。

      • 検出 URL – ID プロバイダーの検出 URL を入力します。

      • 許可された対象者 – ゲートウェイが受け入れる対象者の値を入力します。さらに対象者を追加するには、対象者の追加を選択します。

      • 許可されたクライアント – ゲートウェイが受け入れるクライアントのパブリック識別子を入力します。さらにクライアントを追加するには、クライアントの追加を選択します。

      • 許可されたスコープ – JWT トークンのスコープクレームに対して検証される許可されたスコープのリストを入力します。allowedScopes 認可フィールドは文字列のリストとして設定されます。

      • 必須のカスタムクレーム – 受信 JWT トークンに含まれるクレーム名と値に対して検証される必須クレームのリストを入力します。オーソライザーの設定の詳細については、「インバウンド JWT オーソライザーの設定」を参照してください。

  6. [許可] セクションで、以下の操作を行います。

    1. IAM サービスロールを使用してユーザーに代わってゲートウェイを呼び出すには、IAM サービスロールを使用するを選択します。

    2. (IAM サービスロールを使用する場合) IAM ロール で次のいずれかのオプションを選択します。

      • ゲートウェイにアクセスするために必要なアクセス許可を持つサービスロールを作成するには、新しいサービスロールを作成して使用し、オプションで生成されたサービスロール名を変更します。

      • 既存のサービスロールを使用するには、「既存のサービスロールを使用」を選択し、「サービスロール名」ドロップダウンメニューからロールを選択します。選択したサービスロールに必要なアクセス許可があることを確認します。詳細については、AgentCore Gateway サービスロールのアクセス許可」を参照してください。

  7. (オプション) デフォルトでは、ゲートウェイは AWS マネージドキーで暗号化されます。カスタム KMS キーでゲートウェイを暗号化するには、KMS キーセクションを展開し、暗号化設定をカスタマイズ (詳細) を選択し、カスタマーマネージドキーを選択します。詳細については、「カスタマーマネージド KMS キーを使用して AgentCore ゲートウェイを暗号化する」を参照してください。

  8. ターゲット: ${target-name} セクションで、次の操作を行います。

    1. (オプション) 生成されたターゲット名を変更します。

    2. (オプション) ターゲットの説明を入力します。

    3. ターゲットタイプ で、オプションを選択します。さまざまなターゲットタイプの詳細については、「既存の AgentCore ゲートウェイにターゲットを追加する」を参照してください。

    4. ターゲットタイプの定義方法を選択または入力します。

    5. アウトバウンド認証設定 で、アウトバウンド認可方法を選択します。次に、必要な詳細とオプションの追加設定を選択または指定します。詳細については、「ゲートウェイのアウトバウンド認可を設定する」を参照してください。

  9. さらにターゲットを追加するには、別のターゲットを追加を選択し、ターゲット設定ステップを繰り返します。

  10. [Create gateway (ゲートウェイの作成) ] を選択します。

ゲートウェイを作成したら、エンドポイント URL と関連するターゲットなど、その詳細を表示できます。