View a markdown version of this page

AgentCore 运行时版本控制和端点 - 亚马逊基岩 AgentCore
端点如何引用版本版本控制场景端点生命周期状态列出 AgentCore 运行时版本和端点

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

AgentCore 运行时版本控制和端点

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

亚马逊 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

PROD 对 V3 的更新

修改网络设置

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

V4

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

端点生命周期状态

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

CREATING

创建端点时的初始状态

创建_失败

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

就绪

端点已准备好接受请求

UPDATING

端点正在更新到新版本

UPDATE_FAILED

表示更新操作失败

列出 AgentCore 运行时版本和端点

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