Amazon Bedrock エージェントをアプリケーションにデプロイして統合する - Amazon Bedrock

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon Bedrock エージェントをアプリケーションにデプロイして統合する

Amazon Bedrock エージェントを初めて作成すると、作業中のドラフトバージョン (DRAFT) と、作業中のドラフトバージョンを指すテストエイリアス (TSTALIASID) が作成されます。エージェントに変更を加えると、変更が作業中のドラフトに適用されます。エージェントの動作に満足するまで、作業中のドラフトで繰り返し編集を行います。次に、アプリケーションへのデプロイと統合のために、エージェントのエイリアスを作成して、エージェントを設定できます。

エージェントをデプロイするには、エイリアスの作成が必要です。エイリアスの作成中に、Amazon Bedrock でエージェントのバージョンが自動的に作成されます。エイリアスはこの新しく作成されたバージョンを指します。または、以前に作成したバージョンのエージェントを指すようにエイリアスを変更することもできます。次に、そのエイリアスをAPI呼び出すようにアプリケーションを設定します。

バージョンは、それが作成されたときに存在していたリソースを保存したスナップショットです。作業中のドラフトを引き続き変更し、必要に応じてエージェントの新しいエイリアス (ひいてはバージョン) を作成できます。Amazon Bedrock で、エージェントの新しいバージョンを作成します。それには、この新しいバージョンをデフォルトで指すエイリアスを作成します。Amazon Bedrock は、バージョンを作成して、バージョン名として 1 から始まる番号を順に付けます。

バージョンは、エージェントの作成当時のスナップショットの役割を果たすため、変更できません。本番稼働中のエージェントを更新するには、新しいバージョンを作成し、そのバージョンを指すエイリアスに呼び出しを行うようアプリケーションを設定する必要があります。

エイリアスを使用すると、アプリケーションでバージョンを追跡しなくても、エージェントの複数のバージョン間を効率的に切り替えることができます。例えば、すぐに元に戻す必要がある変更の場合は、以前のバージョンのエージェントを指すようにエイリアスを変更できます。

エージェントをデプロイするには

  1. エージェントのエイリアスとバージョンを作成します。任意の方法のタブを選択し、ステップに従います。

    Console
    エイリアス (およびオプションで新しいバージョン) を作成するには

    1. IAM Amazon Bedrock のアクセス許可を持つ ロール AWS Management Console を使用して にサインインし、 で Amazon Bedrock コンソールを開きますhttps://console.aws.amazon.com/bedrock/。

    2. 左側のナビゲーションペインで [エージェント] を選択します。次に、[エージェント] セクションでエージェントを選択します。

    3. [エイリアス] セクションで、[作成] を選択します。

    4. [エイリアス名] に一意の名前を入力し、オプションで [説明] を入力します。

    5. [バージョンを関連付ける] で、次のいずれかのオプションを選択します。

      • 新しいバージョンを作成するには、[新しいバージョンを作成してこのエイリアスに関連付ける] を選択します。

      • 既存のバージョンを使用するには、[既存のバージョンを使用してこのエイリアスを関連付ける] を選択します。ドロップダウンメニューから、エイリアスを関連付けるバージョンを選択します。

    6. [スループットを選択] で、次のいずれかのオプションを選択します。

      • エージェントがアカウントに設定されたレートでモデル推論を実行できるようにするには、オンデマンド (ODT) を選択します。詳細については、「Amazon Bedrock のクォータ」を参照してください。

      • モデル用に以前に購入したプロビジョンドスループットを使用して、高いレートでエージェントにモデル推論を実行させるには、[プロビジョンドスループット (PT)] を選択してから、プロビジョンドモデルを選択します。詳細については、「Amazon Bedrock のプロビジョンドスループットでモデル呼び出し容量を増やす」を参照してください。

    7. [エイリアスを作成] を選択します。

    API

    エージェント用のエイリアスを作成するには、Agents for Amazon Bedrock ビルドタイムエンドポイントを使用してCreateAgentAliasリクエストを送信します。

    以下のフィールドが必要です。

    フィールド ユースケース
    agentId エイリアスを作成するエージェントの ID を指定する。
    agentName エイリアスの名前を指定する。

    次のフィールドはオプションです。

    フィールド ユースケース
    description エイリアスの説明を指定する。
    routingConfiguration エイリアスを関連付けるバージョン (新しいバージョンを作成する場合は空白のまま) と、エイリアスに関連付けるプロビジョンドスループットを指定する。
    clientToken API リクエストが 1 回だけ完了するようにするため。詳細については、「べき等性の確保」を参照してください。
    tags タグをエイリアスに関連付ける。

    コード例を見る

  2. アプリケーションを設定して エージェントをデプロイし、 を作成する InvokeAgent Agents for Amazon Bedrock ランタイムエンドポイントを使用した リクエスト。agentAliasId フィールドで、使用するエージェントのバージョンを指すエイリアスの ID を指定します。

    InvokeAgent レスポンスストリームには、レスポンスの各部分にチャンクを含む複数のイベントが順番に含まれます。ストリーミング設定で streamFinalResponseを に設定することで、オプションtrueでストリーミングを有効にできます。

    • エージェントに Guardrail が設定されている場合は、 applyGuardrailIntervalで を指定してStreamingConfigurations、送信レスポンス文字 (50 文字ごとなど) に対して ApplyGuardrailコールが行われる頻度を制御することもできます。

    • レスポンスストリーミングは現在、オーケストレーションプロンプトでのみサポートされています。

    • 引用は現在、ストリーミングではサポートされていません。

    • エージェント実行ロールに、設定されたエージェントモデルのbedrock:InvokeModelWithResponseStreamアクセス許可が含まれていることを確認します。