Hızlı Başlangıç: Azure portalında tanıtım uygulaması oluşturma

Bu Azure AI Search hızlı başlangıcında, tarayıcıda çalışan indirilebilir ,"localhost" stilinde bir web uygulaması oluşturmak için Azure portalının Tanıtım uygulaması oluşturma sihirbazını kullanacaksınız. Oluşturulan uygulama, yapılandırmasına bağlı olarak ilk kullanımda çalışır durumdadır ve arama hizmetinizdeki bir dizine canlı salt okunur bağlantı sağlar. Varsayılan uygulama arama çubuğu, sonuç alanı, kenar çubuğu filtreleri ve tür başlığı desteği içerebilir.

Tanıtım uygulaması, bir dizinin istemci uygulamasında nasıl çalışacağını görselleştirmenize yardımcı olabilir, ancak üretim senaryolarına yönelik değildir. Üretim uygulamaları, tanıtım uygulamasının sağlamadığı güvenlik, hata işleme ve barındırma mantığını içermelidir.

Önkoşullar

Başlamadan önce aşağıdaki önkoşulları uygulayın:

Dizin kullanıma hazır olduğunda sonraki adıma geçin.

Sihirbazı başlatma

  1. Azure hesabınızla Azure portalında oturum açın.

  2. Arama hizmetinizi bulun ve Genel Bakış sayfasında, sayfanın ortasındaki bağlantılardan Dizinler'i seçin.

  3. Mevcut dizinler listesinden realestate-us-sample-index öğesini seçin.

  4. Sihirbazı başlatmak için dizin sayfasındaki üst kısımda Tanıtım uygulaması oluştur (önizleme) öğesini seçin.

  5. İlk sihirbaz sayfasında Çıkış Noktaları Arası Kaynak Paylaşımını (CORS) Etkinleştir'i seçerek dizin tanımınıza CORS desteği ekleyin. Bu adım isteğe bağlıdır, ancak yerel web uygulamanız bu olmadan uzak dizine bağlanamaz.

Arama sonuçlarını yapılandırma

Sihirbaz, küçük resim görüntüsü, başlık ve açıklama alanı içeren işlenmiş arama sonuçları için temel bir düzen sağlar. Bu öğelerin her birinin yedeklenmesi, dizininizde verileri sağlayan bir alandır.

  1. Küçük Resim'de realestate-us-sample dizinindeki küçük resim alanını seçin. Bu örnek, küçük resim adı verilen bir alanda depolanan URL adresli görüntüler biçiminde resim küçük resimlerini içerir. Dizininizde görüntü yoksa bu alanı boş bırakın.

  2. Başlık'ta, her belgenin benzersizliğini aktaran bir alan seçin. Bu örnekte listeleme kimliği makul bir seçimdir.

  3. Açıklama'da, birinin söz konusu belgeye tıklayıp tıklamamaya karar vermesine yardımcı olabilecek ayrıntılar sağlayan bir alan seçin.

    configure results for sample data

Kenar çubuğu ekleme

Arama hizmeti, genellikle kenar çubuğu olarak işlenen çok yönlü gezintiyi destekler. Modeller, dizin şemasında gösterildiği gibi filtrelenebilir ve modellenebilir alanları temel alır.

Azure AI Search'te modelli gezinti, birikmeli filtreleme deneyimidir. Bir kategoride, birden çok filtre seçildiğinde sonuçlar genişletiliyor (örneğin, Şehir içinde Seattle ve Bellevue'u seçmek). Kategoriler arasında birden çok filtrenin seçilmesi sonuçları daraltıyor.

İpucu

Portalda tam dizin şemasını görüntüleyebilirsiniz. Her dizinin genel bakış sayfasında Dizin tanımı (JSON) bağlantısını arayın. Modelli gezinti için uygun olan alanların "filtrelenebilir: true" ve "facetable: true" öznitelikleri vardır.

  1. Sihirbazda, sayfanın üst kısmındaki Kenar Çubuğu sekmesini seçin. Dizinde filtrelenebilir ve görüntülenebilir olarak nitelenen tüm alanların listesini görürsünüz.

  2. Geçerli modelli alan seçimini kabul edin ve sonraki sayfaya geçin.

Tür başlığı ekleme

Tür başlığı işlevselliği, otomatik tamamlama ve sorgu önerileri biçiminde kullanılabilir. Sihirbaz sorgu önerilerini destekler. Kullanıcı tarafından sağlanan tuş vuruşu girişlerine bağlı olarak, arama hizmeti giriş olarak seçilebilen "tamamlandı" sorgu dizelerinin listesini döndürür.

Öneriler belirli alan tanımlarında etkinleştirilir. Sihirbaz, bir öneriye ne kadar bilgi eklenmek üzere yapılandırma seçenekleri sunar.

Aşağıdaki ekran görüntüsünde, uygulamada işlenmiş bir sayfayla birleştirilmiş sihirbazdaki seçenekler gösterilmektedir. Alan seçimlerinin nasıl kullanıldığını ve "Alan Adını Göster"in öneriye etiketlemeyi dahil etmek veya dışlamak için nasıl kullanıldığını görebilirsiniz.

Query suggestion configuration

Öneri ekleme

Öneriler, arama kutusuna eklenen otomatik sorgu istemlerine başvurur. Azure AI Search iki öğeyi destekler: kısmen girilen bir arama teriminin otomatik olarak derlenip otomatikleştirilmesi ve olası eşleşen belgelerin temel alındığı bir açılan liste için öneriler .

Sihirbaz önerileri destekler ve önerilen sonuçları sağlayabilecek alanlar dizindeki bir Suggesters yapıdan türetilir:

  "suggesters": [
    {
      "name": "sg",
      "searchMode": "analyzingInfixMatching",
      "sourceFields": [
        "number",
        "street",
        "city",
        "region",
        "postCode",
        "tags"
      ]
    }
  ]
  1. Sihirbazda, sayfanın üst kısmındaki Öneriler sekmesini seçin. Dizin şemasında öneri sağlayıcıları olarak belirlenen tüm alanların listesini görürsünüz.

  2. Geçerli seçimi kabul edin ve sonraki sayfaya geçin.

Oluşturma, indirme ve yürütme

  1. HTML dosyasını oluşturmak için sayfanın alt kısmındaki Tanıtım uygulaması oluştur'u seçin.

  2. İstendiğinde, dosyayı indirmek için Uygulamanızı indirin'i seçin.

  3. Dosyayı açın ve Ara düğmesini seçin. Bu eylem, rastgele sonuç kümesi döndüren boş bir sorgu (*) olabilecek bir sorgu yürütür. Sayfa aşağıdaki ekran görüntüsüne benzer görünmelidir. Bir terim girin ve sonuçları daraltmak için filtreleri kullanın.

Temel alınan dizin, belgeler arasında çoğaltılmış kurgusal, oluşturulan verilerden oluşur ve açıklamalar bazen görüntüyle eşleşmez. Kendi dizinlerinizi temel alan bir uygulama oluşturduğunuzda daha uyumlu bir deneyim bekleyebilirsiniz.

Run the app

Kaynakları temizleme

Kendi aboneliğinizde çalışırken, projenin sonunda oluşturduğunuz kaynaklara hala ihtiyacınız olup olmadığını belirlemek iyi bir fikirdir. Çalışır durumda bırakılan kaynaklar maliyetlerin artmasına neden olabilir. Kaynakları teker teker silebilir veya tüm kaynak grubunu silerek kaynak kümesinin tamamını kaldırabilirsiniz.

Sol gezinti bölmesindeki Tüm kaynaklar veya Kaynak grupları bağlantısını kullanarak kaynakları portalda bulabilir ve yönetebilirsiniz.

Ücretsiz bir hizmetin üç dizin, dizin oluşturucu ve veri kaynağıyla sınırlı olduğunu unutmayın. Sınırın altında kalmak için portaldaki tek tek öğeleri silebilirsiniz.

Sonraki adımlar

JavaScript veya ön uç kodu yazmak zorunda kalmadan bir son kullanıcı deneyiminin benzetimini yapabileceğinizden, ancak kendi projenizde kavram kanıtına yaklaştıkça, gerçek sözcük uygulamasının daha yakın olan uçtan uca kod örneklerinden birini gözden geçirin: