View a markdown version of this page

コネクタのバージョン - Amazon Bedrock AgentCore
バージョニングの動作ウェブ検索ツール (web-search)Amazon Bedrock マネージドナレッジベース (bedrock-knowledge-bases)例: バージョンを固定するバージョンライフサイクル下位互換性

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

コネクタのバージョン

Amazon Bedrock AgentCore Gateway の組み込みコネクタは、セマンティックバージョニング () を使用しますMAJOR.MINOR.PATCH。ターゲットを特定のコネクタバージョンに固定することも、コネクタの現在のデフォルトバージョンを使用させることもできます。

バージョニングの動作

次の表は、ターゲットを作成または更新するときに Gateway がコネクタバージョンを解決する方法を示しています。

シナリオ 動作

source.version を使用した作成

ターゲットはそのバージョンに固定されます。

なしで作成する source.version

ターゲットはコネクタの現在のデフォルトバージョンを取得します。

で更新する source.version

ターゲットは指定されたバージョンに移動します。

なしで更新する source.version

ターゲットは現在のバージョン (スティッキー) を維持します。

GetGatewayTarget

レスポンスには、解決された が含まれますsource.version。

デフォルトバージョン: 1.1.0

バージョン 解放済み 変更

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

バージョン 解放済み 変更

1.0.0

2026-04-01

初回リリース — Retrieveおよび AgenticRetrieveStreamオペレーション。

例: バージョンを固定する

ターゲットを特定のコネクタバージョンに固定するには、ターゲット設定source.versionに を含めます。

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

存在しないバージョンを指定すると、API は使用可能なバージョンValidationExceptionを一覧表示する を返します。

バージョンライフサイクル

各コネクタバージョンは、次のステージを通過します。

ステージ 説明

使用可能

このバージョンは、新規または更新されたターゲットに対して選択できます。

デフォルト

を省略すると割り当てられますsource.version。

非推奨

既存のターゲットで動作しますが、新しいターゲットにはお勧めしません。

使用停止

新しいターゲットで利用できなくなりました。既存のターゲットはアップグレードする必要があります。

下位互換性

マイナーバージョンとパッチバージョンは下位互換性があります。ツール入力スキーマと管理者設定の新しいフィールドは付加的です。

コネクタのデフォルトバージョンが変更されても、既存のターゲットは固定されたバージョンを保持します。新しいマイナーバージョンを採用するには、ターゲットを新しい で更新しますsource.version。

tools/list は、新しいマイナーバージョンで追加のプロパティを公開することがあります。スキーマを解析するクライアントは、不明なプロパティを厳密に許容する必要があります。

管理者側の設定キーは、ターゲットのコネクタバージョンに対して検証されます。固定バージョンが認識しないキーを渡すと、ターゲットの作成時または更新ValidationException時に が返されます。

メジャーバージョンのバンプは重大な変更を示し、移行ガイドが含まれています。