REST API 버전(Azure AI Search)

이 문서에서는 Azure AI Search용 Search REST API의 현재 및 이전 버전을 나열합니다.

버전이 지정된 API 문서

이제 REST API 문서의 버전이 지정됩니다. API 참조 페이지를 열면 버전 선택기가 목차 위에 표시됩니다.

  1. 참조 > 데이터 평면을 확장합니다.

  2. API 참조 페이지를 선택합니다.

  3. 왼쪽 위에 있는 드롭다운 필터에서 API 버전을 선택합니다.

    버전 선택기의 스크린샷

안정적인 버전

API 버전 사양 API 업데이트
2023-11-01 (최신) Swagger 사양 릴리스 정보
2020-06-30 Swagger 사양 릴리스 정보
2019-05-06 Swagger 사양 복합 형식을 추가합니다.
2017-11-11 Swagger 사양 기술 세트 및 AI 보강을 추가합니다.
2016-09-01 Swagger 사양 인덱서를 추가합니다.
2015-02-28 10-10-2020 이후 지원되지 않음 첫 번째 일반 공급 릴리스.

미리 보기 버전

미리 보기 버전은 새 기능을 테스트하고, 피드백을 수집하고, 문제를 검색하고 해결하기 위해 릴리스됩니다. 미리 보기 API는 Microsoft Azure Preview에 대한 추가 사용 약관에 따라 사용할 수 있습니다.

API 버전 사양 API 업데이트
2023-10-01-Preview Swagger 사양 릴리스 정보
2023-07-01-Preview Swagger 사양 릴리스 정보
2021-04-30-Preview Swagger 사양 릴리스 정보
2020-06-30-Preview Swagger 사양 릴리스 정보
2019-05-06-Preview Swagger 사양 릴리스 정보
2017-11-11-Preview Swagger 사양 안정적인 버전과 연결된 미리 보기 버전입니다.
2016-09-01-Preview Swagger 사양 안정적인 버전과 연결된 미리 보기 버전입니다.
2015-02-28-Preview 10-10-2020 이후 지원되지 않음 안정적인 버전과 연결된 미리 보기 버전입니다.
2014-10-20-Preview 10-10-2020 이후 지원되지 않음 두 번째 공개 미리 보기입니다.
2014-07-31-Preview 10-10-2020 이후 지원되지 않음 첫 번째 공개 미리 보기입니다.

릴리스 정보

2023-11-01

이 버전은 다음을 포함하여 일반적으로 사용할 수 있는 기능을 제공합니다.

  • 검색 게시물 요청의 의미 체계 순위입니다.
  • 인덱스 요청 만들기 또는 업데이트의 벡터 검색 인덱싱 및 검색 게시물 요청의 벡터 쿼리

2023-10-01-Preview

이 버전에는 이전 미리 보기에 도입된 모든 기능과 벡터 검색 API에 대한 추가 및 수정 사항이 포함되어 있습니다. 벡터 검색 API에 대한 업데이트 2023-07-01-Preview의 호환성이 손상되는 변경입니다. 마이그레이션 도움말 은 벡터 필드 추가벡터 쿼리 만들기 를 참조하세요.

새 사전 필터링 기능을 사용하려는 경우 2023-10-01 이후에 만든 인덱스 를 사용해야 합니다.

인덱스 만들기 또는 업데이트:

  • vectorSearch에는 , profiles및 에 대한 algorithms정의가 있습니다vectorizers.

    • algorithms 은 HNSW(계층적 탐색 가능 Small World) 및 eKNN(완전 K-가장 가까운 인접)을 참조하여 를 계속 지원 hnsweknn합니다. 알고리즘 섹션 내에서 HNSW 및 eKNN 매개 변수의 여러 명명된 조합을 정의할 수 있습니다. 이는 2023-07-01-Preview의 속성 내에서 vectorSearch 대체됩니다algorithmConfigurations.

    • profiles 는 알고리즘 구성을 지정하는 새 정의입니다. 예를 들어 HNSW-1, HSNW-2, eKNN-1이라는 알고리즘 구성이 있다고 가정합니다. 프로필은 HNSW-1을 지정할 수 있습니다.

    • vectorizers 가 표시되지만 현재는 무시됩니다.

  • 벡터 필드에서 를 vectorSearchProfile 대체합니다 vectorSearchConfiguration. 속성은 vectorSearchProfile 필드에서 사용할 벡터 검색 프로필을 지정합니다.

  • 이 API 버전 이전에 만든 인덱스에서 2023-10-01-Preview API를 호출할 때 요청에서 프로필이 이전에 지정된 vectorSearchConfiguration것과 동일한 알고리즘을 vectorSearchProfile 지정하는 한 필드를 변경하여 를 지정해야 합니다. 예를 들어 기존 필드 정의가 를 지정 "vectorSearchConfiguration": "myHnsw"하는 경우 를 로 "vectorSearchProfile": "your profile name"바꿔야 하며, 동일한 "algorithm": "myHnsw"를 참조하려면 프로필을 정의해야 합니다.

문서 검색:

  • vectorQueriesvectors 2023-07-01-Preview에서 교체

  • vectorQueries.vectors 는 2023-07-01-Preview에서 를 대체합니다 vectors.values .

  • 이제 벡터 쿼리가 다형 구조입니다. kind 요청되는 벡터 쿼리의 형식을 나타내려면 를 지정해야 합니다.

    • "kind": "vector" 는 쿼리가 벡터이므로 호출자가 검색 쿼리 문자열을 벡터 포함으로 이미 벡터화했어야 했음을 의미합니다.
  • "exhaustive": "true" 는 벡터 인덱스 내의 모든 벡터에서 K-가장 가까운 인접 검색을 수행할지 여부를 지정하는 새 속성입니다.

  • vectorFilterMode 는 쿼리에서 사전 필터링(2023-10-01 이후 생성된 인덱스의 기본값) 또는 사후 필터링(이전 인덱스의 기본값)을 지정하기 위한 새 매개 변수입니다.

2023-07-01-Preview

이 버전에는 이전 미리 보기에 도입된 모든 기능과 벡터 검색 지원이 포함됩니다.

  • 검색 인덱스에서 단정밀도 부동 소수점 숫자 배열이 포함된 필드에 데이터 형식을 할당 Collection(Edm.Single) 합니다. 이는 문서 필드당 하나의 생성된 포함을 저장하는 데 사용되는 새 벡터 검색 기능의 데이터 형식입니다. 또한 검색 인덱스에서 벡터 구성 속성을 지정합니다. 이러한 API에 대한 인덱스 만들기 또는 업데이트를 참조하세요.

  • 인덱싱 워크로드는 벡터 데이터를 허용하도록 업데이트됩니다. 문서 추가, 업데이트 또는 삭제를 참조하세요.

  • 벡터 검색에 대한 쿼리 매개 변수입니다. 이러한 매개 변수는 문서 검색 을 참조하세요.

  • 서비스 통계 가져오기: 서비스에 대한 벡터 인덱스 할당량 및 사용량을 반환합니다.

  • 인덱스 통계 가져오기: 검색 인덱스에 대한 벡터 인덱스 할당량 및 사용량을 반환합니다.

2021-04-30-미리 보기

이 미리 보기 버전에는 2020-06-30-Preview에 도입된 모든 기능과 다음 API가 추가되었습니다.

2020-06-30

이 버전은 다음을 포함하여 일반적으로 사용할 수 있는 기능을 제공합니다.

  • 데이터 평면 작업에 대한 Azure 역할 기반 액세스 제어
  • 관련성 점수 매기기(BM25)
  • 지식 저장소
  • ADLS(Azure Data Lake Storage) Gen2에 대한 인덱서 데이터 원본
  • 사용자 지정 엔터티 조회 기술
  • Microsoft Entra ID 통해 시스템 또는 사용자 관리 ID에서 실행되는 인덱서

2020-06-30-Preview

이 미리 보기 버전에는 2019-05-06-Preview에 도입된 모든 기능과 다음 추가 기능이 포함되어 있습니다.

  • 의미 체계 검색은 표준 계층 서비스에서 실행되고 의미 체계 순위를 호출하는 프리미엄 기능입니다.
  • Power Query 커넥터에 대한 인덱서 데이터 원본
  • MySQL에 대한 인덱서 데이터 원본
  • Cosmos DB Gremlin API에 대한 인덱서 데이터 원본
  • SharePoint Online의 인덱서 데이터 원본
  • 대/소문자를 구분하지 않는 필터링, 패싯 및 정렬을 위한 텍스트 정규화의 Normalizer 속성
  • ID별로 특정 문서를 구체적으로 새로 고치도록 인덱서 기반 인덱싱을 위한 문서 다시 설정
  • 엔터티 연결 인식 기술(v3)
  • 엔터티 인식 기술(v3)
  • 감정 분석 인지 기술(v3)

2019-05-06-Preview

  • Cosmos DB MongoDB API에 대한 인덱서 데이터 원본 지원
  • Blob Storage에서 네이티브 Blob 일시 삭제에 대한 인덱서 데이터 원본
  • featuresMode 관련성 점수에 대한 자세한 정보를 반환하는 매개 변수
  • AML(Azure Machine Learning) 인지 기술
  • 개인 식별 감지 인지 기술
  • 이미지 처리(및 기타 AI 보강)를 보존하고 재사용하기 위해 보강된 문서 캐시

추가 정보