REST API sürümleri (Azure AI Search)
Bu makalede, Azure AI Search için Search 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. API başvurusunun Başvurusu>Veri Düzlemi klasöründen olduğundan emin olun.
Kararlı sürümler
| API sürümü | Şartname | API güncelleştirmeleri |
|---|---|---|
2024-07-01 (En Son) |
Swagger belirtimi | Sürüm notu |
2023-11-01 |
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. |
Önizleme sürümleri
Önizleme sürümleri yeni işlevleri test etmek, geri bildirim toplamak ve sorunları keşfetmek ve düzeltmek için yayınlanıyor. Önizleme API'leri,Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları altında
| API sürümü | Şartname | API güncelleştirmeleri |
|---|---|---|
2024-05-01-preview (En Son) |
Swagger belirtimi | Sürüm notu |
2024-03-01-preview |
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 |
Sürüm notları
2024-07-01
Bu sürüm, tümleşik vektörleştirme (beceri ve vektörleştiriciler), skaler niceleme ve ikili niceleme için genel olarak kullanılabilir güncelleştirmeler sağlar. Ayrıntılar için bkz. Azure AI Search'daki yenilikler
| Güncelleştirmek | Geçerli REST API |
|---|---|
| Genel kullanıma sunuldu - vektör veri türleri | dizin oluşturma veya güncelleştirme |
| Genel olarak kullanılabilir - vektör niceleme özellikleri, bir arama dizinindeki yerleşik skaler veya ikili niceleme için. | dizin oluşturma veya güncelleştirme |
| Genel olarak kullanılabilir - depolanmış özellik, alanın ek bir kopyasının depolanıp depolanmadığını belirleyen vektör alanı. 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 yapmak için ayarlayabilirsiniz. | dizin oluşturma veya güncelleştirme |
| Genel kullanıma sunuldu - İlgi ayarı için VectorizableTextQuery parametreleri |
belge arama |
| Genel kullanıma sunuldu - Dizin oluşturma sırasında tümleşik vektörleştirme için yalnızca text-embedding-ada-002'den daha fazla modeli destekleyen AzureOpenAIEmbedding becerisi. Belirli bir modeli hedeflemek için model adı ve boyut özelliklerini ayarlayın. | Beceri Kümesi oluşturma veya güncelleştirme |
| Genel kullanıma sunuldu - Sorgular sırasında tümleşik vektörleştirme için Azure OpenAI ekleme vektörleştiricisi. Vektörleştirici özellikleri daha fazla modeli destekler. | dizin oluşturma veya güncelleştirme |
| 29 Mart 2024 tarihinden itibaren geçerli olacak: GET yanıtları artık bağlantı dizelerini veya anahtarları döndüremez. Ayrıntılar için bkz. Bağlantı bilgilerini okuyan istemci kodu için hataya neden olan değişiklik. | Tüm sürümler |
2024-05-01-önizleme
Bu önizleme, dizin oluşturma ve sorgular sırasında daha fazla ekleme modeliyle OneLake dizin oluşturma, ilgi ayarı ve daha derin tümleştirme desteği ekler.
2024-03-01-previewüzerinde derlenir, dolayısıyla bu sürümde sunulan skaler niceleme, dar veri türleri ve depolama seçeneklerine de sahiptir.
2024-03-01-preview veya 2023-10-01-preview'den yükseltmek için AzureOpenAIEmbedding becerisini veya vektörleştiricisini model adını ve boyutlarını içerecek şekilde güncelleştirin.
Bu önizlemedeki güncelleştirmeler aşağıdadır. Ayrıca Azure AI Search'daki yenilikler
| Güncelleştirmek | Geçerli REST API |
|---|---|
| OneLake dosyaları ve kısayolları için dizin oluşturucu veri kaynağı. | veri kaynağı oluşturma veya güncelleştirme |
Collection(Edm.Byte), bunları destekleyen modelleri eklemek için bir ikili veri türü. Vektör alanı tanımları bu veri türünü destekler. |
dizin oluşturma veya güncelleştirme |
| İlgi ayarı için birden çok vektör ve karma sorgu parametresi. Düşük puanlama sonuçlarını dışlamak için eşikleri ayarlayın. Ağırlık vektör sorguları. Karma sorgular için, karma sorgunun metin bölümünde alınacak en fazla belge sayısını ayarlayın. | belge arama |
| Dizin oluşturma sırasında çok modüllü tümleşik vektörleştirme için yeni Azure AI Vision becerisi. Bu beceri, Azure AI Vision'ın çok modüllü API'sini çağırır. | Beceri Kümesi oluşturma veya güncelleştirme |
| Çok modüllü sorgular için yeni Azure AI Vision vektörleştiricisi. Dizin tanımlarında vektörleştirici belirtilir, ancak sorgu yürütme sırasında kullanılır. | dizin oluşturma veya güncelleştirme |
| AzureOpenAIEmbedding becerisi, dizin oluşturma sırasında tümleşik vektörleştirme için text-embedding-ada-002'den daha fazla modeli destekleyecek şekilde güncelleştirildi. Belirli bir modeli hedeflemek için model adı ve boyut özelliklerini ayarlayın. | Beceri Kümesi oluşturma veya güncelleştirme |
| Sorgular sırasında tümleşik vektörleştirme için Azure OpenAI ekleme vektörleştiricisi güncelleştirildi. Vektörleştirici özellikleri daha fazla modeli destekler. | dizin oluşturma veya güncelleştirme |
| 29 Mart 2024 tarihinden itibaren geçerli olacak: GET yanıtları artık bağlantı dizelerini veya anahtarları döndüremez. Ayrıntılar için bkz. Bağlantı bilgilerini okuyan istemci kodu için hataya neden olan değişiklik. | Tüm sürümler |
2024-03-01-önizleme
Bu önizleme sürümü, vektör depolamayı geliştiren önizleme API'leri ekleyerek 2023-10-01-preview üzerinde derleniyor. Ayrıntılar için bkz. Azure AI Search'daki yenilikler
| Güncelleştirmek | Geçerli REST API |
|---|---|
| Vektör alanları için yeni dar veri türleri bunları destekleyen modeller ekleyip eklemediğiniz veya daha küçük vektörler veren niceleme mantığınız varsa. | dizin oluşturma veya güncelleştirme |
| Yeni vektör niceleme özellikleri, arama dizininde yerleşik vektör sıkıştırma için. | dizin oluşturma veya güncelleştirme |
| Alanın ek bir kopyasının depolanıp depolanmadığını belirleyen vektör alanı yeni boole depolanan ö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 yapmak için ayarlayabilirsiniz. | dizin oluşturma veya güncelleştirme |
| 29 Mart 2024 tarihinden itibaren geçerli olacak: GET yanıtları artık bağlantı dizelerini veya anahtarları döndüremez. Ayrıntılar için bkz. Bağlantı bilgilerini okuyan istemci kodu için hataya neden olan değişiklik. | Tüm sürümler |
2023-11-01
Bu sürüm genel kullanıma sunulan özellikler sağlar. Ayrıntılar için bkz. Azure AI Search'daki yenilikler
| Güncelleştirmek | Geçerli REST API |
|---|---|
| Arama Gönderisi isteklerinde anlamsal derecelendirme. | belge arama |
| Vektör alanlarını dizine alma için vektör arama yapılandırması | dizin oluşturma veya güncelleştirme |
| Arama Gönderisi isteklerindeki vektör sorguları. | belge arama |
| 29 Mart 2024 tarihinden itibaren geçerli olacak: GET yanıtları artık bağlantı dizelerini veya anahtarları döndüremez. Ayrıntılar için bkz. Bağlantı bilgilerini okuyan istemci kodu için hataya neden olan değişiklik. | Tüm sürümler |
2023-10-01-önizleme
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 yapılan 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 oluşturma.
Yeni ön filtreleme özelliğini kullanmayı planlıyorsanız, 2023-10-01 sonrasında oluşturulmuş bir dizin kullanmanız gerekir.
dizin oluşturma veya güncelleştirme
vectorSearchalgorithms,profilesvevectorizersiçin tanımları vardır:algorithmshnswdesteklemeye devam ediyor ve artık Hiyerarşik Gezinilebilir Küçük Dünya (HNSW) ve en yakın K komşular (eKNN) içineknnde destekleniyor. 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ündekivectorSearchözelliğindekialgorithmConfigurationsdeğiştirir.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.vectorizersbir 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 sorgusu dizesini vektörleştirmek için ekleme modeline bir çağrı yapar ve ardından bir vektör sorgusu için sonucu arama altyapısına geçirir.
Vektör alanlarında,
vectorSearchProfilevectorSearchConfigurationdeğiştirir.vectorSearchProfileözelliği, alanda hangi vektör arama profilinin kullanılacağını belirtir.Bu API sürümünden önce oluşturulan dizinlerde, 2023-10-01-Preview API'sini çağırdığınızda, isteğinizde, profil daha önce
vectorSearchConfiguration'de belirtilen algoritmanın aynısını belirttiği sürece alanıvectorSearchProfilebelirtecek şekilde değiştirmeniz gerekir. Örneğin, var olan alan tanımı"vectorSearchConfiguration": "myHnsw"belirtiyorsa, bunu"vectorSearchProfile": "your profile name"ile değiştirmeniz ve profilin aynı"algorithm": "myHnsw"başvurmak için tanımlanması gerekir.
-
vectorQueries, 2023-07-01-Preview sürümündekivectorsdeğiştirir -
vectorQueries.vectors, 2023-07-01-Preview sürümündekivectors.valuesdeğiştirir. - Vektör sorgusu artık çok biçimli bir yapıdır. İstenen vektör sorgusunun türünü belirtmek için
kindbelirtilmelidir."kind": "vector", sorgunun bir vektör olduğu anlamına gelir, bu nedenle çağıranın arama sorgusu dizesini bir vektör eklemeye önceden vektörleştirmiş olması gerekir. -
"exhaustive": "true", vektör dizinindeki tüm vektörlerde kapsamlı (deneme yanılma) k-en yakın komşu araması yapılıp yapılmayacağını belirten yeni bir özelliktir. -
vectorFilterMode, sorguda ön filtre (2023-10-01 sonrasında oluşturulan dizinler için varsayılan) veya postfiltering (önceki dizinlerde varsayılan) belirtmek için yeni bir parametredir.
29 Mart 2024 tarihinden itibaren geçerli olacak: GET yanıtları artık bağlantı dizelerini veya anahtarları döndüremez. Ayrıntılar için bkz. Bağlantı bilgilerini okuyan istemci kodu için hataya neden olan değişiklik.
2023-07-01-önizleme
Önemli
bu API sürümünükullanmayın. Bu önizleme sürümünün kullanımdan kaldırılması 15 Nisan 2024'te duyuruldu ve artık 8 Temmuz 2024'te desteklenmemektedir. Geçişle ilgili yardım için bkz. Azure AI Search'da REST API'lerini yükseltme
Bu sürüm vektör desteği ekledi ve daha yeni API sürümleriyle uyumlu olmayan bir vektör yapılandırması kullanıyor.
- Tek duyarlıklı kayan nokta sayıları dizisi içeren alanlara bir
Collection(Edm.Single)veri türü eklendi. Bu, belge alanı başına oluşturulan bir eklemeyi depolamak için kullanılan vektörler için veri türüdür. Arama dizini, vektör yapılandırma özelliklerini de belirtir. Bu API'ler için dizin oluşturma veya güncelleştirmebakın. - Vektör verilerini kabul etmek için dizin oluşturma iş yükleri güncelleştirildi. Bkz. Belge Ekleme, Güncelleştirme veya Silme.
- Vektör araması için sorgu parametreleri eklendi. Bu parametreler için bkz. Arama Belgeleri.
- Get Service Statistics: hizmetin vektör dizini kotasını ve kullanımını döndürür.
- Dizin İstatistiklerini Al: arama dizini için vektör dizin kotası ve kullanımı döndürür.
- 29 Mart 2024 tarihinden itibaren geçerli olacak: GET yanıtları artık bağlantı dizelerini veya anahtarları döndüremez. Ayrıntılar için bkz. Bağlantı bilgilerini okuyan istemci kodu için hataya neden olan değişiklik.
2021-04-30-önizleme
Bu önizleme sürümü, 2020-06-30-Preview sürümünde kullanıma 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 kimlikleri
. veri kaynağı oluşturma veya güncelleştirme bağlantı dizeleri için yeni değerler, sabit kodlanmış veritabanı kimlik bilgileri veya anahtarları yerine Microsoft Entra Id kimlik doğrulaması ve rolleri kullanarak bağlantıları destekler. - Yönetilen kimlik desteği, müşteri tarafından yönetilen şifreleme
varsayılan şifrelemeyi destekleyen 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 (önizleme)anlamsal arama ve yazım denetleyicisi için diğer queryLanguages.
- İsteğe bağlı olarak Belge Arama (önizleme)anlamsal aramadan resim yazıları istemek için bir captions parametresi.
- Anlam yapılandırmalarıDizin Oluştur veya Güncelleştiriçinde belirtilir. Anlamsal yapılandırma, anlam derecelendirmesi, açıklamalı alt yazılar, vurgular ve yanıtlar için hangi alanların kullanılması gerektiğini belirler.
- Arama Belgeleri (önizleme)semantik sorgular için gereken bir semanticConfiguration parametresi.
- 29 Mart 2024 tarihinden itibaren geçerli olacak: GET yanıtları artık bağlantı dizelerini veya anahtarları döndüremez. Ayrıntılar için bkz. Bağlantı bilgilerini okuyan istemci kodu için hataya neden olan değişiklik.
2020-06-30
Bu sürüm, aşağıdakiler de dahil olmak üzere genel kullanıma sunulan özellikler sağlar:
- Veri düzlemi işlemleri için Azure rol tabanlı erişim denetimi
- İlgi puanlaması (BM25)
- Bilgi depoları
- Azure Data Lake Storage (ADLS) 2. Nesil için dizin oluşturucu veri kaynağı
- Özel Varlık Arama becerisi
- Microsoft Entra Id aracılığıyla sistem veya kullanıcı tarafından yönetilen kimlik altında çalışan dizin oluşturucular
- 29 Mart 2024 tarihinden itibaren geçerli olacak: GET yanıtları artık bağlantı dizelerini veya anahtarları döndüremez. Ayrıntılar için bkz. Bağlantı bilgilerini okuyan istemci kodu için hataya neden olan değişiklik.
2020-06-30-önizleme
Bu önizleme sürümü, 2019-05-06-Preview sürümünde sunulan tüm özelliklerin yanı sıra aşağıdaki eklemeleri içerir:
- Standart katman hizmetlerinde çalışan ve anlam sıralamasını çağıran premium bir özellik olan anlamsal arama.
- Power Query Bağlayıcıları için dizin oluşturucu veri kaynağı
- MySQL için dizin oluşturucu veri kaynağı
- Cosmos DB Gremlin API için dizin oluşturucu veri kaynağı
- SharePoint Online için dizin oluşturucu veri kaynağı
- Büyük/küçük harfe duyarlı olmayan filtreleme, modelleme ve sıralama için metin normalleştirme için normalleştirici özelliği
- Belirli belgeleri özel olarak kimlikle yenilemek için dizin oluşturucu tabanlı dizin oluşturma için Belgeleri sıfırla
- Varlık Bağlama bilişsel becerisi (v3)
- Varlık Tanıma bilişsel becerisi (v3)
- Yaklaşım Analizi bilişsel beceri (v3)
- 29 Mart 2024 tarihinden itibaren geçerli olacak: GET yanıtları artık bağlantı dizelerini veya anahtarları döndüremez. Ayrıntılar için bkz. Bağlantı bilgilerini okuyan istemci kodu için hataya neden olan değişiklik.
2019-05-06-preview
- Cosmos DB MongoDB API'sinde dizin oluşturucu veri kaynağı desteği
- Blob Depolama'da geçici silme için dizin oluşturucu veri kaynağı
- bir ilgi puanı hakkında ayrıntılı bilgi döndüren featuresMode parametresi
- Azure Machine Learning (AML) bilişsel becerisi
- Kişisel tanımlama algılama bilişsel becerisi
- Görüntü işlemeyi (ve diğer yapay zeka zenginleştirmelerini) korumak ve yeniden kullanmak için zenginleştirilmiş belgeleri önbelleğe alma
- 29 Mart 2024 tarihinden itibaren geçerli olacak: GET yanıtları artık bağlantı dizelerini veya anahtarları döndüremez. Ayrıntılar için bkz. Bağlantı bilgilerini okuyan istemci kodu için hataya neden olan değişiklik.