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:

• searchFields digantikan oleh semanticConfiguration 2021-04-30-preview
• queryLanguage diabaikan 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).
pratinjau	pratinjau 2025-03-01	Menyertakan opsi keikutsertaan untuk versi prarilis model semantik.
pratinjau	Pratinjau 05-01 2025	Tidak ada pembaruan API dalam pratinjau ini, tetapi peringkat semantik sekarang memiliki integrasi yang lebih baik dengan profil penilaian.
pratinjau	Pratinjau 08-01 2025	Tidak Ada Perubahan
pratinjau	Pratinjau 2025-11-01	Tersedia pada tingkat gratis.

Mengubah log untuk Azure SDK

Untuk menentukan fitur semantik mana yang tersedia dalam paket Azure SDK tertentu dan apakah ada API yang telah diganti namanya, lihat log perubahan SDK:

• 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.
• queryLanguage Memerlukan 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.

01-07-2024

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

• SemanticDebug Kecualikan dan semanticQuery, 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 SemanticDebug dan SemanticErrorMode.
• 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.
• semanticConfiguration Menambahkan 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=semantic Menambahkan ke permintaan kueri.
• searchFields Beradaptasi sehingga jika jenis kueri semantik, searchFields properti menentukan urutan prioritas input bidang ke ranker semantik.
• captionsMenambahkan , answers, dan highlights ke respons kueri.

Langkah berikutnya

Uji migrasi konfigurasi semantik Anda dengan menjalankan kueri semantik.

Membuat kueri semantik