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 エイリアスの名前を指定するには。

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

    フィールド ユースケース
    説明 エイリアスの説明を指定します。
    routingConfiguration エイリアスを (新しいバージョンを作成するには空白のまま) に関連付けるバージョンと、エイリアスに関連付けるプロビジョンドスループットを指定するには。
    clientToken API リクエストが 1 回のみ完了するようにするための識別子。
    タグ タグをエイリアスに関連付けるには。

    コード例を参照

  2. アプリケーションを設定してエージェントをデプロイして を作成する InvokeAgent Agents for Amazon Bedrock ランタイムエンドポイント を使用した リクエスト (リクエストとレスポンスの形式とフィールドの詳細についてはリンクを参照）。agentAliasId フィールドで、使用するエージェントのバージョンを指すエイリアスの ID を指定します。