Memigrasikan kode peringkat semantik dari versi sebelumnya
Jika kode peringkat semantik Anda ditulis terhadap API pratinjau awal, artikel ini mengidentifikasi perubahan kode yang diperlukan untuk bermigrasi ke versi API yang lebih baru. Perubahan yang melanggar untuk ranker semantik terbatas pada logika kueri dalam API baru-baru ini, tetapi jika kode Anda ditulis terhadap versi pratinjau awal, Anda mungkin juga perlu mengubah konfigurasi semantik Anda.
Perubahan mencolok
Ada dua perubahan yang melanggar untuk peringkat semantik di seluruh versi REST API:
-
searchFieldsdigantikan olehsemanticConfiguration2021-04-30-preview -
queryLanguagediabaikan mulai pratinjau 2023-07-01, tetapi dipulihkan untuk penulisan ulang kueri dalam pratinjau 2024-11-01
Pembaruan khusus versi lainnya berkaitan dengan kemampuan baru, tetapi tidak merusak kode yang ada dan karenanya tidak melanggar perubahan.
Jika Anda menggunakan Azure SDK, beberapa API telah diganti namanya dari waktu ke waktu. Log perubahan SDK memberikan detailnya.
Versi API menyediakan peringkat semantik
Periksa kode Anda untuk versi REST API atau versi paket SDK untuk mengonfirmasi mana yang menyediakan peringkat semantik. Versi API berikut memiliki beberapa tingkat dukungan untuk peringkat semantik.
| Jenis Rilis | Versi REST API | Pembaruan peringkat semantik |
|---|---|---|
| Awal | Pratinjau 06-30 2020 |
queryType=semantic Menambahkan ke Dokumen Pencarian |
| pratinjau | Pratinjau 04-30 2021 |
semanticConfiguration Menambahkan ke Buat atau Perbarui Indeks |
| pratinjau | Pratinjau 07-01 2023 | Pembaruan semanticConfiguration. Mulai 14 Juli 2023 pembaruan untuk model semantik yang dihosting Microsoft membuat agnostik bahasa pemeringkat queryLanguage semantik, secara efektif menonaktifkan properti untuk peringkat semantik. Tidak ada perubahan kode yang melanggar, tetapi properti diabaikan. Pelanggan disarankan untuk menghapus properti ini dari kode. |
| pratinjau | Pratinjau 10-10-2023 |
semanticQuery Menambahkan untuk mengirim kueri yang digunakan hanya untuk tujuan reranking. |
| Stabil | 2023-11-01 | Tersedia secara umum. Memperkenalkan perubahan pada semanticConfiguration yang berkembang ke versi stabil. Jika kode Anda menargetkan versi ini atau yang lebih baru, kode tersebut kompatibel dengan versi API yang lebih baru kecuali Anda mengadopsi fitur pratinjau baru. |
| pratinjau | Pratinjau 05-01 2024 | Tidak Ada Perubahan |
| Stabil | 2024-07-01 | Tidak Ada Perubahan |
| pratinjau | Pratinjau 09-09-2024 | Tidak Ada Perubahan |
| pratinjau | Pratinjau 11-11-2024 | Menambahkan penulisan ulang kueri. Properti queryLanguage sekarang diperlukan jika Anda menggunakan penulisan ulang kueri (pratinjau). |
Mengubah log untuk Azure SDK
Azure SDK berada pada jadwal rilis independen. Anda harus memeriksa log perubahan untuk menentukan paket mana yang menyediakan fitur semantik dan apakah ADA API yang telah diganti namanya.
- Azure SDK untuk log perubahan .NET
- Log perubahan Azure SDK untuk Python
- Azure SDK untuk log perubahan Java
- Azure SDK untuk log perubahan JavaScript
Pratinjau 11-11-2024
- Menambahkan penulisan ulang kueri ke Dokumen Pencarian.
-
queryLanguageMemerlukan beban kerja penulisan ulang kueri. Untuk daftar nilai yang valid, lihat REST API.
Pratinjau 09-09-2024
Tidak ada perubahan pada sintaks peringkat semantik dari versi stabil 2024-07-01.
2024-07-01
Tidak ada perubahan pada sintaks peringkat semantik dari versi pratinjau 2024-05-01.
Jangan gunakan versi API ini. Ini menerapkan sintaks kueri vektor yang tidak kompatibel dengan versi API yang lebih baru.
Pratinjau 05-01 2024
Tidak ada perubahan pada sintaks peringkat semantik dari versi pratinjau 2024-03-01.
Pratinjau 03-03-2024
Tidak ada perubahan pada sintaks peringkat semantik dari versi pratinjau 2023-10-01, tetapi kueri vektor diperkenalkan. Peringkat semantik sekarang berlaku untuk respons dari kueri hibrid dan vektor. Anda dapat menerapkan reranking pada bidang teks yang dapat dibaca manusia dalam respons, dengan asumsi bidang tercantum dalam prioritizedFields.
2023-11-01
-
SemanticDebugKecualikan dansemanticQuery, jika tidak sama dengan versi pratinjau 2023-10-01.
Pratinjau 10-10-2023
- Menambahkan
semanticQuery
Pratinjau 07-01 2023
-
semanticErrorHandlingMenambahkan ,semanticMaxWaitInMilliseconds. - Menambahkan banyak bidang terkait semantik ke respons, seperti
SemanticDebugdanSemanticErrorMode. -
queryLanguageMengabaikan , itu tidak lagi digunakan dalam peringkat semantik.
Mulai 14 Juli 2023, peringkat semantik adalah agnostik bahasa. Dalam versi pratinjau, peringkat semantik akan memisahkan hasil yang berbeda dari querylanguage yang ditentukan oleh penganalisis bidang. Namun, queryLanguage properti masih berlaku untuk koreksi ejaan dan daftar singkat bahasa yang didukung oleh fitur tersebut.
Pratinjau 04-30 2021
- Dukungan semantik adalah melalui pencarian dokumen dan membuat atau memperbarui indeks pratinjau api panggilan.
-
semanticConfigurationMenambahkan ke indeks pencarian. Konfigurasi semantik memiliki nama dan daftar bidang yang diprioritaskan. - Menambahkan ''prioritizedFields'.
Properti searchFields tidak lagi digunakan untuk memprioritaskan bidang. Di semua versi yang bergerak maju, semanticConfiguration.prioritizedFields menggantikan searchFields sebagai mekanisme untuk menentukan bidang mana yang akan digunakan untuk peringkat L2.
Pratinjau 06-30 2020
- Dukungan semantik adalah melalui panggilan API pratinjau Dokumen Pencarian.
-
queryType=semanticMenambahkan ke permintaan kueri. -
searchFieldsBeradaptasi sehingga jika jenis kueri semantik,searchFieldsproperti menentukan urutan prioritas input bidang ke ranker semantik. -
captionsMenambahkan ,answers, danhighlightske respons kueri.
Langkah berikutnya
Uji migrasi konfigurasi semantik Anda dengan menjalankan kueri semantik.