Önceki sürümlerden semantik derecelendirme kodunu geçirme
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 hataya neden olan değişiklikler son API'lerdeki sorgu mantığıyla sınırlıdır, ancak kodunuz ilk önizleme sürümünde yazılmışsa, anlamsal yapılandırmanızı da değiştirmeniz gerekebilir.
Hataya neden olan değişiklikler
REST API sürümleri arasında semantik ranker için iki hataya neden olan değişiklik vardır:
-
searchFields2021-04-30-preview sürümünde değiştirildisemanticConfiguration -
queryLanguage2023-07-01-preview sürümünden itibaren yoksayıldı, ancak 2024-11-01-preview sürümünde sorgu yeniden yazma için yeniden 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 |
|---|---|---|
| ilk | 2020-06-30-önizleme | Arama Belgelerine Ekler queryType=semantic |
| 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 hataya neden olan bir değişiklik yoktur, ancak özelliği yoksayılır. Müşterilerin bu özelliği koddan kaldırmaları önerildi. |
| preview | 2023-10-01-önizleme | Yalnızca yeniden boyutlandırma amacıyla kullanılan bir sorguyu göndermeye ekler semanticQuery . |
| ahır | 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 | Değişiklik yok |
| ahır | 2024-07-01 | Değişiklik yok |
| preview | 2024-09-01-önizleme | Değişiklik yok |
| preview | 2024-11-01-önizleme | Sorgu yeniden yazmayı ekler.
queryLanguage Sorgu yeniden yazma (önizleme) kullanıyorsanız özelliği artık gereklidir. |
Azure SDK'ları için günlükleri değiştirme
Azure SDK'ları bağımsız bir sürüm zamanlaması üzerindedir. Hangi paketlerin anlamsal özellikler sağladığını ve herhangi bir API'nin yeniden adlandırılıp adlandırılmadığını belirlemek için değişiklik günlüklerini denetlemeniz gerekir.
- .NET için Azure SDK değişiklik günlüğü
- Python için Azure SDK değişiklik günlüğü
- Java için Azure SDK değişiklik günlüğü
- JavaScript için Azure SDK değişiklik günlüğü
2024-11-01-önizleme
- Arama Belgelerine sorgu yeniden yazma ekler.
-
queryLanguageSorgu yeniden yazma iş yükleri için 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.
2024-07-01
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 içinde prioritizedFieldslistelendiğini varsayarak yanıttaki herhangi bir insan tarafından okunabilir metin alanına yeniden boyutlandırma uygulayabilirsiniz.
2023-11-01
- ve
semanticQuerydeğerleriniSemanticDebughariç tutar, aksi takdirde 2023-10-01-preview sürümüyle aynıdır.
2023-10-01-önizleme
- Ekler
semanticQuery
2023-07-01-önizleme
- , ekler
semanticErrorHandlingsemanticMaxWaitInMilliseconds. - yanıta ve
SemanticErrorModegibiSemanticDebugçok sayıda anlamsal alan ekler. -
queryLanguageyoksayar, artık anlamsal derecelendirmede kullanılmaz.
14 Temmuz 2023'te başlayan semantik ranker dil bağımsızdır. Önizleme sürümlerinde semantik derecelendirme, alan çözümleyicisi tarafından belirtilenden querylanguage farklı sonuçların yerini alı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' ekler.
searchFields özelliği artık alanlara öncelik vermek için kullanılmaz. İleriye doğru ilerleyen tüm sürümlerdesearchFields, semanticConfiguration.prioritizedFields 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. -
searchFieldsSorgu türü semantikse özelliği alansearchFieldsgirişlerinin semantik dereceye öncelik sırasını belirleyecek şekilde uyarlanır. - Sorgu yanıtına ,
answersvehighlightseklercaptions.
Sonraki adımlar
Anlamsal bir sorgu çalıştırarak anlamsal yapılandırma geçişinizi test edin.