Azure Yapay Zeka Arama'te sorgulama

Not

Azure Yapay Zeka Arama Azure portalı, REST API'leri ve Azure SDK’ları aracılığıyla kullanılabilir. Ayrıca kuruluş içeriğini Microsoft Foundry portalındaki aracılar için yeniden kullanılabilir, izin kullanan bilgi bankalarına dönüştüren yönetilen bilgi katmanı Foundry IQ'yu temel alır.

Azure Yapay Zeka Arama, serbest biçimli metin aramasından yüksek oranda belirtilen sorgu desenlerine ve vektör aramasına kadar çok çeşitli senaryolar için sorgu yapılarını destekler. Tüm sorgular, aranabilir içeriği depolayan bir arama dizini üzerinden yürütülür.

Sorgu türleri

Sorgu formu Aranabilir içerik Açıklama
Tam metin arama Belirteçli terimlerin ters dizinleri. Tam metin sorguları, hızlı taramalar için yapılandırılmış ters dizinler üzerinde yinelenir ve burada herhangi bir alanda, herhangi bir sayıda arama belgesi içinde eşleşme bulunabilir. Metin, tam metin araması için analiz edilir ve belirteç haline getirilir.
Vektör araması Oluşturulan eklemelerin vektör dizinleri. Vektör sorguları, arama dizinindeki vektör alanları üzerinde yinelenir.
Karma arama Yukarıdakilerin tümü tek bir arama dizininde. Metin arama ve vektör aramalarını tek bir sorgu isteğinde birleştirir. Metin araması, aranabilir alanlardaki düz metin içeriğinde çalışır. Filtreler filtrelenebilir alanlara uygulanır. Vektör araması vektör alanlarında çalışır.
Ajanssal geri çağırma Yukarıdakilerin tümü tek bir arama dizininde. Bu, Azure Yapay Zeka Arama üzerinde isteğe bağlı olarak sorgu planlaması (önizleme) için büyük dil modelleri kullanan alternatif bir alma yoludur. Yanıt, arama uygulaması istemci kodu yerine kullanıcıya teslim edilen yanıtı koordine eden aracı tüketimi için tasarlanmıştır.
Diğer Düz metin ve insan tarafından okunabilen içerik. Kaynak belgelerden aynen çıkarılan ham içerik, coğrafi uzamsal arama, benzer arama ve alanlı arama gibi filtreleri ve desen eşleştirme sorgularını destekler.

Bu makalenin geri kalanı, odağı son kategoriye getirir: düz metin ve özgün kaynaktan bozulmadan ayıklanan, filtreler ve diğer özel sorgu formları için kullanılan, insan tarafından okunabilir içerik üzerinde çalışan klasik sorgular. Yapay zeka kullanmayan geleneksel bir arama uygulaması oluşturuyorsanız, bu bölümde istemci kodunuzda uygulayabileceğiniz sorgu yöntemleri açıklanmaktadır.

Otomatik tamamlama ve önerilen sorgular

Otomatik tamamlama veya önerilen sonuçlar, yazarken ara deneyiminde, kısmi metin girişlerine (her karakterden sonra) göre ardışık sorgu isteklerini tetikleyen search için alternatiflerdir. autocomplete ve suggestions parametrelerini bu kılavuzda açıklandığı gibi birlikte veya ayrı ayrı kullanabilirsiniz, ancak search ile kullanamazsınız. Hem tamamlanmış terimler hem de önerilen sorgular dizin içeriklerinden türetilir. Motor, dizininde var olmayan bir metin dizesi veya öneri asla döndürmez. Daha fazla bilgi için bkz . Otomatik Tamamlama (REST API) ve Öneriler (REST API).

Filtreler, Azure Yapay Zeka Arama'e dayalı uygulamalarda yaygın olarak kullanılır. Uygulama sayfalarında filtreler genellikle kullanıcı tarafından yönlendirilen filtreleme için bağlantı gezinti yapılarına fasetler şeklinde görselleştirilir. Filtreler, dizine alınan içerik dilimlerini kullanıma açmak için dahili olarak da kullanılır. Örneğin, bir ürün kategorisinde filtre kullanarak veya dizin hem İngilizce hem de Fransızca alanlar içeriyorsa bir dil kullanarak bir arama sayfası başlatabilirsiniz.

Ayrıca, aşağıdaki tabloda açıklandığı gibi özelleştirilmiş bir sorgu formunu çağırmak için filtrelere de ihtiyacınız olabilir. Belirtilmemiş bir aramayla (search=*) veya terimler, tümcecikler, işleçler ve desenler içeren bir sorgu dizesiyle filtre kullanabilirsiniz.

Filtre senaryosu Açıklama
Aralık filtreleri Azure Yapay Zeka Arama'de, aralık sorguları parametresi kullanılarak filter oluşturulur. Daha fazla bilgi ve örnek için bkz. Aralık filtresi örneği.
Çok yönlü gezinme Fasetli gezinti ağacında kullanıcılar fasetleri seçebilir. Filtreler tarafından desteklendiğinde, arama sonuçları her tıklamada daraltılır. Her bir özellik, o özellik tarafından sağlanan ölçütlerle artık eşleşmeyen belgeleri dışlayan bir filtreyle desteklenir.

Not

Bir filtre ifadesinde kullanılan metin, sorgu işleme sırasında çözümlenmez. Metin girişinin, eşleşmede başarılı veya başarısız olan büyük/küçük harfe duyarlı bir karakter deseni olduğu varsayılır. Filtre ifadeleri OData söz dizimi kullanılarak oluşturulur ve dizininizdeki tüm filter içerisinde bir parametresine geçirilir. Daha fazla bilgi için bkz . Azure Yapay Zeka Arama'te filtreler.

Jeo-uzamsal arama, bir konumun enlem ve boylam koordinatlarına göre "yakınımda bul" veya harita tabanlı arama deneyimi sağlamak için eşleşir. Azure Yapay Zeka Arama'te şu adımları izleyerek jeo-uzamsal arama uygulayabilirsiniz:

  1. Edm.GeographyPoint veya Collection(Edm.GeographyPoint) türünde filtrelenebilir bir alan tanımlayın.
  2. Gelen belgelerin uygun koordinatları içerdiğini doğrulayın.
  3. Dizin oluşturma tamamlandıktan sonra, filtre ve coğrafi uzamsal işlev kullanan bir sorgu oluşturun.

Jeo-uzamsal arama mesafe için kilometre kullanır. Koordinatlar şu biçimde belirtilir: (longitude, latitude).

Jeo-uzamsal arama için bir filtre örneği aşağıda verilmiştir. Bu filtre, arama dizininde coğrafya noktasının 300 kilometre yarıçapı içinde koordinatları olan diğer Location alanları bulur (bu örnekte, Washington D.C.). Sonuçta adres bilgilerini döndürür ve konuma göre kendi kendine gezinti için isteğe bağlı facets bir yan tümcesi içerir.

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
}

Daha fazla bilgi ve örnek için bkz . Jeo-uzamsal arama örneği.

Belge arama

Daha önce açıklanan sorgu formlarının aksine, bu, karşılık gelen dizin araması veya taraması olmadan kimlikle tek bir arama belgesi alır. Yalnızca bir belge istenir ve döndürülür. Kullanıcı arama sonuçlarında bir öğe seçtiğinde, belgeyi almak ve alanlarla bir ayrıntılar sayfası oluşturmak tipik bir yanıttır ve belge araması bunu destekleyen işlemdir.

Gelişmiş arama: belirsiz, joker karakter, yakınlık, regex

Gelişmiş sorgu formu, Tam Lucene ayrıştırıcısı ve belirli bir sorgu davranışını tetikleyen işleçlere bağlıdır.

Sorgu türü Kullanım Örnekler ve daha fazla bilgi
Alanlı arama search parametre queryType=full Tek bir alanı hedefleyen bileşik bir sorgu ifadesi oluşturun.
Alanlı arama örneği
Benzer arama search parametre queryType=full Terimleri benzer yapıdaki veya yazılıştaki olanlarla eşleştirin.
Benzer arama örneği
Yakınlık araması search parametre queryType=full Belgede birbirine yakın terimleri bulun.
Yakınlık arama örneği
Terim öne çıkarma search parametre queryType=full Güçlendirilmiş terimi içeren bir belgeyi, içermeyen diğer belgelere kıyasla daha üst sıralarda konumlandır.
Terim önem derecesini artırma örneği
Normal ifade araması search parametre queryType=full Normal ifadenin içeriğine göre eşleştirin.
Normal ifade örneği
Joker karakter veya ön ek araması ? veya * içeren search parametresi, queryType=full Bir ön eke, birden çok karaktere () veya bir karaktere (*?) göre eşleştirin.
Genel karakter arama örneği

Sonraki adımlar

Sorgu uygulamasına daha yakından bakmak için her söz dizimi için örnekleri gözden geçirin. Tam metin arama konusunda yeniyseniz, sorgu altyapısının ne yaptığı hakkında daha fazla bilgi edinmek isteyebilirsiniz.

  • Son güncelleştirme: