Aktifkan atau nonaktifkan penagihan pemeringkat semantik

Catatan

Pencarian Azure AI tersedia melalui portal Azure, REST API, dan Azure SDK. Ini juga mendukung Foundry IQ, lapisan pengetahuan terkelola yang mengubah konten perusahaan menjadi pangkalan pengetahuan yang dapat digunakan kembali dan sadar izin untuk agen di portal Microsoft Foundry.

Peringkat semantik adalah fitur premium yang ditagihkan sesuai penggunaan. Secara default, semua layanan pencarian terdaftar dalam paket gratis, yang menyediakan jatah permintaan bulanan tanpa biaya. Untuk mengaktifkan akses berkelanjutan setelah kuota gratis digunakan, Anda dapat beralih ke paket standar.

Mulai versi 2026-04-01 REST API Search Service, persetujuan penagihan untuk semantic ranker dan retrieval agentik dilakukan secara terpisah. Gunakan semanticSearch untuk mengontrol penagihan untuk ranker semantik dan knowledgeRetrieval untuk mengontrol penagihan untuk pengambilan agenik.

Prasyarat

Layanan Pencarian Azure AI di wilayah mana pun yang menyediakan pengurut semantik.
Akses Pemilik atau Kontributor ke layanan pencarian.
Search Management REST API versi 2026-03-01-preview atau yang lebih baru untuk mengatur properti semanticSearch.

Pemisahan penagihan

Anda menetapkan persetujuan penagihan menggunakan REST API Manajemen Pencarian. Tabel berikut menunjukkan properti mana yang berlaku berdasarkan versi REST API Layanan Pencarian yang digunakan aplikasi Anda.

Versi REST API Layanan Pencarian	Penagihan pengurut semantik	Penagihan pengambilan berbasis agensi
2026-04-01 dan setelahnya	Dikontrol oleh `semanticSearch`	Dikontrol oleh `knowledgeRetrieval`
Pratinjau 1-11-2025 dan sebelumnya	Dikontrol oleh `semanticSearch`	Dikontrol oleh `semanticSearch`

Untuk versi REST API Layanan Pencarian 2026-04-01 dan yang lebih baru, semanticSearch hanya memengaruhi penagihan ranker semantik. Untuk mengendalikan penagihan pengambilan agensi, lihat Mengaktifkan atau menonaktifkan penagihan pengambilan agensi.

Untuk REST API Layanan Pencarian versi 2025-11-01-preview dan yang lebih lama, semanticSearch mengatur persetujuan untuk ranker semantik dan penggunaan pengambilan agentik berbayar.

Paket penagihan

Ranker semantik memiliki dua pilihan pembayaran. Untuk harga menurut mata uang, lihat harga Pencarian Azure AI.

Rencana	Deskripsi	Availability
Gratis (default)	Menyediakan jatah permintaan gratis bulanan. Setelah jatah gratis habis, permintaan dari pemeringkat semantik mengembalikan kesalahan penagihan.	Tersedia di semua tingkat harga.
Standar	Biaya berdasarkan penggunaan setelah kuota gratis bulanan habis digunakan.	Memerlukan tingkat Dasar atau lebih tinggi.

Mengaktifkan penagihan peringkat semantik

Ikuti langkah-langkah ini untuk mengubah pemeringkat semantik ke rencana penagihan standar. Paket penagihan berlaku di tingkat layanan dan memengaruhi semua indeks.

Portal Azure
SISANYA

Buka layanan pencarian Anda di portal Azure.
Pada halaman Gambaran Umum , pastikan tingkat harganya dasar atau lebih tinggi.
Dari panel kiri, pilih Pengaturan>fitur Premium.
Di bawah Semantic ranker, pilih Pilih paket pada kartu Standard.

Gunakan Layanan - Buat Atau Perbarui (REST API Manajemen Pencarian) untuk mengatur semanticSearch ke standard:

PATCH https://management.azure.com/subscriptions/{{subscription-id}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2026-03-01-preview
Content-Type: application/json
Authorization: Bearer {{management-access-token}}

{
  "properties": {
    "semanticSearch": "standard"
  }
}

Panggilan REST API Manajemen diautentikasi melalui Microsoft Entra ID. Untuk petunjuk tentang cara mengautentikasi, lihat Kelola layanan Pencarian Azure AI Anda dengan REST API.

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.

Menonaktifkan penagihan pemeringkat semantik

Ikuti langkah-langkah ini untuk mengalihkan ranker semantik kembali ke paket penagihan gratis.

Portal Azure
SISANYA

Buka layanan pencarian Anda di portal Azure.
Dari panel kiri, pilih Pengaturan>fitur Premium.
Di bawah Pemeringkat semantik, pilih Pilih paket di kartu Gratis.

Gunakan Layanan - Buat atau Perbarui (REST API Manajemen Pencarian) untuk diatur semanticSearch ke free:

PATCH https://management.azure.com/subscriptions/{{subscription-id}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2026-03-01-preview
Content-Type: application/json
Authorization: Bearer {{management-access-token}}

{
  "properties": {
    "semanticSearch": "free"
  }
}

Panggilan REST API Manajemen diautentikasi melalui Microsoft Entra ID. Untuk petunjuk tentang cara mengautentikasi, lihat Kelola layanan Pencarian Azure AI Anda dengan REST API.

Catatan

Nilai disabled tidak lagi valid dalam versi REST API Manajemen Pencarian dan yang 2026-03-01-preview lebih baru. Layanan yang ada dengan semanticSearch diatur ke disabled secara otomatis diperlakukan sebagai free.

Langkah berikutnya

Mengonfigurasi pemeringkat semantik

Saran dan Komentar

Apakah halaman ini membantu?

Terakhir diperbarui pada 2026-08-31

Aktifkan atau nonaktifkan penagihan pemeringkat semantik

Prasyarat

Pemisahan penagihan

Paket penagihan

Mengaktifkan penagihan peringkat semantik

Menonaktifkan penagihan pemeringkat semantik

Langkah berikutnya

Saran dan Komentar

Sumber Daya Tambahan: