View a markdown version of this page

AgentCore ランタイムのバージョニングとエンドポイント - Amazon Bedrock AgentCore
エンドポイントがバージョンを参照する方法バージョニングシナリオエンドポイントのライフサイクル状態AgentCore ランタイムバージョンとエンドポイントの一覧表示

AgentCore ランタイムのバージョニングとエンドポイント

Amazon Bedrock AgentCore は AgentCore ランタイムの自動バージョニングを実装し、エンドポイントを使用してさまざまな設定を管理できます。

Amazon Bedrock AgentCore の各 AgentCore ランタイムは、自動的にバージョニングされます。

  • AgentCore ランタイムを作成すると、AgentCore ランタイムはバージョン 1 (V1) を自動的に作成します。

  • AgentCore ランタイムを更新するたびに、完全で自己完結型の設定で新しいバージョンが作成されます。

  • 作成されたバージョンは変更できません

  • 各バージョンには、実行に必要なすべての設定が含まれています。

エンドポイントがバージョンを参照する方法

エンドポイントは、特定のバージョンの AgentCore ランタイムを参照する方法を提供します。

  • DEFAULT エンドポイントは、最新バージョンの AgentCore ランタイムを自動的にポイントします。

  • エンドポイントは特定のバージョンを参照できるため、さまざまな環境 (開発、ステージング、本番稼働など) を維持できます。

  • AgentCore ランタイムを更新すると、新しいバージョンを指すようにDEFAULTエンドポイントが自動的に更新されます。

  • エンドポイントは、新しいバージョンを指すように明示的に更新する必要があります

エンドポイントを新しいバージョンに更新する例 

bedrock_agentcore_client = boto3.client('bedrock-agentcore', region_name='us-west-2')

response = bedrock_agentcore_client.update_agent_runtime_endpoint(
    agentRuntimeId='agent-runtime-12345',
    endpointName='production-endpoint',
    agentRuntimeVersion='v2.1',
    description='Updated production endpoint'
)

print(response)

バージョニングシナリオ

次の表は、AgentCore ランタイムのライフサイクル中にバージョニングとエンドポイントがどのように相互作用するかを示しています。

変更タイプ バージョン作成の動作 最新バージョン エンドポイントの動作

初回作成

バージョン 1 (V1) を自動的に作成します

V1

デフォルトが V1 を指す

プロトコルの変更

更新されたプロトコル設定で新しいバージョンを作成します

V2

DEFAULT が V2 に自動的に更新される

V2 で「PROD」エンドポイントを作成する

新しいバージョンは作成されていません

V2

PROD エンドポイントが V2 をポイントする

コンテナイメージの更新

新しいコンテナリファレンスを使用して新しいバージョンを作成します

V3

V3 へのデフォルト更新、PROD は V2 のまま

「PROD」を V3 に更新する

新しいバージョンは作成されていません

V3

V3 への PROD 更新

ネットワーク設定の変更

セキュリティパラメータが更新された新しいバージョンを作成します

V4

V4 へのデフォルトの更新、PROD は V3 に残ります

エンドポイントのライフサイクル状態

AgentCore ランタイムエンドポイントは、ライフサイクル中にさまざまな状態を経ます。

[CREATING] (作成中)

エンドポイントの作成時の初期状態

CREATE_FAILED

アクセス許可、コンテナ、またはその他の問題による作成の失敗を示します

準備完了

エンドポイントはリクエストを受け入れる準備ができています

[UPDATING] (更新中)

エンドポイントは新しいバージョンに更新中です

UPDATE_FAILED

更新オペレーションの失敗を示します

AgentCore ランタイムバージョンとエンドポイントの一覧表示

AgentCore ランタイムのすべてのバージョンを一覧表示するには、 ListAgentRuntimeVersionsオペレーションを呼び出します。AgentCore ランタイムのエンドポイントを一覧表示するには、 を呼び出しますListAgentRuntimeEndpoints。