Mulai cepat: Membuat aplikasi pencarian demo di portal Azure

Dalam mulai cepat untuk Pencarian Azure AI ini, pelajari cara menggunakan wizard Buat aplikasi demo portal Azure untuk menghasilkan aplikasi web gaya "localhost" yang dapat diunduh yang berjalan di browser. Bergantung pada cara Anda mengonfigurasinya, aplikasi yang dihasilkan beroperasi pada penggunaan pertama, dengan koneksi baca-saja langsung ke indeks di layanan pencarian Anda. Aplikasi default dapat menyertakan bilah pencarian, area hasil, filter bilah sisi, dan dukungan typeahead.

Aplikasi demo dapat membantu Anda memvisualisasikan bagaimana indeks akan berfungsi di aplikasi klien, tetapi tidak ditujukan untuk skenario produksi. Aplikasi produksi harus mencakup keamanan, penanganan kesalahan, dan logika hosting yang tidak disediakan aplikasi demo.

Prasyarat

Sebelum Anda mulai, siapkan prasyarat berikut:

• Akun Azure dengan langganan aktif. Buat akun secara gratis.

• Azure AI layanan Pencarian. Buat layanan atau temukan layanan yang sudah ada dalam langganan Anda saat ini. Anda dapat menggunakan layanan gratis untuk mulai cepat ini.

• Microsoft Edge (versi terbaru) atau Google Chrome.

• Indeks pencarian untuk digunakan sebagai dasar aplikasi yang Anda buat.

  Mulai cepat ini menggunakan himpunan data sampel hotel bawaan. Untuk membuat indeks yang digunakan dalam latihan ini, jalankan wizard Impor data , pilih sumber sampel hotel dan terima semua default.

  

Saat indeks siap digunakan, lanjutkan ke langkah berikutnya.

Memulai wizard

1. Masuk ke portal Azure dengan akun Azure Anda dan temukan layanan pencarian Anda.

2. Di bawah Indeks Manajemen>Pencarian

3. Pilih hotels-sample-index.

4. Pada halaman indeks, di bagian atas, pilih Buat aplikasi demo untuk memulai wizard.

5. Pada halaman wizard pertama, pilih Aktifkan Cross Origin Resource Sharing (CORS) untuk menambahkan dukungan CORS ke definisi indeks Anda. Langkah ini bersifat opsional, tetapi aplikasi web lokal Anda tidak akan tersambung ke indeks jarak jauh tanpanya.

   

Mengonfigurasi hasil pencarian

Wizard ini menyediakan tata letak dasar untuk hasil pencarian yang dirender yang mencakup ruang untuk gambar mini, judul, dan deskripsi. Mendukung setiap elemen ini adalah bidang dalam indeks Anda yang menyediakan data.

1. Lewati Gambar Mini karena indeks ini tidak memiliki gambar, tetapi jika Anda memiliki bidang indeks yang diisi dengan URL yang mengatasi gambar yang tersedia untuk umum, Anda harus menentukan bidang tersebut untuk area gambar mini. Jika indeks Anda tidak memiliki URL gambar, biarkan bidang ini kosong.

2. Di Judul, pilih bidang yang menyampaikan keunikan setiap dokumen. Dalam sampel ini, Nama Hotel adalah pilihan yang wajar.

3. Di Deskripsi, pilih bidang yang menyediakan detail yang mungkin membantu seseorang memutuskan apakah akan menelusuri paling detail ke dokumen tertentu. Dalam sampel ini, Deskripsi adalah kandidat yang baik.

   

Menambahkan bilah sisi

Layanan pencarian mendukung navigasi tersaring, yang sering ditampilkan sebagai bilah sisi. Faset didasarkan pada bidang yang dapat difilter dan dapat difaset, seperti yang dinyatakan dalam skema indeks.

Di Azure AI Search, navigasi tersaring adalah pengalaman pemfilteran kumulatif. Dalam satu kategori, memilih beberapa filter memperluas hasilnya (misalnya, memilih Seattle dan Bellevue di dalam Kota). Di seluruh kategori, memilih beberapa filter mempersempit hasil.

1. Di wizard, pilih tab Bilah Sisi di bagian atas halaman. Anda akan melihat daftar semua bidang yang dikaitkan sebagai dapat difilter dan dapat difaset dalam indeks.

2. Hapus beberapa bidang untuk mempersingkat bilah samping sehingga Anda tidak memiliki gulir di aplikasi yang sudah selesai.

Menambahkan saran

Saran merujuk ke permintaan kueri otomatis yang dilampirkan ke kotak pencarian. Aplikasi demo mendukung saran yang menyediakan daftar dropdown dokumen potensial yang cocok berdasarkan input teks parsial.

Di halaman ini, pilih bidang yang kueri yang disarankan disediakan. Anda harus memilih bidang string yang lebih pendek. Hindari bidang verbose seperti deskripsi.

Cuplikan layar berikut menunjukkan halaman saran, disandingkan dengan halaman yang dirender di aplikasi. Anda dapat melihat bagaimana pilihan bidang digunakan, dan bagaimana "Tampilkan Nama Bidang" digunakan untuk menyertakan atau mengecualikan pelabelan dalam saran.

Membuat, mengunduh, dan menjalankan

1. Pilih Buat aplikasi demo di bagian bawah halaman untuk membuat file HTML.

2. Saat diminta, pilih Unduh aplikasi Anda untuk mengunduh file.

3. Buka file dan pilih tombol Cari . Tindakan ini mengeksekusi kueri, yang bisa berupa kueri kosong (*) yang mengembalikan kumpulan hasil arbitrer. Halaman tersebut akan terlihat seperti cuplikan layar berikut.

4. Masukkan istilah dan gunakan filter untuk mempersempit hasil. Jika Anda tidak melihat kueri yang disarankan, periksa pengaturan browser atau coba browser lain.

Membersihkan sumber daya

Saat bekerja dengan langganan Anda sendiri, sebaiknya identifikasi apakah Anda masih membutuhkan sumber daya yang Anda buat di akhir proyek. Sumber daya yang dibiarkan berjalan dapat menghabiskan uang Anda. Anda dapat menghapus sumber daya satu per satu atau menghapus grup sumber daya untuk menghapus seluruh rangkaian sumber daya.

Anda dapat menemukan dan mengelola sumber daya di portal Azure, menggunakan tautan Semua sumber daya atau Grup sumber daya di panel navigasi kiri.

Ingatlah bahwa layanan gratis terbatas pada tiga indeks, pengindeks, dan sumber data. Anda dapat menghapus item individual di portal Azure agar tetap di bawah batas.

Langkah berikutnya

Aplikasi demo berguna untuk prototyping karena Anda dapat mensimulasikan pengalaman pengguna akhir tanpa harus menulis JavaScript atau kode ujung depan, tetapi ketika Anda semakin dekat dengan pembuktian konsep dalam proyek Anda sendiri, tinjau salah satu sampel kode ujung-ke-ujung yang lebih dekat faksimili aplikasi kata nyata: