Mengaktifkan atau menonaktifkan tagihan penarikan agentik

Note

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.

Pengambilan berbasis agen adalah fitur premium yang ditagih berdasarkan penggunaan. Secara default, semua layanan pencarian terdaftar dalam paket gratis, yang memberikan jatah 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 knowledgeRetrieval untuk mengontrol penggunaan pengambilan agenik berbayar secara independen dari semanticSearch.

Prasyarat

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

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 Search Service REST API versi 2026-04-01 dan yang lebih baru, knowledgeRetrieval mengendalikan penagihan pengambilan agentik secara terpisah dari semanticSearch. Untuk mengontrol penagihan ranker semantik, lihat Mengaktifkan atau menonaktifkan penagihan ranker semantik.

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. Properti knowledgeRetrieval diabaikan.

Paket penagihan

Sistem pengambilan agenik memiliki dua skema penagihan. Untuk harga menurut mata uang, lihat harga Pencarian Azure AI.

Rencana	Deskripsi	Availability
Gratis (default)	Menyediakan tunjangan token bulanan tanpa biaya. Setelah jatah gratis dikonsumsi, permintaan yang akan dikenakan penggunaan berbayar mengembalikan kesalahan yang diperlukan pembayaran.	Tersedia di semua tingkat harga.
Standar	Biaya berdasarkan penggunaan setelah kuota gratis bulanan habis digunakan.	Memerlukan tingkat Dasar atau lebih tinggi.

Mengaktifkan penagihan pengambilan data agenik

Ikuti langkah-langkah ini untuk mengalihkan pengambilan berbasis agen ke paket penagihan standar.

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 Pengambilan pengetahuan, pilih Pilih paket di kartu Standar.

Gunakan Layanan - Buat Atau Perbarui (REST API Manajemen Pencarian) untuk mengatur knowledgeRetrieval 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": {
    "knowledgeRetrieval": "standard"
  }
}

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

Penting

Jika sebelumnya Anda mengandalkan semanticSearch untuk mengaktifkan penggunaan pengambilan agenik berbayar, Anda harus secara eksplisit mengatur knowledgeRetrieval ke standard sebelum memigrasikan beban kerja pengambilan agenik ke versi REST API Layanan Pencarian atau yang 2026-04-01 lebih baru. Persetujuan yang semanticSearch=standard ada tidak berlaku untuk knowledgeRetrieval.

Menonaktifkan penagihan pengambilan berbasis agen

Ikuti langkah-langkah ini untuk mengalihkan pengambilan agenik kembali ke paket penagihan gratis.

Portal Azure
SISANYA

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

Gunakan Layanan - Buat atau Perbarui (REST API Manajemen Pencarian) untuk diatur knowledgeRetrieval 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": {
    "knowledgeRetrieval": "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.

Saran dan Komentar

Apakah halaman ini membantu?

Terakhir diperbarui pada 2026-08-31