View a markdown version of this page

连接器版本 - 亚马逊基岩 AgentCore
版本控制行为网络搜索工具（网络搜索）亚马逊基岩管理知识库（基础知识库）示例：固定版本版本生命周期向后兼容性

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

连接器版本

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

版本控制行为

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

场景 行为

使用 source.version 创建

目标已固定到该版本。

在没有的情况下创建 source.version

Target 获取连接器的当前默认版本。

更新为 source.version

目标移至指定版本。

不用更新 source.version

Target 保留其当前版本（粘性）。

GetGatewayTarget

回复包括已解决的问题source.version。

默认版本：1.1.0

版本 Released 更改

1.2.0

2026-07-20

Agent-side 请求级过滤器：域名包含和排除列表（每个列表最多 100 个域）和发布日期范围筛选（UTC）。ISO-8601

1.1.0

2026-06-15

添加structuredContent了工具结果；添加了publishedDate字段；改进了代码片段提取。

亚马逊基岩管理知识库（基础知识库）

默认版本：1.0.0

版本 Released 更改

1.0.0

2026-04-01

初始版本Retrieve和AgenticRetrieveStream操作。

示例：固定版本

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

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

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

版本生命周期

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

阶段 说明

Available

您可以为新的或更新的目标选择此版本。

默认

省略source.version时分配。

已弃用

适用于现有目标，但不建议用于新目标。

已停用

不再适用于新目标。现有目标必须升级。

向后兼容性

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

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

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

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

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