Önceki sürümlerden semantik derecelendirme kodunu geçirme

Not

Azure Yapay Zeka Arama Azure portalı, REST API'leri ve Azure SDK’ları aracılığıyla kullanılabilir. Ayrıca kuruluş içeriğini Microsoft Foundry portalındaki aracılar için yeniden kullanılabilir, izin kullanan bilgi bankalarına dönüştüren yönetilen bilgi katmanı Foundry IQ'yu temel alır.

Semantik derecelendirme kodunuz erken önizleme API'lerine karşı yazıldıysa, bu makalede daha yeni API sürümlerine geçiş için gereken kod değişiklikleri tanımlanır. Anlam dereceleyici için uyum bozucu değişiklikler, son zamanlardaki API'lerin sorgu mantığıyla sınırlıdır, ancak kodunuz ilk önizleme sürümüne göre yazılmışsa, anlamsal yapılandırmanızı da değiştirmeniz gerekebilir.

Uyumsuzluk oluşturan değişiklikler

REST API sürümlerinde semantik ranker için iki önemli değişiklik vardır:

  • searchFields yerine semanticConfiguration 2021-04-30-preview sürümünde değiştirildi
  • queryLanguage 2023-07-01-preview sürümünden itibaren yoksayıldı, ancak 2024-11-01-preview sürümünde sorgu yeniden yazımı için tekrar etkinleştirildi.

Sürüme özgü diğer güncelleştirmeler yeni özelliklerle ilgili olsa da var olan kodu bozmaz ve bu nedenle değişiklikleri bozmaz.

Azure SDK'larını kullanıyorsanız, zaman içinde birden çok API yeniden adlandırılmıştır. SDK değişiklik günlükleri ayrıntıları sağlar.

Anlamsal derecelendirme sağlayan API sürümleri

Hangisinin semantik derecelendirme sağladığını onaylamak için kodunuzu REST API sürümü veya SDK paketi sürümü olarak denetleyin. Aşağıdaki API sürümleri anlam derecelendirmesi için bazı düzeyde destek içerir.

Sürüm türü REST API sürümü Anlam dereceleyici güncelleştirmeleri
Başlangıç 2020-06-30-önizleme queryType=semantic öğesini Arama Belgelerine ekler.
Preview 2021-04-30-önizleme Dizin Oluştur veya Güncelleştir'e ekler semanticConfiguration .
Preview 2023-07-01-önizleme Güncelleştirmeleri semanticConfiguration. 14 Temmuz 2023'te Microsoft tarafından barındırılan semantik modellerde yapılan güncelleştirmeler semantik ranker dili agnostik hale getirerek queryLanguage özelliği semantik derecelendirme için etkin bir şekilde kullanımdan kaldırmıştı. Kodda kırılma oluşturan bir değişiklik yok, ancak özellik yoksayılıyor. Müşterilerin bu özelliği koddan kaldırmaları önerildi.
Preview 2023-10-01-önizleme Yalnızca yeniden sıralama amacıyla kullanılan bir sorguyu göndermeye semanticQuery ekler.
İstikrarlı 2023-11-01 Genel kullanıma sunuldu. Kararlı sürümde semanticConfiguration ilerleyen değişiklikler kullanıma sunulmuştur. Kodunuz bu sürümü veya sonraki bir sürümü hedeflediyse, yeni önizleme özelliklerini benimsemediğiniz sürece daha yeni API sürümleriyle uyumludur.
Preview 2024-05-01-önizleme Bir değişiklik olmadı.
İstikrarlı 2024-07-01 Bir değişiklik olmadı.
Preview 2024-09-01-önizleme Bir değişiklik olmadı.
Preview 2024-11-01-önizleme Sorgu yeniden yazmayı ekler. queryLanguage Sorgu yeniden yazma (önizleme) kullanıyorsanız özelliği artık gereklidir.
Preview 2025-03-01-önizleme Semantik modellerin yayın öncesi sürümlerine katılım ekler.
Preview 2025-05-01-önizleme Bu önizlemede API güncelleştirmesi yok, ancak anlamsal derecelendirme artık puanlama profilleriyle daha iyi tümleştirmeye sahip.
Preview 2025-08-01-önizleme Bir değişiklik olmadı.
İstikrarlı 2025-09-01 Bir değişiklik olmadı.
Preview 2025-11-01-önizleme Ücretsiz katmanlarda kullanılabilir.
İstikrarlı 2026-04-01 Anlamsal sıralayıcı ve aracılı getirme için faturalama onayını ayırır. semanticSearch artık yalnızca semantik sıralayıcı faturalandırmasını kontrol eder. Yükseltmeden önce, varsa semanticSearch=standardöğesini de ayarlamanız knowledgeRetrieval=standardgerekir. Daha fazla bilgi için bkz. Semantik dereceli faturalamayı etkinleştirme veya devre dışı bırakma.
Preview 2026-05-01-önizleme Bir değişiklik olmadı.

Azure SDK'leri Değişiklik Günlükleri

Belirli bir Azure SDK paketinde hangi anlamsal özelliklerin kullanılabilir olduğunu ve api'lerin yeniden adlandırılıp adlandırılmadığını belirlemek için SDK'nın değişiklik günlüğüne bakın:

2024-11-01-önizleme

  • Arama Belgelerine sorgu yeniden yazma ekler.
  • Sorgu yeniden yazma iş yükleri için queryLanguage gereklidir. Geçerli değerlerin listesi için bkz . REST API.

2024-09-01-önizleme

2024-07-01 kararlı sürümünden anlamsal derecelendirme söz diziminde değişiklik yok.

01-07-2024

2024-05-01-preview sürümünden anlam derecelendirme söz diziminde değişiklik yok.

Bu API sürümünü kullanmayın. Daha yeni bir API sürümüyle uyumlu olmayan bir vektör sorgusu söz dizimi uygular.

2024-05-01-önizleme

2024-03-01-preview sürümünden anlamsal derecelendirme söz diziminde değişiklik yok.

2024-03-01-önizleme

2023-10-01-preview sürümünde anlamsal derecelendirme söz diziminde değişiklik yapılmaz, ancak vektör sorguları kullanıma sunulmuştur. Anlam derecelendirmesi artık karma ve vektör sorgularından gelen yanıtlar için geçerlidir. Alanların prioritizedFields içinde listelendiğini varsayarak, yanıttaki herhangi bir insan tarafından okunabilir metin alanına yeniden sıralama uygulayabilirsiniz.

2023-11-01

  • SemanticDebug ve semanticQuery hariç, aksi takdirde 2023-10-01-preview sürümüyle aynıdır.

2023-10-01-önizleme

  • Ekler semanticQuery

2023-07-01-önizleme

  • Şunları ekler: semanticErrorHandling, semanticMaxWaitInMilliseconds.
  • Yanıta, SemanticDebug ve SemanticErrorMode gibi birçok anlamsal alan ekler.
  • queryLanguageyoksayar, artık anlamsal derecelendirmede kullanılmaz.

14 Temmuz 2023 itibaren, semantik ranker dil bağımsızdır. Önizleme sürümlerinde, semantik sıralama, alan çözümleyicisi tarafından belirtilen querylanguage farklı sonuçların önceliğini azaltıyor olacaktır. Ancak özellik, queryLanguage yazım düzeltmesi ve bu özellik tarafından desteklenen dillerin kısa listesi için hala geçerlidir.

2021-04-30-önizleme

  • Anlamsal destek, Arama Belgeleri ve Dizin Oluşturma veya Güncelleştirme önizleme API'leri çağrıları aracılığıyla gerçekleştirilir.
  • Arama dizinine ekler semanticConfiguration . Anlamsal yapılandırmanın adı ve önceliklendirilmiş alan listesi vardır.
  • `prioritizedFields`'i ekler.

searchFields özelliği artık alanlara öncelik vermek için kullanılmaz. İleriye doğru ilerleyen tüm sürümlerdesemanticConfiguration.prioritizedFields, searchFields L2 derecelendirmesi için hangi alanların kullanılacağını belirtme mekanizması olarak değiştirir.

2020-06-30-önizleme

  • Anlamsal destek, Arama Belgeleri önizleme API'si çağrısı aracılığıyla yapılır.
  • Sorgu isteğine ekler queryType=semantic .
  • searchFields, sorgu türü semantikse searchFields özelliğinin alan girişlerinin semantik sıralayıcıda öncelik sırasını belirlemesini sağlayacak şekilde uyarlanır.
  • Sorgu yanıtına , captionsve answers eklerhighlights.

Sonraki adımlar

Anlamsal bir sorgu çalıştırarak anlamsal yapılandırma geçişinizi test edin.

Anlamsal sorgu oluşturma

  • Last updated on