Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Note
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.
Bu hızlı başlangıçta, Azure Yapay Zeka Arama dizininde sorgu çalıştırmak için Azure portalındaki yerleşik sorgu aracı Search explorer kullanmayı öğreneceksiniz. Bir sorguyu veya filtre ifadesini test etmek veya içeriğin dizinde mevcut olup olmadığını onaylamak için bu aracı kullanın.
Bu hızlı başlangıçta, Arama gezginini göstermek için mevcut bir dizin kullanılır.
Önkoşullar
Etkin aboneliği olan bir Azure hesabı. Ücretsiz bir hesap oluşturun.
bir Azure Yapay Zeka Arama hizmeti. Hİzmet oluşturma veya geçerli aboneliğinizde var olan bir hizmeti belirleyin. Bu hızlı başlangıç için ücretsiz bir hizmet kullanabilirsiniz.
Bu hızlı başlangıçta hotels-sample dizini kullanılmaktadır. Dizini oluşturmak için bu hızlı başlangıçtaki yönergeleri izleyin.
Arama gezginini başlatma
Azure portalında arama hizmetinize gidin.
Sol bölmeden Genel Bakış'ı seçin.
Komut çubuğunda Arama gezgini'ni seçin.
Alternatif olarak, dizin sayfasındaki Arama gezgini sekmesini seçin.
Üç yolla sorgula
Arama gezgininde sorgulamaya yönelik üç yaklaşım vardır:
Sorgu görünümü varsayılan bir arama çubuğu sağlar. Boş bir sorguyu veya Boole mantık operatörleriyle birlikte bir serbest metin sorgusunu, örneğin
ocean view + parking, kabul eder.Resim görünümü PNG, JPG veya JPEG dosyalarına göz atmak veya dosyaları sürükleyip bırakmak için bir pencere sağlar. Dizininizde görüntü vektörleştiricisi ve eşdeğer bir beceri yoksa, bu görünüm kullanılamaz.
JSON görünümü parametreli sorguları destekler. Filtreler, orderby, select, count, searchFields ve diğer tüm parametreler JSON görünümünde ayarlanmalıdır.
Örnek: Görüntü sorgusu
Arama gezgini görüntüleri Görüntü görünümü aracılığıyla sorgu girişi olarak kabul eder ve bu, desteklenen bir vektörleştirici-beceri çifti kullanmanızı gerektirir. Daha fazla bilgi için bkz. Arama dizininde vektörleştirici yapılandırma.
Hotels-sample dizini görüntü vektörleştirme için yapılandırılmamış. Görüntü sorguları çalıştırmak istiyorsanız Quickstart: Azure portalında vektör araması'da açıklandığı gibi bir dizin oluşturun. Hızlı başlangıçta metin tabanlı örnek veriler kullanılır, bu nedenle resim içeren belgeleri kullanmanız gerekir.
Görüntü sorgusu çalıştırmak için, bir görüntüyü seçin veya arama alanına sürükleyin ve ardından Ara'yı seçin. Arama gezgini görüntüyü vektörleştirir ve sorgu yürütmesi için vektöri arama altyapısına gönderir. Arama altyapısı, belirtilen k sonuç sayısına kadar giriş görüntüsüne yeterince benzeyen belgeler döndürür.
Örnekler: JSON sorguları
Aşağıda, Arama gezginini kullanarak çalıştırabileceğiniz JSON sorgularının örnekleri verilmiştir. Bu örnekleri izlemek için JSON görünümüne geçin. Her JSON örneğini metin alanına yapıştırabilirsiniz.
Ipucu
JSON görünümü, parametre adı tamamlama için intellisense'i destekler. İmlecinizi JSON görünümünün içine getirin ve tüm sorgu parametrelerinin listesini görmek için bir boşluk karakteri girin. Ayrıca, yalnızca bu harfle başlayan sorgu parametrelerini görmek için gibi sbir harf de girebilirsiniz.
IntelliSense geçersiz parametreleri dışlamaz, bu nedenle en iyi kararınızı kullanın.
Belirtilmemiş sorgu çalıştırma
Arama gezgininde, POST istekleri belgeler - Arama Gönderisi (REST API) kullanılarak dahili olarak formüle edilir ve yanıtlar ayrıntılı JSON belgeleri olarak döndürülür.
İçeriğe ilk kez bakmak için Terim sağlanmadan ara'yı seçerek boş bir arama yürütebilirsiniz. Boş bir arama ilk sorgu olarak kullanışlıdır çünkü belge oluşturmayı gözden geçirebilmeniz için belgelerin tamamını döndürür. Boş bir aramada arama puanı yoktur ve belgeler rastgele sırayla döndürülür ("@search.score": 1 tüm belgeler için). Varsayılan olarak, arama isteği başına 50 belge döndürülür.
Dizinde bulunan eşleşme sayısını almak için ekleyin "count": true . Boş bir aramada sayı, dizindeki toplam belge sayısıdır. Nitelikli bir aramada, sorgu girişiyle eşleşen belge sayısıdır. Hizmetin varsayılan olarak ilk 50 eşleşmeyi döndürdüğünü, dolayısıyla sayının dizinde sonuçlarda döndürülenden daha fazla eşleşme gösterebileceğini hatırlayın.
Boş bir arama için eşdeğer söz dizimi * veya "search": "*" şeklindedir.
{
"search": "*",
"count": true
}
Sonuç -ları
Serbest metin sorgusu çalıştırma
İşleçleri olan veya olmayan serbest biçimli arama, özel bir uygulamadan Azure Yapay Zeka Arama gönderilen kullanıcı tanımlı sorguların benzetimini yapmak için kullanışlıdır. Yalnızca dizinde aranabilir olarak özniteliklendirilen alanlar eşleşmeler için taranır.
Serbest metin sorgusu için JSON görünümüne ihtiyacınız yoktur, ancak bu makaledeki diğer örneklerle tutarlılık sağlamak için bunu JSON'da sağlarız.
Sorgu terimleri veya ifadeler gibi arama ölçütlerini sağladığınızda arama sıralamasının devreye girdiğine dikkat edin. Aşağıdaki örnekte serbest metin araması gösterilmektedir.
@search.score, varsayılan puanlama algoritması kullanılarak eşleşme için hesaplanan bir ilgi puanıdır.
{
"search": "activities `outdoor pool` restaurant OR continental breakfast"
}
Sonuç -ları
Ctrl-F kullanarak sonuçlarda belirli ilgi çekici terimleri arayabilirsiniz.
Arama sonuçlarında alanları sınırlama
"select" daha okunabilir bir çıktı elde etmek için sonuçları açıkça adlandırılmış alanlarla sınırlamak için ekleyin. Yalnızca dizinde alınabilir olarak özniteliklendirilen alanlar sonuçlarda gösterilebilir.
{
"search": "activities `outdoor pool` restaurant OR continental breakfast",
"count": true,
"select": "HotelId, HotelName, Tags, Description"
}
Sonuç -ları
Sonraki sonuç kümesini getir
Azure Yapay Zeka Arama, arama sıralamasına göre ilk 50 eşleşmeyi döndürür. Oteller-örnek dizininde yalnızca 50 otel vardır, bu nedenle sayfalamayı göstermek için daha az sayıda otel kullanırız. Sonraki eşleşen belge kümesini almak için, ilk 10 belgeyi atlayarak sonuç kümesine "top": 20 ve "skip": 10 ekleyin ve belge sayısını 20'ye çıkarın (varsayılan 50, maksimum 1000). Belgeyi tanımlamak için belge anahtarını (HotelId) de kontrol edebilirsiniz.
Dereceli sonuçlar elde etmek için sorgu terimi veya ifade gibi arama ölçütleri sağlamanız gerektiğini unutmayın. Arama puanları, arama sonuçlarına ulaştığınız kadar derine iner.
{
"search": "activities `outdoor pool` restaurant OR continental breakfast",
"count": true,
"select": "HotelId, HotelName, Tags, Description",
"top": 20,
"skip": 10
}
Sonuç -ları
Filtre ifadeleri (büyüktür, küçüktür, eşittir)
filter Ekleme veya dışlama ölçütlerini belirtmek için parametresini kullanın. Alan, dizinde filtrelenebilir olarak ilişkilendirilmelidir. Bu örnekte dörtten büyük derecelendirmeler aranmaktadır:
{
"search": "activities `outdoor pool` restaurant OR continental breakfast",
"count": true,
"select": "HotelId, HotelName, Tags, Description, Rating",
"filter": "Rating gt 4"
}
Sonuç -ları
Sonuçları sıralama
Sonuçları arama puanının yanı sıra başka bir alana göre sıralamak için ekleyin orderby . Alan dizinde sıralanabilir olarak ilişkilendirilmelidir. Filtrelenen değerin aynı olduğu durumlarda (örneğin, aynı fiyat), sıra rastgeledir, ancak daha derin sıralama için daha fazla ölçüt ekleyebilirsiniz. Bunu test etmek için kullanabileceğiniz örnek bir ifade aşağıda verilmişti:
{
"search": "activities `outdoor pool` restaurant OR continental breakfast",
"count": true,
"select": "HotelId, HotelName, Tags, Description, Rating, LastRenovationDate",
"filter": "Rating gt 4",
"orderby": "LastRenovationDate desc"
}
Sonuç -ları
Çıkarımlar
Bu hızlı başlangıçta, REST API kullanarak bir dizini sorgulamak için Arama gezginini kullandınız.
Sonuçlar ayrıntılı JSON belgeleri olarak döndürülür, böylece her belgenin yapımını ve içeriğini bütün olarak görüntüleyebilirsiniz. Sorgu
selectifadesindeki parametresi hangi alanların döndürülür olduğunu sınırlar.Arama sonuçları, dizinde alınabilir olarak özniteliklendirilen tüm alanlardan oluşur. Öznitelikleri gözden geçirmek için Alanlar sekmesini seçin.
Ticari bir web tarayıcısında girebileceklerinize benzer şekilde anahtar sözcük araması, son kullanıcı deneyimini test etmek için kullanışlıdır. Örneğin, hotels-sample dizinini varsayarsak girebilirsiniz
"activities 'outdoor pool' restaurant OR continental breakfast"ve ardından arama sonuçlarındaki terimleri bulmak için Ctrl-F kullanabilirsiniz.Sorgu ve filtre ifadeleri, Azure Yapay Zeka Arama tarafından uygulanan bir söz diziminde ifade edilir. Varsayılan, basit bir söz dizimidir, ancak isteğe bağlı olarak daha güçlü sorgular için tam Lucene kullanabilirsiniz. Filtre ifadeleri bir OData söz diziminde ifade edilir.
Kaynakları temizleme
Kendi aboneliğinizde çalışırken, artık ihtiyacınız olmayan kaynakları kaldırarak bir projeyi tamamlamak iyi bir fikirdir. Çalışır durumda kalan kaynaklar size pahalıya mal olabilir.
Kaynakları bulmak ve yönetmek için Azure portalında Tüm kaynaklar veya Kaynak grupları seçin. Kaynakları tek tek silebilir veya tüm kaynakları aynı anda kaldırmak için kaynak grubunu silebilirsiniz.
Ücretsiz arama hizmeti kullanıyorsanız üç dizin, dizin oluşturucu ve veri kaynağıyla sınırlı olduğunuzu unutmayın. Sınırın altında kalmak için portaldaki tek tek öğeleri silebilirsiniz .
Sonraki adım
Sorgu yapıları ve söz dizimi hakkında daha fazla bilgi edinmek için REST istemcisini kullanarak REST API'nin daha fazla bölümünü kullanan sorgu ifadeleri oluşturun. Belgeler - Arama Gönderisi (REST API) özellikle öğrenme ve araştırma için yararlıdır.