Mengonfigurasi layanan Pencarian Azure AI Anda di portal Azure

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.

Mengonfigurasi layanan Pencarian Azure AI baru Anda melibatkan beberapa tugas untuk mengoptimalkan keamanan, akses, dan performa. Artikel ini menyediakan daftar periksa hari pertama untuk membantu Anda menyiapkan layanan di portal Azure.

Setelah Anda membuat layanan pencarian, kami sarankan Anda:

Mengonfigurasi akses berbasis peran

Akses portal didasarkan pada penetapan peran. Secara default, layanan pencarian baru memiliki setidaknya satu administrator atau pemilik layanan. Administrator layanan, rekan administrator, dan pemilik memiliki izin untuk membuat lebih banyak administrator dan menetapkan peran lain. Mereka juga memiliki akses ke semua halaman portal dan operasi pada layanan pencarian default.

Tips

Secara default, administrator atau pemilik apa pun dapat membuat atau menghapus layanan. Untuk mencegah penghapusan yang tidak disengaja, pertimbangkan untuk mengunci sumber daya Anda.

Setiap layanan pencarian dilengkapi dengan kunci API dan menggunakan autentikasi berbasis kunci secara default. Namun, sebaiknya gunakan Microsoft Entra ID dan kontrol akses berbasis peran (RBAC) untuk meningkatkan keamanan. RBAC menghilangkan kebutuhan untuk menyimpan dan meneruskan kunci API dalam teks biasa.

Saat Anda beralih dari autentikasi berbasis kunci ke autentikasi tanpa kunci, administrator layanan harus menetapkan peran data plane untuk akses penuh ke objek dan data. Peran ini termasuk Kontributor Layanan Pencarian, Kontributor Data Indeks Pencarian, dan Pembaca Data Indeks Pencarian.

Untuk mengonfigurasi akses berbasis peran:

  1. Aktifkan peran pada layanan pencarian Anda. Kami merekomendasikan menggunakan kunci API dan peran.

  2. Tetapkan peran sarana data untuk menggantikan fungsionalitas yang hilang saat Anda menonaktifkan kunci API. Pemilik hanya memerlukan Pembaca Data Indeks Pencarian, tetapi pengembang memerlukan lebih banyak peran.

    Penetapan peran dapat memakan waktu beberapa menit untuk diterapkan. Hingga saat itu, halaman portal yang digunakan untuk operasi sarana data menampilkan pesan berikut:

    Cuplikan layar pesan portal yang menunjukkan izin yang tidak mencukup.

  3. Tetapkan lebih banyak peran untuk pengembang solusi dan aplikasi.

Mengonfigurasi identitas terkelola

Jika Anda berencana menggunakan pengindeks untuk pengindeksan otomatis, AI yang diterapkan, atau vektorisasi terintegrasi, Anda harus mengonfigurasi layanan pencarian Anda untuk menggunakan identitas terkelola. Anda kemudian dapat menetapkan peran pada layanan Azure lain yang mengotorisasi layanan pencarian Anda untuk mengakses data dan operasi.

Untuk vektorisasi terintegrasi, identitas layanan pencarian Anda memerlukan peran berikut:

  • Pembaca Data Blob Storage di Azure
  • Pengguna Data Layanan Kognitif pada sumber daya Microsoft Foundry

Penetapan peran dapat memakan waktu beberapa menit untuk diterapkan.

Sebelum Anda beralih ke keamanan jaringan, pertimbangkan untuk menguji semua titik koneksi untuk memvalidasi penetapan peran. Jalankan wizard impor untuk menguji izin.

Mengonfigurasi keamanan jaringan

Secara default, layanan pencarian menerima permintaan yang diautentikasi dan diotorisasi melalui koneksi internet publik. Anda memiliki dua opsi untuk meningkatkan keamanan jaringan:

Untuk mempelajari tentang panggilan masuk dan keluar di Pencarian Azure AI, lihat Mahami pola lalu lintas jaringan.

Periksa kapasitas dan pahami penagihan

Secara default, layanan pencarian dibuat dengan satu replika dan satu partisi. Anda dapat menambahkan kapasitas dengan menambahkan replika dan partisi, tetapi sebaiknya tunggu hingga volume memerlukannya. Banyak pelanggan menjalankan beban kerja produksi pada konfigurasi minimum.

Pemeringkat semantik dan pengambilan berbasis agen adalah fitur premium yang secara default termasuk dalam paket gratis. Jika Anda memerlukan penggunaan berbayar di luar jatah gratis, lihat Mengaktifkan atau menonaktifkan penagihan peringkat semantik dan Mengaktifkan atau menonaktifkan penagihan pengambilan agen.

Untuk mempelajari tentang fitur lain yang memengaruhi penagihan, lihat Plan dan kelola biaya layanan Pencarian Azure AI.

Aktifkan pembuatan log diagnostik

Aktifkan pembuatan log diagnostik untuk melacak aktivitas pengguna. Jika Anda melewati langkah ini, Anda masih mendapatkan log aktivitas dan metrik platform secara otomatis. Namun, jika Anda menginginkan informasi penggunaan indeks dan kueri, Anda harus mengaktifkan pembuatan log diagnostik dan memilih tujuan untuk operasi yang dicatat. Kami merekomendasikan Log Analytics Workspace untuk penyimpanan yang tahan lama agar Anda dapat menjalankan kueri sistem di portal Azure.

Secara internal, Microsoft mengumpulkan data telemetri tentang layanan dan platform Anda. Untuk mempelajari selengkapnya tentang retensi data, lihat Retensi metrik.

Untuk mempelajari selengkapnya tentang lokasi dan privasi data, lihat Residensi data.

Memberikan informasi koneksi kepada pengembang

Untuk terhubung ke Pencarian Azure AI, pengembang memerlukan:

  • Titik akhir atau URL dari halaman Gambaran Umum .
  • Kunci API dari halaman Kunci atau penetapan peran. Kami merekomendasikan Kontributor Layanan Pencarian, Kontributor Data Indeks Pencarian, dan Pembaca Data Indeks Pencarian.

Kami merekomendasikan akses portal untuk wizard Impor data dan Penjelajah pencarian. Anda harus menjadi Kontributor atau yang lebih tinggi untuk menjalankan wizard.

Untuk dukungan terprogram untuk administrasi layanan, lihat API dan modul berikut:

Anda juga dapat menggunakan pustaka klien manajemen di Azure SDK untuk .NET, Python, Java, dan JavaScript.

Ada paritas fitur di semua modalitas dan bahasa, kecuali untuk fitur manajemen pratinjau. Sebagai aturan umum, fitur manajemen pratinjau dirilis melalui MANAGEMENT REST API terlebih dahulu.