REST API 버전(Azure AI Search)

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

버전이 지정된 API 문서

이제 REST API 문서의 버전이 지정됩니다. API 참조 페이지를 열면 버전 선택기가 목차 위에 나타납니다. 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	2020년 10월 10일 이후에 지원되지 않음	첫 번째 일반 공급 릴리스입니다.

미리 보기 버전

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

API 버전	사양	API 업데이트
2024-05-01-preview(최신)	Swagger 사양	릴리스 정보
2024-03-01-preview	Swagger 사양	릴리스 정보
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(사용 중지)	2020년 10월 10일 이후에 지원되지 않음	안정적인 버전과 연결된 미리 보기 버전입니다.
2014-10-20-preview(사용 중지)	2020년 10월 10일 이후에 지원되지 않음	두 번째 공개 미리 보기.
2014-07-31-preview(사용 중지)	2020년 10월 10일 이후에 지원되지 않음	첫 번째 공개 미리 보기.

릴리스 정보

2024-05-01-preview

이 미리 보기는 인덱싱 및 쿼리 중에 더 많은 포함 모델과 OneLake 인덱싱, 관련성 튜닝 및 심층 통합에 대한 지원을 추가합니다. 2024-03-01-preview빌드되므로 해당 버전에 도입된 스칼라 정량화, 좁은 데이터 형식 및 스토리지 옵션도 있습니다.

2024-03-01-preview 또는 2023-10-01-preview업그레이드하려면 모델 이름과 차원을 포함하도록 AzureOpenAIEmbedding 기술 또는 벡터라이저를 업데이트합니다. 업그레이드(사용되지 않음) 또는 단계별 지침은업그레이드 REST API를 참조하세요.

이 미리 보기의 업데이트는 다음과 같습니다. 또한 Azure AI Search새로운 기능도 것이 좋습니다.

업데이트	적용 가능한 REST API
OneLake 파일 및 바로 가기에 대한 인덱서 데이터 원본입니다.	데이터 원본 만들기 또는 업데이트
Collection(Edm.Byte)지원 모델을 포함하기 위한 이진 데이터 형식입니다. 벡터 필드 정의는 이 데이터 형식을 지원합니다.	인덱스 만들기 또는 업데이트
관련성 튜닝을 위한 여러 벡터 및 하이브리드 쿼리 매개 변수입니다. 낮은 점수 매기기 결과를 제외하도록 임계값을 설정합니다. 가중치 벡터 쿼리. 하이브리드 쿼리의 경우 하이브리드 쿼리의 텍스트 부분에서 검색할 최대 문서를 설정합니다.	문서 검색
인덱싱 중에 다중 모드 통합 벡터화를 위한 새로운 Azure AI Vision 기술입니다. 이 기술은 Azure AI Vision의 다중 모드 API를 호출합니다.	기술 세트 만들기 또는 업데이트
다중 모드 쿼리를 위한 새로운 Azure AI Vision 벡터라이저입니다. 벡터라이저는 인덱스 정의에 지정되지만 쿼리 실행 중에 사용됩니다.	인덱스 만들기 또는 업데이트
인덱싱 중에 통합 벡터화를 위해 text-embedding-ada-002보다 더 많은 모델을 지원하도록 AzureOpenAIEmbedding 기술이 업데이트되었습니다. 모델 이름 및 차원 속성을 설정하여 특정 모델을 대상으로 지정합니다.	기술 세트 만들기 또는 업데이트
쿼리 중에 통합 벡터화를 위한 Azure OpenAI 포함 벡터라이저가 업데이트되었습니다. 벡터라이저 속성은 더 많은 모델을 지원합니다.	인덱스 만들기 또는 업데이트
2024년 3월 29일부터 GET 응답은 더 이상 연결 문자열 또는 키를 반환하지 않습니다. 자세한 내용은 연결 정보 읽는 클라이언트 코드의 호환성이 손상되는 변경 내용을 참조하세요.	모든 버전

2024-03-01-preview

이 미리 보기 버전은 벡터 스토리지를 개선하는 미리 보기 API를 추가하여 2023-10-01-preview 빌드됩니다. 자세한 내용은 Azure AI Search 새로운 기능

업데이트	적용 가능한 REST API
벡터 필드를 지원하는 모델을 포함하거나 더 작은 벡터를 출력하는 양자화 논리가 있는 경우 벡터 필드에 대한 새로운 좁은 데이터 형식입니다.	인덱스 만들기 또는 업데이트
새 벡터 양자화 속성은 검색 인덱스에서 기본 제공 벡터 압축을 위해.	인덱스 만들기 또는 업데이트
새 부울 저장된 속성은 필드의 추가 복사본이 저장되는지 여부를 결정하는 벡터 필드. 추가 복사본은 해당 필드의 검색 가능한 콘텐츠입니다. 저장하지 않으면 필드는 쿼리에서 계속 사용되지만 검색 결과에 반환될 수 없습니다. 검색 서비스의 공간을 절약하거나 검색 인덱스 내의 벡터 할당량을 절약하도록 이 속성을 설정할 수 있습니다.	인덱스 만들기 또는 업데이트
2024년 3월 29일부터 GET 응답은 더 이상 연결 문자열 또는 키를 반환하지 않습니다. 자세한 내용은 연결 정보 읽는 클라이언트 코드의 호환성이 손상되는 변경 내용을 참조하세요.	모든 버전

2023-11-01

이 버전은 일반적으로 사용 가능한 기능을 제공합니다. 자세한 내용은 Azure AI Search 새로운 기능

업데이트	적용 가능한 REST API
검색 게시물 요청의 의미 체계 순위입니다.	문서 검색
인덱싱 벡터 필드의 벡터 검색 구성	인덱스 만들기 또는 업데이트
Search Post 요청의 벡터 쿼리입니다.	문서 검색
2024년 3월 29일부터 GET 응답은 더 이상 연결 문자열 또는 키를 반환하지 않습니다. 자세한 내용은 연결 정보 읽는 클라이언트 코드의 호환성이 손상되는 변경 내용을 참조하세요.	모든 버전

2023-10-01-preview

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

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

인덱스만들거나 업데이트합니다.

• vectorSearchalgorithms, profiles및 vectorizers대한 정의가 있습니다.

  • algorithms 계속해서 hnsw 지원하며, HNSW(계층적 탐색 가능 Small World) 및 eKNN(철저한 K-가장 가까운 이웃)을 참조하여 eknn지원합니다. 알고리즘 섹션 내에서 HNSW 및 eKNN 매개 변수의 여러 명명된 조합을 정의할 수 있습니다. 이는 2023-07-01-Preview에서 vectorSearch 속성 내의 algorithmConfigurations 대체합니다.

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

  • vectorizers 인덱스에서 정의되지만 쿼리 시간에 텍스트 쿼리 문자열을 포함하는 데 사용됩니다. 벡터라이저는 포함 모델을 참조합니다. 검색 서비스는 포함 모델을 호출하여 텍스트 쿼리 문자열을 벡터화한 다음, 결과를 검색 엔진에 전달하여 벡터 쿼리를 만듭니다.

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

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

문서 검색:

• vectorQueries 2023-07-01-Preview에서 vectors 대체합니다.
• vectorQueries.vectors 2023-07-01-Preview에서 vectors.values 대체합니다.
• 이제 벡터 쿼리가 다형 구조입니다. 요청되는 벡터 쿼리의 형식을 나타내려면 kind 지정해야 합니다. "kind": "vector" 쿼리가 벡터임을 의미하므로 호출자는 검색 쿼리 문자열을 벡터 포함으로 이미 벡터화했어야 합니다.
• "exhaustive": "true" 벡터 인덱스 내의 모든 벡터에서 K-가장 가까운 인접 항목 검색을 수행할지 여부를 지정하는 새 속성입니다.
• vectorFilterMode 쿼리에서 사전 필터링(2023-10-01 이후 생성된 인덱스의 경우 기본값) 또는 사후 필터링(이전 인덱스의 기본값)을 지정하기 위한 새 매개 변수입니다.

2024년 3월 29일부터 GET 응답은 더 이상 연결 문자열 또는 키를 반환하지 않습니다. 자세한 내용은 연결 정보 읽는 클라이언트 코드의 호환성이 손상되는 변경 내용을 참조하세요.

2023-07-01-preview

중요하다

이 API 버전사용하지 마세요. 이 미리 보기 버전의 사용 중단은 2024년 4월 15일에 발표되었으며 2024년 7월 8일 이후에는 더 이상 지원되지 않습니다. 마이그레이션에 대한 도움말은 Azure AI Search업그레이드 REST API를 참조하세요.

이 버전은 벡터 지원을 도입하고 최신 API 버전과 호환되지 않는 벡터 구성을 사용합니다.

• 단정밀도 부동 소수점 숫자 배열이 포함된 필드에 Collection(Edm.Single) 데이터 형식이 추가되었습니다. 문서 필드당 생성된 포함을 저장하는 데 사용되는 벡터의 데이터 형식입니다. 검색 인덱스는 벡터 구성 속성도 지정합니다. 이러한 API에 대한 인덱스 만들기 또는 업데이트 참조하세요.
• 벡터 데이터를 허용하도록 인덱싱 워크로드가 업데이트되었습니다. 문서 추가, 업데이트 또는 삭제참조하세요.
• 벡터 검색에 대한 쿼리 매개 변수가 추가되었습니다. 이러한 매개 변수는 문서 검색을 참조하세요.
• 서비스 통계 가져오기: 서비스에 대한 벡터 인덱스 할당량 및 사용량을 반환합니다.
• 인덱스 통계 가져오기: 검색 인덱스에 대한 벡터 인덱스 할당량 및 사용량을 반환합니다.
• 2024년 3월 29일부터 GET 응답은 더 이상 연결 문자열 또는 키를 반환하지 않습니다. 자세한 내용은 연결 정보 읽는 클라이언트 코드의 호환성이 손상되는 변경 내용을 참조하세요.

2021-04-30-preview

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

• 인덱스 별칭 쿼리 및 인덱싱 요청에서 인덱스를 참조하는 데 사용되는 보조 이름을 추가합니다. 별칭 작업에는 만들기, 업데이트, 삭제, 가져오기 및 목록이 포함됩니다.
• 아웃바운드 연결관리 ID를 . 데이터 원본 만들기 또는 업데이트 연결 문자열에 대한 새 값은 하드 코딩된 데이터베이스 자격 증명 또는 키 대신 Microsoft Entra ID 인증 및 역할을 사용하여 연결을 지원합니다.
• 관리 ID 지원은 고객 관리형 암호화기본 암호화를 보완하는 검색 솔루션의 경우 키 자격 증명 모음 연결에도 지원됩니다.
• 텍스트 번역 인지 기술에 대한 추가 언어입니다.
• 문서 검색(미리 보기)의미 체계 검색 및 맞춤법 검사기를 위한 추가 queryLanguages입니다.
• 선택적으로 문서 검색(미리 보기)의미 체계 검색에서 캡션을 요청하는 캡션 매개 변수입니다.
• 의미 체계 구성인덱스 만들기 또는 업데이트지정됩니다. 의미 체계 구성은 의미 체계 순위, 캡션, 강조 표시 및 답변에 사용해야 하는 필드를 결정합니다.
• 문서 검색(미리 보기)의미 체계 쿼리에 필요한 semanticConfiguration 매개 변수입니다.
• 2024년 3월 29일부터 GET 응답은 더 이상 연결 문자열 또는 키를 반환하지 않습니다. 자세한 내용은 연결 정보 읽는 클라이언트 코드의 호환성이 손상되는 변경 내용을 참조하세요.

2020-06-30

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

• 데이터 평면 작업에 대한 Azure 역할 기반 액세스 제어
• 관련성 점수 매기기(BM25)
• 지식 저장소
• ADLS(Azure Data Lake Storage) Gen2에 대한 인덱서 데이터 원본
• 사용자 지정 엔터티 조회 기술
• Microsoft Entra ID를 통해 시스템 또는 사용자 관리 ID로 실행되는 인덱서
• 2024년 3월 29일부터 GET 응답은 더 이상 연결 문자열 또는 키를 반환하지 않습니다. 자세한 내용은 연결 정보 읽는 클라이언트 코드의 호환성이 손상되는 변경 내용을 참조하세요.

2020-06-30-preview

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

• 표준 계층 서비스에서 실행되고 의미 체계 순위를 호출하는 프리미엄 기능인 의미 체계 검색입니다.
• 파워 쿼리 커넥터에 대한 인덱서 데이터 원본
• MySQL에 대한 인덱서 데이터 원본
• Cosmos DB Gremlin API에 대한 인덱서 데이터 원본
• SharePoint Online의 인덱서 데이터 원본
• 대/소문자를 구분하지 않는 필터링, 패싯 및 정렬을 위한 텍스트 정규화의 Normalizer 속성
• ID별로 특정 문서를 구체적으로 새로 고치도록 인덱서 기반 인덱싱을 위한 문서 다시 설정
• 엔터티 연결 인식 기술(v3)
• 엔터티 인식 인식 기술(v3)
• 감정 분석 인지 기술(v3)
• 2024년 3월 29일부터 GET 응답은 더 이상 연결 문자열 또는 키를 반환하지 않습니다. 자세한 내용은 연결 정보 읽는 클라이언트 코드의 호환성이 손상되는 변경 내용을 참조하세요.

2019-05-06-preview

• Cosmos DB MongoDB API에 대한 인덱서 데이터 원본 지원
• Blob Storage에서 네이티브 Blob 일시 삭제에 대한 인덱서 데이터 원본
• 관련성 점수에 대한 자세한 정보를 반환하는 featuresMode 매개 변수
• AML(Azure Machine Learning) 인지 기술
• 개인 식별 검색 인식 기술
• 보강된 문서를 캐시하여 이미지 처리(및 기타 AI 보강) 유지 및 재사용
• 2024년 3월 29일부터 GET 응답은 더 이상 연결 문자열 또는 키를 반환하지 않습니다. 자세한 내용은 연결 정보 읽는 클라이언트 코드의 호환성이 손상되는 변경 내용을 참조하세요.

참고 항목

• 검색 서비스 만들기
• 빠른 시작: REST API를 사용하여 Azure AI Search 인덱스 만들기