REST API 버전(Azure AI Search)
이 문서에서는 Azure AI Search용 Search REST API의 현재 및 이전 버전을 나열합니다.
버전이 지정된 API 문서
이제 REST API 문서의 버전이 지정됩니다. API 참조 페이지를 열면 버전 선택기가 목차 위에 나타납니다. API 참조가 참조>데이터 평면 폴더에 있는지 확인합니다.
안정적인 버전
| API 버전 | 사양 | API 업데이트 |
|---|---|---|
2024-07-01(최신) |
Swagger 사양 | 릴리스 정보 |
2023-11-01 |
Swagger 사양 | 릴리스 정보 |
2020-06-30 |
Swagger 사양 | 릴리스 정보 |
2019-05-06 |
Swagger 사양 | 복합 형식을 추가합니다. |
미리 보기 버전
미리 보기 버전은 새 기능을 테스트하고, 피드백을 수집하고, 문제를 검색하고 해결하기 위해 릴리스됩니다. 미리 보기 API는 Microsoft Azure Previews대한
| API 버전 | 사양 | API 업데이트 |
|---|---|---|
2024-11-01-preview(최신) |
Swagger 사양 | 릴리스 정보 |
2024-09-01-preview |
Swagger 사양 | 릴리스 정보 |
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 사양 | 릴리스 정보 |
릴리스 정보
2024-11-01-preview
이 미리 보기는 2024-09-01-preview2024-11-01-preview 업그레이드할 수 있습니다. 자세한 내용은 REST API업그레이드를 참조하세요.
| 업데이트 | 적용 가능한 REST API |
|---|---|
| 쿼리는 L2 순위로 전송된 쿼리를 구체화하는 데 사용되는 의미 체계 재랜커다시 작성합니다. | 문서 검색요청의 새 QueryRewritesType 속성입니다. |
| 문서 레이아웃 기술 구조에 대한 문서를 분석하는 데 사용됩니다. | 새 DocumentIntelligenceLayoutSkill 기술만들거나 업데이트합니다. |
| Azure AI 다중 서비스 리소스연결하는 |
새 AIServicesAccountIdentity 속성인 기술 세트만들거나 업데이트합니다. |
| Markdown 구문 분석 모드. Azure Storage에서 Markdown 파일을 인덱싱하는 데 사용됩니다. | 인덱서만들거나 업데이트할 |
| 압축된 벡터대한 |
인덱스만들거나 업데이트할 enableRescoring 속성은 2024-03-01-preview에서 도입된 rerankWithOriginalVectors 매핑됩니다. |
2024-09-01-preview
이 미리 보기는 2024-05-01-preview2024-09-01-preview 업그레이드할 수 있습니다. 자세한 내용은 REST API업그레이드를 참조하세요.
| 업데이트 | 적용 가능한 REST API |
|---|---|
| MRL(Matryoshka Representation Learning) 양자화에서 재학습된 text-embedding-3-small 및 text-embedding-3-large 모델에 대해 잘린 차원. | 인덱스 만들기 또는 업데이트, 새 truncationDimension 매개 변수 |
| RRF(상호 순위 Fusion)점수가 매겨진 하이브리드 검색 결과의 압축을 풀기 위한 하위 점수 또는 점수 매기기 세부 정보입니다. | 문서 검색새 매개 변수를 디버그하고 응답에서 하위 점수 정의를 쿼리합니다. |
| 하이브리드 검색 쿼리벡터 부분에 대한 대상 필터링입니다. | 문서 검색, RawVectorQuery새 filterOverride 매개 변수, VectorizableTextQuery, VectorizableImageUrlQuery, VectorizableImageBinaryQuery. |
| 텍스트 분할 기술의 토큰 청크는 문자가 아닌. | 기술 세트, 새 단위 매개 변수 및 기타 토큰 관련 속성을 만들거나 업데이트합니다. |
2024-07-01
이 버전은 통합 벡터화(기술 및 벡터라이저), 스칼라 양자화 및 이진 양자화에 대해 일반적으로 사용 가능한 업데이트를 제공합니다. 자세한 내용은 Azure AI Search 새로운 기능
| 업데이트 | 적용 가능한 REST API |
|---|---|
| 일반 공급 - 벡터 데이터 형식 | 인덱스 만들기 또는 업데이트 |
| 일반 공급 - 벡터 양자화 속성은 검색 인덱스에서 기본 제공 스칼라 또는 이진 양자화에. | 인덱스 만들기 또는 업데이트 |
| 일반 공급 - 필드의 추가 복사본이 저장되는지 여부를 결정하는 |
인덱스 만들기 또는 업데이트 |
| 일반 공급 - VectorizableTextQuery는 관련성 튜닝을 위한 매개 변수를. 하이브리드 쿼리 매개 변수(MaxTextSizeRecall)는 아직 미리 보기로 제공됩니다. | 문서 검색 |
| 일반 공급 - 인덱싱 중에 통합 벡터화를 위해 text-embedding-ada-002보다 더 많은 모델을 지원하는 AzureOpenAIEmbedding 기술입니다. 모델 이름 및 차원 속성을 설정하여 특정 모델을 대상으로 지정합니다. | 기술 세트 만들기 또는 업데이트 |
| 일반 공급 - 쿼리 중에 통합 벡터화를 위한 Azure OpenAI 포함 벡터라이저입니다. 벡터라이저 속성은 더 많은 모델을 지원합니다. | 인덱스 만들기 또는 업데이트 |
| 2024년 3월 29일부터 GET 응답은 더 이상 연결 문자열 또는 키를 반환하지 않습니다. 자세한 내용은 연결 정보 읽는 클라이언트 코드의 |
모든 버전 |
2024-05-01-preview
이 미리 보기는 인덱싱 및 쿼리 중에 더 많은 포함 모델과 OneLake 인덱싱, 관련성 튜닝 및 심층 통합에 대한 지원을 추가합니다.
2024-03-01-preview 또는 2023-10-01-preview업그레이드하려면 모델 이름과 차원을 포함하도록 AzureOpenAIEmbedding 기술 또는 벡터라이저를 업데이트합니다.
이 미리 보기의 업데이트는 다음과 같습니다. 또한 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"참조하도록 정의되어야 합니다.
-
vectorQueries2023-07-01-Preview에서vectors대체합니다. -
vectorQueries.vectors2023-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
이 버전은 벡터 지원을 도입하고 최신 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에서 일시 삭제를 위한 인덱서 데이터 원본
- 관련성 점수에 대한 자세한 정보를 반환하는 featuresMode 매개 변수
- AML(Azure Machine Learning) 인지 기술
- 개인 식별 검색 인식 기술
- 보강된 문서를 캐시하여 이미지 처리(및 기타 AI 보강) 유지 및 재사용
- 2024년 3월 29일부터 GET 응답은 더 이상 연결 문자열 또는 키를 반환하지 않습니다. 자세한 내용은 연결 정보 읽는 클라이언트 코드의
호환성이 손상되는 변경 내용을 참조하세요.