View a markdown version of this page

連接器版本 - Amazon Bedrock AgentCore
版本控制行為Web 搜尋工具 (web-search)Amazon Bedrock 受管知識庫 (bedrock-knowledge-bases)範例：鎖定版本版本生命週期回溯相容性

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

連接器版本

Amazon Bedrock AgentCore Gateway 上的內建連接器使用語意版本控制 (MAJOR.MINOR.PATCH)。您可以鎖定目標至特定連接器版本，或讓其使用連接器目前的預設版本。

版本控制行為

下表說明當您建立或更新目標時，Gateway 如何解析連接器版本。

案例 Behavior (行為)

使用 source.version 建立

目標會固定到該版本。

建立不含 的 source.version

目標會取得連接器目前的預設版本。

使用 更新 source.version

目標會移至指定的版本。

無 的更新 source.version

Target 保留其目前版本 （黏性）。

GetGatewayTarget

回應包含已解析的 source.version。

預設版本： 1.1.0

版本 Released 變更

1.2.0

2026-07-20

代理程式端請求層級篩選條件：網域包含和排除清單 （每個清單最多 100 個網域） 和發佈日期範圍篩選 (ISO-8601 UTC)。

1.1.0

2026-06-15

在工具結果structuredContent中新增；新增publishedDate欄位；改善程式碼片段擷取。

Amazon Bedrock 受管知識庫 (bedrock-knowledge-bases)

預設版本： 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 可能會在新的次要版本上公開其他屬性。剖析結構描述的用戶端應嚴格容忍未知屬性。

管理員端組態金鑰會根據目標的連接器版本進行驗證。傳遞鎖定版本無法辨識的金鑰會在目標建立或更新ValidationException時傳回 。

主要版本凸點表示重大變更，並包含遷移指南。