REST API sürümleri (Azure AI Arama)

Makale
04/24/2024

Bu makalede Azure AI Arama için Arama REST API'lerinin geçerli ve geçmiş sürümleri listelenmektedir.

Sürüme alınan API belgeleri

REST API belgeleri artık sürümlenmiştir. BIR API başvuru sayfasını açtığınızda, içindekiler tablosunun üzerinde bir sürüm seçici görüntülenir.

Başvuru > Veri Düzlemi'ne genişletin.
Bir API başvuru sayfası seçin.
Sol üstteki açılan filtreden bir API sürümü seçin.

Kararlı sürümler

API sürümü	Belirtim	API güncelleştirmeleri
`2023-11-01` (En son)	Swagger belirtimi	Sürüm notu
`2020-06-30`	Swagger belirtimi	Sürüm notu
`2019-05-06`	Swagger belirtimi	Karmaşık türler ekler.
`2017-11-11`	Swagger belirtimi	Beceri kümeleri ve yapay zeka zenginleştirmesi ekler.
`2016-09-01`	Swagger belirtimi	Dizin oluşturucular ekler.
`2015-02-28`	10-10-2020'nin ardından desteklenmiyor	genel kullanıma sunulan ilk sürüm.

Önizleme sürümleri

Yeni işlevleri test etmek, geri bildirim toplamak ve sorunları keşfedip düzeltmek için önizleme sürümleri yayınlanıyor. Önizleme API'leri , Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları altında sağlanır.

API sürümü	Belirtim	API güncelleştirmeleri
`2024-03-01-Preview` (En son)	Swagger belirtimi	Sürüm notu
`2023-10-01-Preview`	Swagger belirtimi	Sürüm notu
`2023-07-01-Preview` (kullanım dışı)	Swagger belirtimi	Sürüm notu
`2021-04-30-Preview`	Swagger belirtimi	Sürüm notu
`2020-06-30-Preview`	Swagger belirtimi	Sürüm notu
`2019-05-06-Preview`	Swagger belirtimi	Sürüm notu
`2017-11-11-Preview`	Swagger belirtimi	Kararlı sürümle ilişkili önizleme sürümü.
`2016-09-01-Preview`	Swagger belirtimi	Kararlı sürümle ilişkili önizleme sürümü.
`2015-02-28-Preview` (kullanımdan kaldırıldı)	10-10-2020'nin ardından desteklenmiyor	Kararlı sürümle ilişkili önizleme sürümü.
`2014-10-20-Preview` (kullanımdan kaldırıldı)	10-10-2020'nin ardından desteklenmiyor	İkinci genel önizleme.
`2014-07-31-Preview` (kullanımdan kaldırıldı)	10-10-2020'nin ardından desteklenmiyor	İlk genel önizleme.

Sürüm notları

2024-03-01-Preview

Bu önizleme sürümü, alandan tasarruf etmenizi sağlayan aşağıdaki önizleme API'lerini ekleyerek derleniyor 2023-10-01-preview :

Vektör alanlarını destekleyen modelleri veya daha küçük vektörler veren niceleme mantığını eklediyseniz , vektör alanları için yeni dar veri türleri .
Arama dizininde yerleşik vektör sıkıştırması için yeni vektör niceleme özellikleri .
Alanın ek bir kopyasının depolanıp depolanmadığını belirleyen bir vektör alanında yeni boole saklı özelliği. Ek kopya, bu alanın alınabilir içeriğidir. Depolamazsanız, alan sorgularda kullanılmaya devam eder, ancak arama sonucunda döndürülemez. Bu özelliği, arama hizmetinizde veya bir arama dizinindeki vektör kotasında yer tasarrufu sağlamak için ayarlayabilirsiniz.

2023-11-01

Bu sürüm, aşağıdakiler de dahil olmak üzere genel kullanıma sunulan özellikler sağlar:

Arama Post isteklerinde anlam derecelendirmesi.
İçerik Oluşturucu veya Güncelleştirme Dizini isteklerinde vektör arama dizini oluşturma ve Arama Post isteklerinde vektör sorguları.

2023-10-01-Preview

Bu sürüm, önceki önizlemelerde sunulan tüm özelliklerin yanı sıra vektör arama API'lerinde yapılan eklemeleri ve değişiklikleri içerir. Vektör arama API'lerine Güncelleştirmeler, 2023-07-01-Preview sürümündeki hataya neden olan bir değişikliktir. Geçiş yardımı için bkz. Vektör alanları ekleme ve vektör sorgusu İçerik Oluşturucu.

Yeni ön filtreleme özelliğini kullanmayı planlıyorsanız, 2023-10-01 sonrasında oluşturulan bir dizin kullanmanız gerekir.

İçerik Oluşturucu veya Güncelleştirme Dizini:

vectorSearch, profilesve vectorizerstanımlarına algorithmssahiptir:
- algorithms desteği devam hnsw eder ve artık Hiyerarşik Gezinilebilir Küçük Dünya (HNSW) ve en yakın K komşular (eKNN) için de desteklemektedir eknn. Algoritma bölümünde HNSW ve eKNN parametrelerinin birden çok adlandırılmış bileşimini tanımlayabilirsiniz. Bu, 2023-07-01-Preview sürümünde özelliğinin içinde vectorSearch değiştiriliralgorithmConfigurations.
- profiles , algoritma yapılandırmasını belirten yeni bir tanımdır. Örneğin HNSW-1, HSNW-2, eKNN-1 adlı algoritma yapılandırmalarınız olduğunu varsayalım. Bir profil HNSW-1 belirtebilir.
- vectorizers dizinde tanımlanır ancak sorgu zamanında metin sorgu dizesi eklemek için kullanılır. Vektörleştirici ekleme modeline başvurur. Arama hizmeti, metin sorgu dizesini vektörleştirmek için ekleme modeline bir çağrı yapar ve ardından sonucu bir vektör sorgusu için arama altyapısına geçirir.
Vektör alanlarında öğesinin vectorSearchProfile yerini alır vectorSearchConfiguration. vectorSearchProfile özelliği, alanda hangi vektör arama profilinin kullanılacağını belirtir.
Bu API sürümünden önce oluşturulan dizinlerde, isteğinizde 2023-10-01-Preview API'sini çağırdığınızda, profil önceden içinde belirtilen vectorSearchConfigurationalgoritmanın aynısını belirttiği sürece alanını belirtecek vectorSearchProfile şekilde değiştirmeniz gerekir. Örneğin, mevcut alan tanımı öğesini belirtiyorsa "vectorSearchConfiguration": "myHnsw", bunu ile "vectorSearchProfile": "your profile name"değiştirmeniz ve profilin aynı "algorithm": "myHnsw"öğesine başvurmak için tanımlanması gerekir.

belgeleri Arama:

vectorQueriesvectors 2023-07-01-Preview sürümünde değiştirilir
vectorQueries.vectorsvectors.values 2023-07-01-Preview sürümünde değiştirilir.
Vektör sorgusu artık çok biçimli bir yapıdır. kind istenen vektör sorgusunun türünü belirtmek için belirtilmelidir.
- "kind": "vector" sorgunun bir vektör olduğu anlamına gelir, bu nedenle çağıranın arama sorgusu dizesini vektör eklemeye önceden vektörleştirmiş olması gerekir.
"exhaustive": "true" yeni bir özellik, vektör dizinindeki tüm vektörlerde en yakın k komşu aramasının kapsamlı (deneme yanılma) yapılıp yapılmayacağını belirtir.
vectorFilterMode sorguda ön filtreleme (2023-10-01'in ardından oluşturulan dizinler için varsayılan) veya son filtrelemeyi (önceki dizinlerde varsayılan) belirtmek için yeni bir parametredir.

2023-07-01-Önizleme

Önemli

Bu önizleme sürümünün kullanımdan kaldırılacağı 15 Nisan 2024 tarihinde duyuruldu ve 8 Temmuz 2024'te kullanımdan kaldırılacak. Geçişle ilgili yardım için bkz. Azure AI Arama'de REST API'lerini yükseltme.

Bu sürüm, önceki önizlemelere ait özelliklere ek olarak vektör arama desteğine sahiptir:

Arama dizininde, tek duyarlıklı kayan noktalı sayı dizisi içeren alanlara veri türü atayın Collection(Edm.Single) . Bu, belge alanı başına oluşturulan bir eklemeyi depolamak için kullanılan yeni vektör arama özelliğinin veri türüdür. Ayrıca arama dizininde vektör yapılandırma özelliklerini belirtin. Bu API'ler için bkz. İçerik Oluşturucu veya Güncelleştirme Dizini.
Dizin oluşturma iş yükleri vektör verilerini kabul etmek için güncelleştirilir. Bkz. Belge Ekleme, Güncelleştirme veya Silme.
Vektör araması için sorgu parametreleri. Bu parametreler için bkz. Arama Belgeler.
Hizmet İstatistiklerini Alma: Hizmet için vektör dizini kotası ve kullanımı döndürür.
Dizin İstatistiklerini Alma: Arama dizini için vektör dizini kotası ve kullanımı döndürür.

2021-04-30-Preview

Bu önizleme sürümü, 2020-06-30-Preview sürümünde sunulan tüm özelliklerin yanı sıra aşağıdaki API'lere eklemeler içerir:

Dizin diğer adı , sorgu ve dizin oluşturma isteklerinde dizinlere başvurmak için kullanılan ikincil bir ad ekler. Diğer ad işlemleri oluşturma, güncelleştirme, silme, alma ve listeleme işlemlerini içerir.
Giden bağlantılar için yönetilen kimlikler. İçerik Oluşturucu veya Güncelleştirme Veri Kaynağı'ndaki bağlantı dizeleri için yeni değerler, sabit kodlanmış veritabanı kimlik bilgileri veya anahtarları yerine Microsoft Entra ID kimlik doğrulaması ve rolleri kullanan bağlantıları destekler.
Yönetilen kimlik desteği, müşteri tarafından yönetilen şifreleme ile varsayılan şifrelemeyi tamamlayan arama çözümleri için anahtar kasası bağlantıları için de desteklenir.
Metin Çevirisi bilişsel becerisi için daha fazla dil.
Arama Belgeleri'nde semantik arama ve yazım denetleyicisi için diğer queryLanguages (önizleme).
İsteğe bağlı olarak Arama Belgeler'de semantik aramadan resim yazıları istemek için bir captions parametresi (önizleme).
Anlam yapılandırmaları İçerik Oluşturucu veya Güncelleştirme Dizini'nde belirtilir. Anlamsal yapılandırma, anlamsal derecelendirme, açıklamalı alt yazılar, vurgular ve yanıtlar için hangi alanların kullanılması gerektiğini belirler.
Arama Belgelerindeki semantik sorgular için gerekli olan semanticConfiguration parametresi (önizleme).

2020-06-30