View a markdown version of this page

AgentCore 运行时版本控制和端点 - Amazon Bedrock AgentCore
端点如何引用版本版本控制方案端点生命周期状态列出 AgentCore 运行时版本和端点

AgentCore 运行时版本控制和端点

Amazon Bedrock AgentCore 实现了 AgentCore 运行时的自动版本控制，并允许您使用终端节点管理不同的配置。

Amazon Bedrock 中的每个 AgentCore Runtim AgentCore e 都会自动进行版本控制：

  • 创建运行时时， 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

默认自动更新到 V2

使用 V2 创建 “PROD” 端点

未创建新版本

V2

PROD 端点指向 V2

容器镜像更新

使用新的容器引用创建新版本

V3

V3 的默认更新，PROD 仍在 V2 上

将 “PROD” 更新到 V3

未创建新版本

V3

PROD 对 V3 的更新

修改网络设置

使用更新的安全参数创建新版本

V4

V4 的默认更新，PROD 仍在 V3 上

端点生命周期状态

AgentCore 运行时端点在其生命周期中会经历各种状态：

CREATING

创建端点时的初始状态

创建失败

表示由于权限、容器或其他问题而导致创建失败

就绪

终端节点已准备好接受请求

UPDATING

终端节点正在更新到新版本

UPDATE_FAILED

表示更新操作失败

列出 AgentCore 运行时版本和端点

您可以通过调用ListAgentRuntimeVersions操作列出 AgentCore 运行时的所有版本。要列出 AgentCore 运行时的端点，请调用ListAgentRuntimeEndpoints。