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

# AgentCore 运行时版本控制和端点
<a name="agent-runtime-versioning"></a>

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

亚马逊 Bedrock 中的每个 AgentCore 运行时 AgentCore 都会自动进行版本控制：
+ 创建运行时时， AgentCore AgentCore 运行时会自动创建版本 1 (V1)
+  AgentCore 运行时的每次更新都会创建一个具有完整、独立配置的新版本
+ 版本一经创建即不可变
+ 每个版本都包含执行所需的所有配置

## 端点如何引用版本
<a name="endpoint-versioning"></a>

终端节点提供了一种引用 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)
```

## 版本控制场景
<a name="versioning-scenarios"></a>

下表说明了版本控制和终端节点在 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 上 | 

## 端点生命周期状态
<a name="endpoint-lifecycle"></a>

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

CREATING  
创建端点时的初始状态

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

就绪  
端点已准备好接受请求

UPDATING  
端点正在更新到新版本

UPDATE\_FAILED  
表示更新操作失败

## 列出 AgentCore 运行时版本和端点
<a name="listing-versions"></a>

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