View a markdown version of this page

커넥터 버전 - Amazon Bedrock AgentCore
버전 관리 동작웹 검색 도구(web-search)Amazon Bedrock 관리형 지식 기반(bedrock-knowledge-bases)예: 버전 고정버전 수명 주기이전 버전과의 호환성

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

커넥터 버전

Amazon Bedrock AgentCore Gateway의 내장 커넥터는 의미 체계 버전 관리()를 사용합니다MAJOR.MINOR.PATCH. 대상을 특정 커넥터 버전에 고정하거나 커넥터의 현재 기본 버전을 사용하도록 할 수 있습니다.

버전 관리 동작

다음 표에서는 대상을 생성하거나 업데이트할 때 게이트웨이가 커넥터 버전을 확인하는 방법을 설명합니다.

시나리오 동작

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하는를 반환합니다.

버전 수명 주기

각 커넥터 버전은 다음 단계를 거칩니다.

단계 설명

Available

새 대상 또는 업데이트된 대상에 대해이 버전을 선택할 수 있습니다.

기본값

를 생략할 때 할당됩니다source.version.

Deprecated

기존 대상에는 적용되지만 새 대상에는 권장되지 않습니다.

Retired

새 대상에는 더 이상 사용할 수 없습니다. 기존 대상은 업그레이드해야 합니다.

이전 버전과의 호환성

마이너 버전과 패치 버전은 이전 버전과 호환됩니다. 도구 입력 스키마 및 관리자 구성의 새 필드는 추가됩니다.

커넥터의 기본 버전이 변경될 때 기존 대상은 고정된 버전을 유지합니다. 새 마이너 버전을 채택하려면 새 로 대상을 업데이트합니다source.version.

tools/list는 새 마이너 버전에 추가 속성을 노출할 수 있습니다. 스키마를 엄격하게 구문 분석하는 클라이언트는 알 수 없는 속성을 허용해야 합니다.

관리자 측 구성 키는 대상의 커넥터 버전에 대해 검증됩니다. 고정된 버전이 인식하지 못하는 키를 전달하면 대상 생성 또는 업데이트 ValidationException 시가 반환됩니다.

메이저 버전 범프는 주요 변경 사항을 나타내며 마이그레이션 가이드를 포함합니다.