Mengaktifkan atau menonaktifkan peringkat semantik

Peringkat semantik adalah fitur premium yang biaya penggunaannya ditagih berdasarkan jumlah pemakaian. Secara default, ranker semantik diaktifkan pada layanan pencarian baru yang dapat ditagih dan dikonfigurasi untuk paket gratis, tetapi siapa pun dengan izin Kontributor dapat menonaktifkannya atau mengubah paket penagihan. Jika Anda tidak ingin siapa pun menggunakan fitur ini, Anda dapat menonaktifkannya di seluruh layanan menggunakan REST API manajemen. Jika Anda menonaktifkan peringkat semantik, Anda juga menonaktifkan pengambilan agenik.

Memeriksa ketersediaan

Untuk memeriksa apakah ranker semantik tersedia di wilayah Anda, periksa list wilayah Pencarian Azure AI.

Aktifkan pemeringkat semantik

Peringkat semantik mungkin tidak diaktifkan pada layanan yang lebih lama. Ikuti langkah-langkah ini untuk mengaktifkan peringkat semantik di tingkat layanan. Setelah diaktifkan, fitur ini tersedia untuk semua indeks. Anda tidak dapat mengaktifkan atau menonaktifkannya untuk indeks tertentu.

Portal Azure

1. Buka Azure portal.

2. Buka layanan pencarian Anda. Pada halaman Gambaran Umum , pastikan tingkat harga diatur ke Dasar atau lebih tinggi.

3. Di panel navigasi kiri, pilih Pengaturan>fitur Premium.

4. Pilih paket Gratis (default) atau paket Standar. Anda dapat beralih antara paket gratis dan paket standar kapan saja.

   

Paket gratis dibatasi pada 1.000 kueri per bulan. Setelah 1.000 kueri pertama dalam paket gratis, pesan kesalahan menunjukkan bahwa Anda telah menghabiskan kuota pada kueri semantik berikutnya. Ketika kuota habis, Anda dapat meningkatkan ke paket standar untuk terus menggunakan peringkat semantik.

REST

Untuk mengaktifkan ranker semantik, Anda dapat menggunakan Layanan - Buat Atau Perbarui (REST API).

Panggilan REST API manajemen diautentikasi melalui ID Microsoft Entra. Untuk instruksi tentang cara mengautentikasi, lihat Mengelola layanan Pencarian Azure AI Anda dengan REST API.

• Management REST API versi 2023-11-01 atau yang lebih baru menyediakan properti konfigurasi.

• Izin Pemilik atau Kontributor diperlukan untuk mengaktifkan atau menonaktifkan fitur.

Catatan

Buat atau Perbarui mendukung dua metode HTTP: PUT dan PATCH. PUT dan PATCH dapat digunakan untuk memperbarui layanan yang ada, tetapi hanya PUT yang dapat digunakan untuk membuat layanan baru. Jika PUT digunakan untuk memperbarui layanan yang ada, put akan menggantikan semua properti dalam layanan dengan defaultnya jika tidak ditentukan dalam permintaan. Ketika PATCH digunakan untuk memperbarui layanan yang ada, PATCH hanya menggantikan properti yang ditentukan dalam permintaan. Saat menggunakan PUT untuk memperbarui layanan yang ada, dimungkinkan untuk secara tidak sengaja memperkenalkan penskalaan atau perubahan konfigurasi yang tidak terduga. Saat mengaktifkan peringkat semantik pada layanan yang ada, disarankan untuk menggunakan PATCH alih-alih PUT.

PATCH https://management.azure.com/subscriptions/{{subscriptionId}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2025-05-01
    {
      "properties": {
        "semanticSearch": "standard"
      }
    }

Menonaktifkan ranker semantik menggunakan REST API

Untuk menonaktifkan pengaktifan fitur, atau untuk perlindungan penuh terhadap penggunaan dan biaya yang tidak disengaja, Anda dapat menonaktifkan ranker semantik dengan menggunakan API Buat atau Perbarui Layanan pada layanan pencarian Anda. Setelah fitur dinonaktifkan, permintaan apa pun yang menyertakan jenis kueri semantik ditolak.

Panggilan REST API manajemen diautentikasi melalui ID Microsoft Entra. Untuk instruksi tentang cara mengautentikasi, lihat Mengelola layanan Pencarian Azure AI Anda dengan REST API.

PATCH https://management.azure.com/subscriptions/{{subscriptionId}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2025-05-01
    {
      "properties": {
        "semanticSearch": "disabled"
      }
    }

Untuk mengaktifkan kembali ranker semantik, jalankan permintaan sebelumnya lagi dan atur semanticSearch ke Gratis (default) atau Standar.

Langkah selanjutnya

Mengonfigurasi pengurut semantik