Mengaktifkan atau menonaktifkan ranker semantik

Peringkat semantik adalah fitur premium yang ditagih berdasarkan penggunaan. Secara default, ranker semantik dinonaktifkan pada layanan pencarian baru, tetapi dapat diaktifkan oleh siapa pun dengan izin Kontributor . Jika Anda tidak ingin siapa pun mengaktifkannya secara tidak sengaja, Anda dapat menonaktifkannya menggunakan REST API.

Memeriksa ketersediaan

Periksa daftar wilayah untuk melihat apakah wilayah Anda tercantum.

Aktifkan pemeringkat semantik

Ikuti langkah-langkah ini untuk mengaktifkan peringkat semantik di tingkat layanan. Setelah diaktifkan, indeks tersedia untuk semua indeks. Anda tidak dapat mengaktifkan atau menonaktifkannya untuk indeks tertentu.

Portal Azure

1. Buka portal Microsoft Azure.

2. Buka layanan pencarian Anda. Pada halaman Gambaran Umum , pastikan layanan adalah tingkat yang dapat ditagih, Dasar atau lebih tinggi.

3. Pada panel navigasi kiri, pilih Pengaturan>Peringkat semantik.

4. Pilih paket Gratis 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 kelelahan kuota pada kueri semantik berikutnya. Ketika kuota habis, Anda harus meningkatkan ke paket standar untuk terus menggunakan peringkat semantik.

REST

Untuk mengaktifkan ranker semantik menggunakan REST API, Anda dapat menggunakan API Buat atau Perbarui Layanan.

Panggilan REST API manajemen diautentikasi melalui ID Microsoft Entra. Lihat Mengelola layanan Pencarian Azure AI Anda dengan REST API untuk petunjuk tentang cara mengautentikasi.

• Management REST API versi 2023-11-01 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=2023-11-01
    {
      "properties": {
        "semanticSearch": "standard"
      }
    }

Menonaktifkan ranker semantik menggunakan REST API

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

Panggilan REST API manajemen diautentikasi melalui ID Microsoft Entra. Lihat Mengelola layanan Pencarian Azure AI Anda dengan REST API untuk petunjuk tentang cara mengautentikasi.

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

Untuk mengaktifkan kembali ranker semantik, jalankan ulang permintaan sebelumnya, atur "semanticSearch" ke "free" (default) atau "standard".

Langkah berikutnya

Konfigurasikan peringkat semantik sehingga Anda dapat menguji peringkat semantik pada konten Anda.