Mulai cepat: Menggunakan Penjelajah pencarian untuk menjalankan kueri di portal Azure

Dalam panduan mulai cepat ini, Anda belajar cara menggunakan Penjelajah pencarian, alat kueri bawaan di Azure portal untuk menjalankan kueri terhadap indeks Pencarian Azure AI. Gunakan alat ini untuk menguji kueri atau ekspresi filter atau untuk mengonfirmasi apakah konten ada dalam indeks.

Mulai cepat ini menggunakan indeks yang ada untuk menunjukkan Penjelajah pencarian.

Prasyarat

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

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

• Panduan cepat ini menggunakan indeks hotel sampel. Ikuti instruksi dalam mulai cepat ini untuk membuat indeks.

Memulai penjelajah Pencarian

1. Masuk ke portal Microsoft Azure dan pilih layanan pencarian Anda.

2. Dari panel kiri, pilih Gambaran Umum.

3. Pada bilah perintah, pilih Penjelajah pencarian.

   

   Atau, pilih tab Penjelajah pencarian di halaman indeks.

Kueri tiga cara

Ada tiga pendekatan untuk mengkueri di Penjelajah pencarian:

• Tampilan kueri menyediakan bilah pencarian default. Ini menerima kueri kosong atau kueri teks bebas dengan Booleans, seperti ocean view + parking.

• Tampilan gambar menyediakan jendela untuk menelusuri atau menyeret dan meletakkan file PNG, JPG, atau JPEG. Kecuali indeks Anda memiliki vektorizer gambar dan keterampilan yang setara, tampilan ini tidak tersedia.

• Tampilan JSON mendukung kueri berparameter. Filter, orderby, select, count, searchFields, dan semua parameter lainnya harus diatur dalam tampilan JSON.

  

Contoh: Kueri gambar

Penjelajah menerima gambar sebagai input kueri melalui tampilan gambar, yang memerlukan Anda menggunakan pasangan vektorizer–kemampuan yang didukung. Untuk informasi selengkapnya, lihat Mengonfigurasi vektorizer dalam indeks pencarian.

Indeks sampel hotel tidak dikonfigurasi untuk vektorisasi gambar. Jika Anda ingin menjalankan kueri gambar, buat indeks seperti yang dijelaskan dalam Mulai Cepat: Pencarian vektor di portal Microsoft Azure. Panduan cepat menggunakan data sampel dari teks, jadi Anda perlu menggunakan dokumen dengan gambar.

Untuk menjalankan kueri gambar, pilih atau seret gambar ke area pencarian, lalu pilih Cari. Penjelajah pencarian membuat vektor gambar dan mengirim vektor ke mesin pencari untuk eksekusi kueri. Mesin pencari mengembalikan dokumen yang cukup mirip dengan gambar input, hingga jumlah hasil yang ditentukan k .

Contoh: Kueri JSON

Berikut ini adalah contoh kueri JSON yang bisa Anda jalankan menggunakan Penjelajah pencarian. Untuk mengikuti contoh ini, beralihlah ke tampilan JSON. Anda dapat menempelkan setiap contoh JSON ke area teks.

Petunjuk / Saran

Tampilan JSON mendukung intellisense untuk penyelesaian nama parameter. Letakkan kursor Anda di dalam tampilan JSON dan masukkan karakter spasi untuk melihat daftar semua parameter kueri. Anda juga dapat memasukkan huruf, seperti s, untuk melihat hanya parameter kueri yang dimulai dengan huruf tersebut.

Intellisense tidak mengecualikan parameter yang tidak valid, jadi gunakan penilaian terbaik Anda.

Menjalankan kueri yang tidak ditentukan

Di Eksplorasi Pencarian, permintaan POST dirumuskan secara internal menggunakan Dokumen - Pencarian Post (REST API), dengan respons dikembalikan dalam bentuk dokumen JSON yang terperinci.

Untuk melihat konten terlebih dahulu, jalankan pencarian kosong dengan memilih Cari tanpa istilah yang disediakan. Pencarian kosong berguna sebagai kueri pertama karena mengembalikan seluruh dokumen sehingga Anda bisa meninjau komposisi dokumen. Pada pencarian kosong, tidak ada skor pencarian, dan dokumen dikembalikan dalam urutan arbitrer ("@search.score": 1 untuk semua dokumen). Secara default, 50 dokumen dikembalikan per permintaan pencarian.

Tambahkan "count": true untuk mendapatkan jumlah kecocokan yang ditemukan dalam indeks. Pada pencarian kosong, jumlahnya adalah jumlah total dokumen dalam indeks. Pada pencarian yang memenuhi syarat, ini adalah jumlah dokumen yang cocok dengan input kueri. Ingat bahwa layanan mengembalikan 50 kecocokan teratas secara default, sehingga jumlahnya mungkin menunjukkan lebih banyak kecocokan dalam indeks daripada yang dikembalikan dalam hasil.

Sintaks yang setara untuk pencarian kosong adalah * atau "search": "*".

{
   "search": "*",
   "count": true
}

Hasil

Menjalankan kueri teks bebas

Pencarian bentuk bebas, dengan atau tanpa operator, berguna untuk mensimulasikan kueri yang ditentukan pengguna yang dikirim dari aplikasi kustom ke Azure AI Search. Hanya bidang yang dikaitkan sebagai dapat dicari dalam indeks yang dipindai untuk kecocokan.

Anda tidak memerlukan tampilan JSON untuk kueri teks bebas, tetapi kami menyediakannya di JSON untuk konsistensi dengan contoh lain dalam artikel ini.

Perhatikan bahwa saat Anda memberikan kriteria pencarian, seperti istilah atau ekspresi kueri, peringkat pencarian akan diputar. Contoh berikut mengilustrasikan pencarian teks gratis. @search.score adalah skor relevansi yang dihitung untuk kecocokan menggunakan algoritma penilaian default.

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast"
}

Hasil

Anda bisa menggunakan Ctrl-F untuk mencari dalam hasil untuk persyaratan minat tertentu.

Membatasi bidang dalam hasil pencarian

Tambahkan "select" untuk membatasi hasil ke bidang bernama secara eksplisit untuk output yang lebih mudah dibaca di Penjelajah pencarian. Hanya bidang yang ditandai sebagai dapat diambil dalam indeks yang bisa muncul dalam hasil.

{
   "search": "activities `outdoor pool` restaurant OR continental breakfast",
   "count": true,
   "select": "HotelId, HotelName, Tags, Description"
}

Hasil

Mengembalikan batch hasil berikutnya

Azure AI Search mengembalikan 50 kecocokan teratas berdasarkan peringkat pencarian. Indeks sampel hotel hanya memiliki 50 hotel, jadi kami menggunakan jumlah yang lebih kecil untuk mengilustrasikan paginasi. Untuk mendapatkan kumpulan dokumen pencocokan berikutnya, tambahkan "top": 20 dan "skip": 10 untuk meningkatkan hasil yang diatur ke 20 dokumen (defaultnya adalah 50, maksimum adalah 1000), melewati 10 dokumen pertama. Anda dapat memeriksa kunci dokumen (HotelId) untuk mengidentifikasi dokumen.

Ingat bahwa Anda perlu menyediakan kriteria pencarian, seperti istilah atau ekspresi kueri, untuk mendapatkan hasil peringkat. Skor pencarian menurun semakin dalam Anda menjelajah hasil pencarian.

{
   "search": "activities `outdoor pool` restaurant OR continental breakfast",
   "count": true,
   "select": "HotelId, HotelName, Tags, Description",
   "top": 20,
   "skip": 10
}

Hasil

Filter ekspresi (lebih besar dari, kurang dari, sama dengan)

filter Gunakan parameter untuk menentukan kriteria penyertaan atau pengecualian. Bidang harus dikaitkan sebagai dapat difilter dalam indeks. Contoh ini mencari peringkat yang lebih besar dari empat:

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast",
    "count": true,
    "select": "HotelId, HotelName, Tags, Description, Rating",
    "filter": "Rating gt 4"
}

Hasil

Urukan hasil

Tambahkan orderby untuk mengurutkan hasil menurut bidang lain selain skor pencarian. Bidang harus dikaitkan sebagai dapat diurutkan dalam indeks. Dalam situasi di mana nilai yang difilter identik (misalnya, harga yang sama), urutannya seketika, tetapi Anda dapat menambahkan lebih banyak kriteria untuk pengurutan yang lebih dalam. Berikut adalah contoh ekspresi yang dapat Anda gunakan untuk menguji hal ini:

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast",
    "count": true,
    "select": "HotelId, HotelName, Tags, Description, Rating, LastRenovationDate",
    "filter": "Rating gt 4",
    "orderby": "LastRenovationDate desc"
}

Hasil

Poin-poin penting

Dalam mulai cepat ini, Anda menggunakan Search explorer untuk mengkueri indeks menggunakan REST API.

• Hasil dikembalikan sebagai dokumen JSON verbose sehingga Anda dapat melihat konstruksi dan konten setiap dokumen secara keseluruhan. Parameter select dalam ekspresi kueri membatasi bidang mana yang dikembalikan.

• Hasil pencarian terdiri dari semua bidang yang ditandai dapat diakses dalam indeks. Pilih tab Bidang untuk meninjau atribut.

• Pencarian kata kunci, mirip dengan apa yang mungkin Anda masukkan di browser web komersial, berguna untuk menguji pengalaman pengguna akhir. Misalnya, dengan asumsi indeks sampel hotel, Anda dapat memasukkan "activities 'outdoor pool' restaurant OR continental breakfast", lalu Anda dapat menggunakan Ctrl-F untuk menemukan istilah dalam hasil pencarian.

• Ekspresi kueri dan filter diartikulasikan dalam sintaks yang diimplementasikan oleh Azure AI Search. Defaultnya adalah sintaks sederhana, tetapi Anda dapat secara opsional menggunakan full Lucene untuk kueri yang lebih kuat. Ekspresi filter diartikulasikan dalam sintaks OData.

Membersihkan sumber daya

Saat Anda bekerja di langganan Anda sendiri, ada baiknya untuk menyelesaikan proyek dengan menghapus sumber daya yang tidak lagi Anda butuhkan. Sumber daya yang dibiarkan berjalan dapat dikenakan biaya.

Di portal Microsoft Azure, pilih Semua sumber daya atau Grup sumber daya dari panel kiri untuk menemukan dan mengelola sumber daya. Anda dapat menghapus sumber daya satu per satu atau menghapus grup sumber daya untuk menghapus semua sumber daya sekaligus.

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

Langkah selanjutnya

Untuk mempelajari selengkapnya tentang struktur dan sintaks kueri, gunakan klien REST untuk membuat ekspresi kueri yang menggunakan lebih banyak bagian dari REST API. Dokumen - Pos Pencarian (REST API) sangat membantu untuk pembelajaran dan eksplorasi.

Mulai cepat: Pencarian teks lengkap