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

# 连接器版本
<a name="gateway-target-connector-versions"></a>

Built-in 亚马逊 Bedrock AgentCore Gateway 上的连接器使用语义版本控制 ()。`MAJOR.MINOR.PATCH`您可以将目标固定到特定的连接器版本，也可以让它使用连接器的当前默认版本。

## 版本控制行为
<a name="gateway-target-connector-versions-behavior"></a>

下表描述了创建或更新目标时网关如何解析连接器版本。


| 场景 | 行为 | 
| --- | --- | 
| 使用 `source.version` 创建  | 目标已固定到该版本。 | 
| 在没有的情况下创建 `source.version`  | Target 获取连接器的当前默认版本。 | 
| 更新为 `source.version`  | 目标移至指定版本。 | 
| 不用更新 `source.version`  | Target 保留其当前版本（粘性）。 | 
|  `GetGatewayTarget`  | 回复包括已解决的问题`source.version`。 | 

## 网络搜索工具（`网络搜索`）
<a name="gateway-target-connector-versions-web-search"></a>

 **默认版本：**`1.1.0`


| 版本 | Released | 更改 | 
| --- | --- | --- | 
|  `1.2.0`  | 2026-07-20 | Agent-side 请求级过滤器：域名包含和排除列表（每个列表最多 100 个域）和发布日期范围筛选（UTC）。ISO-8601  | 
|  `1.1.0`  | 2026-06-15 | 添加`structuredContent`了工具结果；添加了`publishedDate`字段；改进了代码片段提取。 | 

## 亚马逊基岩管理知识库（基础知识库）``
<a name="gateway-target-connector-versions-managed-kb"></a>

 **默认版本：**`1.0.0`


| 版本 | Released | 更改 | 
| --- | --- | --- | 
|  `1.0.0`  | 2026-04-01 | 初始版本`Retrieve`和`AgenticRetrieveStream`操作。 | 

## 示例：固定版本
<a name="gateway-target-connector-versions-pin-example"></a>

要将目标固定到特定的连接器版本，请在目标配置`source.version`中包括：

```
{
  "targetConfiguration": {
    "mcp": {
      "connector": {
        "source": {
          "connectorId": "web-search",
          "version": "1.1.0"
        }
      }
    }
  }
}
```

如果您指定的版本不存在，则 API 会返回列`ValidationException`出可用版本的。

## 版本生命周期
<a name="gateway-target-connector-versions-lifecycle"></a>

每个连接器版本都要经历以下阶段：


| 阶段 | 说明 | 
| --- | --- | 
| Available | 您可以为新的或更新的目标选择此版本。 | 
| 默认 | 省略`source.version`时分配。 | 
| 已弃用 | 适用于现有目标，但不建议用于新目标。 | 
| 已停用 | 不再适用于新目标。现有目标必须升级。 | 

## 向后兼容性
<a name="gateway-target-connector-versions-backward-compatibility"></a>

次要版本和补丁版本向后兼容。工具输入架构和管理员配置上的新字段是累加的。

当连接器的默认版本更改时，现有目标会保留其固定版本。要采用新的次要版本，请使用新版本更新目标`source.version`。

 `tools/list`可能会在新的次要版本上暴露其他属性。严格解析架构的客户端应容忍未知的属性。

Admin-side 配置密钥是根据目标的连接器版本进行验证的。传递固定版本无法识别的密钥`ValidationException`将在目标创建或更新时返回 a。

重大版本升级表示重大更改，并包括迁移指南。