View a markdown version of this page

AgentCore 執行期版本控制和端點 - Amazon Bedrock AgentCore
端點如何參考版本版本控制案例端點生命週期狀態列出 AgentCore 執行期版本和端點

AgentCore 執行期版本控制和端點

Amazon Bedrock AgentCore 實作 AgentCore 執行期的自動版本控制，並可讓您使用端點管理不同的組態。

Amazon Bedrock AgentCore 中的每個 AgentCore 執行期會自動版本化： AgentCore

  • 當您建立 AgentCore 執行期時，AgentCore 執行期會自動建立版本 1 (V1)

  • AgentCore Runtime 的每個更新都會建立具有完整、獨立組態的新版本

  • 版本在建立後是不可變的

  • 每個版本都包含執行所需的所有組態

端點如何參考版本

端點提供參考 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 的 DEFAULT 更新，PROD 保留在 V2 上

將「PROD」更新至 V3

未建立新版本

V3

V3 的 PROD 更新

網路設定修改

使用更新的安全性參數建立新的版本

V4

對 V4 的 DEFAULT 更新，PROD 保留在 V3

端點生命週期狀態

AgentCore 執行期端點在其生命週期內會經歷各種狀態：

CREATING

建立端點時的初始狀態

CREATE_FAILED

指出由於許可、容器或其他問題導致的建立失敗

就緒

端點已準備好接受請求

UPDATING

端點正在更新至新版本

UPDATE_FAILED

表示更新操作失敗

列出 AgentCore 執行期版本和端點

您可以呼叫 ListAgentRuntimeVersions操作，列出 AgentCore 執行期的所有版本。若要列出 AgentCore 執行期的端點，請呼叫 ListAgentRuntimeEndpoints。