Mengkueri di Pencarian Azure AI

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.

Pencarian Azure AI mendukung konstruksi kueri untuk berbagai skenario, dari pencarian teks bentuk bebas, hingga pola kueri yang sangat ditentukan, hingga pencarian vektor. Semua kueri dijalankan melalui indeks pencarian yang menyimpan konten yang dapat dicari.

Jenis kueri

Formulir kueri Konten yang dapat dicari Deskripsi
Pencarian teks lengkap Indeks terbalik dari istilah yang ditokenisasi. Kueri teks penuh menelusuri indeks terbalik yang distrukturkan untuk pemindaian cepat, di mana kecocokan berpotensi ditemukan di bidang mana pun, dalam berapa pun jumlah dokumen penelusuran. Teks dianalisis dan ditokenisasi untuk pencarian teks lengkap.
Pencarian vektor Indeks vektor dari embedding yang dihasilkan. Kueri vektor berulang melalui bidang vektor dalam indeks pencarian.
Pencarian hibrid Semua hal di atas dalam satu indeks pencarian. Menggabungkan pencarian teks dan pencarian vektor dalam satu permintaan kueri. Pencarian teks berfungsi pada konten teks biasa di bidang yang dapat dicari. Filter berlaku untuk bidang yang dapat difilter. Pencarian vektor berfungsi pada bidang vektor.
Penelusuran berbasis agen Semua hal di atas dalam satu indeks pencarian. Ini adalah jalur pengambilan data alternatif di Pencarian Azure AI yang opsional menggunakan model bahasa besar untuk perencanaan kueri (pratinjau). Respon ini didesain untuk digunakan oleh agen, di mana agen, dibandingkan dengan kode klien dari aplikasi pencarian, mengoordinasikan respons yang dikirimkan kepada pengguna.
Lainnya Teks biasa dan konten yang dapat dibaca manusia. Konten mentah, yang diekstraksi secara kata demi kata dari dokumen sumber, mendukung filter dan kueri untuk pencocokan pola seperti pencarian geo-spasial, pencarian melalui fuzzy, dan pencarian melalui bidang.

Sisa artikel ini membawa fokus ke kategori terakhir: kueri klasik yang bekerja pada teks biasa dan konten yang dapat dibaca manusia, diekstrak utuh dari sumber asli, digunakan untuk filter dan formulir kueri khusus lainnya. Jika Anda membuat aplikasi pencarian tradisional yang tidak menggunakan AI, bagian ini menjelaskan metode kueri yang dapat Anda terapkan dalam kode klien Anda.

Pelengkapan otomatis dan sugesti kueri

Pelengkapan otomatis atau hasil yang disarankan adalah alternatif untuk memicu permintaan search kueri berturut-turut berdasarkan input string parsial (setelah setiap karakter) dalam pengalaman pencarian sesuai tipe Anda. Anda dapat menggunakan autocomplete parameter dan suggestions bersama-sama atau secara terpisah, seperti yang dijelaskan dalam panduan ini, tetapi Anda tidak dapat menggunakannya dengan search. Istilah yang telah diselesaikan dan kueri yang disarankan berasal dari konten indeks. Mesin tidak pernah mengembalikan string atau saran yang tidak ada dalam indeks Anda. Untuk informasi selengkapnya, lihat Pelengkapan otomatis (REST API) dan Saran (REST API).

Filter banyak digunakan dalam aplikasi yang didasarkan pada Pencarian Azure AI. Pada halaman aplikasi, filter sering divisualisasikan sebagai aspek dalam struktur navigasi tautan untuk pemfilteran yang diarahkan pengguna. Filter juga digunakan secara internal untuk mengekspos potongan konten terindeks. Misalnya, Anda dapat menginisialisasi halaman pencarian menggunakan filter pada kategori produk, atau bahasa jika indeks berisi bidang dalam bahasa Inggris dan Prancis.

Anda mungkin juga memerlukan filter untuk memanggil formulir kueri khusus, seperti yang diuraikan dalam tabel berikut ini. Anda bisa menggunakan filter dengan pencarian yang tidak ditentukan (search=*) atau dengan string kueri yang menyertakan istilah, frasa, operator, dan pola.

Skenario Penyaringan Deskripsi
Filter batasan rentang Dalam Pencarian Azure AI, kueri rentang dibuat menggunakan filter parameter . Untuk informasi dan contoh selengkapnya, lihat Contoh filter rentang.
Navigasi tersaring Di pohon navigasi faceted, pengguna dapat memilih facet. Saat didukung oleh filter, hasil pencarian dipersempit pada setiap klik. Setiap aspek didukung oleh filter yang mengecualikan dokumen yang tidak lagi cocok dengan kriteria yang ditentukan oleh aspek tersebut.

Catatan

Teks yang digunakan dalam ekspresi filter tidak dianalisis selama pemrosesan kueri. Input teks dianggap sebagai pola karakter peka huruf besar/kecil verbatim yang berhasil atau gagal pada pertandingan. Ekspresi filter dibuat menggunakan sintaks OData dan dilewatkan dalam parameter di filter semua bidang yang dapat difilter dalam indeks Anda. Untuk informasi selengkapnya, lihat Filter di Pencarian Azure AI.

Pencarian geospasial cocok pada koordinat lintang dan bujur lokasi untuk "temukan di dekat saya" atau pengalaman pencarian berbasis peta. Di Pencarian Azure AI, Anda dapat menerapkan pencarian geospasial dengan mengikuti langkah-langkah berikut:

  1. Tentukan bidang tipe Edm.GeographyPoint atau Collection yang dapat difilter(Edm.GeographyPoint).
  2. Verifikasi dokumen masuk menyertakan koordinat yang sesuai.
  3. Setelah pengindeksan selesai, buat kueri yang menggunakan filter dan fungsi geo-spasial.

Pencarian geospasial menggunakan kilometer untuk jarak. Koordinat ditentukan dalam format ini: (longitude, latitude).

Berikut adalah contoh filter untuk pencarian geospasial. Filter ini menemukan bidang lain Location dalam indeks pencarian yang memiliki koordinat dalam radius 300 kilometer dari titik geografi (dalam contoh ini, Washington D.C.). Ini mengembalikan informasi alamat dalam hasil, dan menyertakan klausul opsional facets untuk navigasi mandiri berdasarkan lokasi.

POST https://{{searchServiceName}}.search.windows.net/indexes/hotels-vector-quickstart/docs/search?api-version=2026-04-01
{
    "count": true,
    "search": "*",
    "filter": "geo.distance(Location, geography'POINT(-77.03241 38.90166)') le 300",
    "facets": [ "Address/StateProvince"],
    "select": "HotelId, HotelName, Address/StreetAddress, Address/City, Address/StateProvince",
    "top": 7
}

Untuk informasi dan contoh selengkapnya, lihat Contoh pencarian geospasial.

Pencarian dokumen

Berbeda dengan formulir kueri yang dijelaskan sebelumnya, yang ini mengambil satu dokumen pencarian berdasarkan ID, tanpa pencarian atau pemindaian indeks yang sesuai. Hanya satu dokumen yang diminta dan dikembalikan. Saat pengguna memilih item di hasil pencarian, mengambil dokumen dan mengisi halaman detail dengan bidang adalah respons umum, dan pencarian dokumen adalah operasi yang mendukungnya.

Pencarian lanjutan: fuzzy, wildcard, proksimitas, regex

Formulir kueri tingkat lanjut bergantung pada pengurai Lucene penuh dan operator yang memicu perilaku kueri tertentu.

Jenis kueri Penggunaan Contoh dan informasi selengkapnya
Pencarian berdasarkan bidang search Parameter, queryType=full Bangun ekspresi kueri komposit yang menargetkan satu bidang.
Contoh pencarian lapangan
Pencarian fuzzy search Parameter, queryType=full Cocokkan istilah dengan konstruksi atau ejaan serupa.
Contoh pencarian fuzzy
Pencarian kedekatan search Parameter, queryType=full Temukan istilah yang berdekatan dalam dokumen.
Contoh pencarian terdekat
Peningkatan relevansi istilah search Parameter, queryType=full Beri peringkat lebih tinggi pada dokumen jika dokumen tersebut mengandung istilah yang ditingkatkan bobotnya, dibandingkan dokumen lain yang tidak mengandungnya.
Contoh penguatan istilah
Pencarian ekspresi reguler search Parameter, queryType=full Cocokkan berdasarkan konten ekspresi reguler.
Contoh ekspresi reguler
Pencarian karakter pengganti atau prefiks search parameter dengan * atau ?, queryType=full Cocokkan berdasarkan awalan, beberapa karakter (*), atau satu karakter (?).
Contoh pencarian wildcard

Langkah berikutnya

Untuk melihat lebih dekat implementasi kueri, tinjau contoh untuk setiap sintaks. Jika Anda baru menggunakan pencarian teks lengkap, Anda mungkin juga ingin mempelajari selengkapnya tentang apa yang dilakukan mesin kueri.

  • Terakhir diperbarui pada