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 besar pada ranker semantik terbatas pada logika kueri pada API terkini, tetapi jika kode Anda ditulis berdasarkan versi pratinjau awal, Anda mungkin juga perlu mengubah konfigurasi semantik Anda.

Perubahan mencolok

Ada dua perubahan signifikan terkait peringkat semantik di antara versi REST API.

  • searchFields digantikan oleh semanticConfiguration pada 2021-04-30-preview
  • queryLanguage diabaikan mulai 2023-07-01-preview, tetapi diaktifkan kembali dalam rangka penulisan ulang kueri pada 2024-11-01-preview

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 menyediakan rincian.

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.
Preview Pratinjau 2021-04-30 Menambahkan semanticConfiguration ke Buat atau Perbarui Indeks.
Preview 2023-07-01-pratinjau Pembaruan semanticConfiguration. Mulai 14 Juli 2023, pembaruan untuk model semantik yang dihosting Microsoft membuat pemeringkat semantik bebas bahasa, secara efektif menghentikan penggunaan properti queryLanguage untuk pemeringkatan semantik. Tidak ada perubahan kode yang merusak, tetapi properti diabaikan. Pelanggan disarankan untuk menghapus properti ini dari kode.
Preview Pratinjau 01-10-2023 Menambahkan semanticQuery untuk mengirim kueri yang digunakan hanya untuk tujuan peringkat ulang.
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.
Preview Pratinjau 2024-05-01 Tidak Ada Perubahan.
Stabil 2024-07-01 Tidak Ada Perubahan.
Preview Pratinjau 01-09-2024 Tidak Ada Perubahan.
Preview Pratinjau 11-11-2024 Menambahkan penulisan ulang kueri. Properti queryLanguage sekarang diperlukan jika Anda menggunakan penulisan ulang kueri (pratinjau).
Preview pratinjau 2025-03-01 Menyertakan opsi keikutsertaan untuk versi prarilis model semantik.
Preview Pratinjau 05-01 2025 Tidak ada pembaruan API dalam pratinjau ini, tetapi peringkat semantik sekarang memiliki integrasi yang lebih baik dengan profil penilaian.
Preview Pratinjau 08-01 2025 Tidak Ada Perubahan.
Stabil 2025-09-01 Tidak Ada Perubahan.
Preview Pratinjau 2025-11-01 Tersedia pada tingkat gratis.
Stabil 2026-04-01 Memisahkan persetujuan penagihan untuk ranker semantik dan pengambilan agenik. semanticSearch sekarang hanya mengontrol penagihan ranker semantik. Sebelum memutakhirkan, jika Anda memiliki semanticSearch=standard, Anda juga harus mengatur knowledgeRetrieval=standard. Untuk informasi selengkapnya, lihat Mengaktifkan atau menonaktifkan penagihan ranker semantik.
Preview 2026-05-01-preview Tidak Ada Perubahan.

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:

Pratinjau 01-11-2024

  • Menambahkan penulisan ulang kueri ke Dokumen Pencarian.
  • Memerlukan queryLanguage untuk beban kerja penulisan ulang kueri. Untuk daftar nilai yang valid, lihat REST API.

Pratinjau 2024-09-01

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 01-05-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

  • Kecuali SemanticDebug dan semanticQuery, selebihnya sama dengan versi pratinjau 2023-10-01.

Pratinjau 10-10-2023

  • Menambahkan semanticQuery

Pratinjau 01-07-2023

  • Menambahkan semanticErrorHandling, semanticMaxWaitInMilliseconds.
  • Menambahkan banyak bidang terkait semantik ke respons, seperti SemanticDebug dan SemanticErrorMode.
  • Mengabaikan queryLanguage, tidak lagi digunakan dalam peringkat semantik.

Mulai 14 Juli 2023, peringkat semantik tidak bergantung pada bahasa. Dalam versi pratinjau, peringkat semantik akan mengurangi prioritas hasil yang berbeda dari querylanguage yang ditentukan oleh analis bidang. Namun, queryLanguage properti masih berlaku untuk koreksi ejaan dan daftar singkat bahasa yang didukung oleh fitur tersebut.

30-04-2021 Pratinjau

  • Dukungan semantik disediakan melalui Pencarian Dokumen dan Membuat atau Memperbarui Indeks panggilan API pratinjau.
  • 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 30-06-2020

  • Dukungan semantik dilakukan melalui panggilan API pratinjau Pencarian Dokumen.
  • Menambahkan queryType=semantic ke permintaan kueri.
  • searchFields Beradaptasi agar jika jenis kueri adalah semantik, properti searchFields menentukan urutan prioritas masukan 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

  • Last updated on