Hızlı Başlangıç: Azure portalında arama dizini oluşturma

Makale
05/30/2024

Bu Azure AI Arama hızlı başlangıcında, Verileri içeri aktarma sihirbazını ve Microsoft tarafından barındırılan kurgusal otel verilerinden oluşan yerleşik bir örnek veri kaynağını kullanarak ilk arama dizininizi oluşturun. Sihirbaz, dakikalar içinde ilginç sorgular yazmanıza yardımcı olmak için kod içermeyen bir arama dizini oluşturma işleminde size yol gösterir.

Sihirbaz, arama hizmetinizde birden çok nesne (aranabilir dizin ) ve otomatik veri alma için bir dizin oluşturucu ve veri kaynağı bağlantısı oluşturur. Bu hızlı başlangıcın sonunda her nesneyi gözden geçireceğiz.

Not

Verileri içeri aktarma sihirbazı, bu hızlı başlangıçta ele alınmayacak OCR, metin çevirisi ve diğer yapay zeka zenginleştirmeleri için seçenekler içerir. Uygulanan yapay zekaya odaklanan benzer bir kılavuz için bkz . Hızlı Başlangıç: Azure portalında beceri kümesi oluşturma.

Önkoşullar

Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
Herhangi bir katman ve herhangi bir bölge için Azure AI Arama hizmeti. Geçerli aboneliğinizin altında bir hizmet oluşturun veya mevcut bir hizmeti bulun. Bu hızlı başlangıç için ücretsiz bir hizmet kullanabilirsiniz.

Yerleşik örnek verilerin kullanıldığı bu hızlı başlangıçta, arama hizmetinin ağ erişim denetimlerinin olmadığından emin olun. Portal denetleyicisi, Microsoft tarafından barındırılan yerleşik örnek veri kaynağından veri ve meta verileri almak için genel uç noktayı kullanır. Daha fazla bilgi için bkz . İçeri aktarma sihirbazlarında güvenli bağlantılar.

Alan denetleme

Birçok müşteri ücretsiz hizmetle başlar. Ücretsiz katman üç dizin, üç veri kaynağı ve üç dizin oluşturucu ile sınırlıdır. Başlamadan önce ek öğeler için yeriniz olduğundan emin olun. Bu hızlı başlangıçta her nesneden biri oluşturulur.

Zaten kaç dizine, dizin oluşturucuya ve veri kaynağına sahip olduğunuzu görmek için hizmetin Genel Bakış > Kullanımı sekmesine bakın.

Sihirbazı başlatma

Azure hesabınızla Azure portalında oturum açın ve Azure yapay zeka Arama hizmeti gidin.
Sihirbazı başlatmak için Genel Bakış sayfasında Verileri içeri aktar'ı seçin.

Dizin oluşturma ve yükleme

Bu bölümde, dört adımda bir dizin oluşturup yükleyin.

Veri kaynağına bağlanma

Sihirbaz, Azure Cosmos DB'de Microsoft tarafından barındırılan örnek verilere bir veri kaynağı bağlantısı oluşturur. Bu örnek verilere genel uç nokta üzerinden erişilir. Bu hızlı başlangıcı çalıştırmak için kendi Azure Cosmos DB hesabınıza veya kaynak dosyalarınıza ihtiyacınız yoktur.

Verilerinize bağlanın sayfasında Veri Kaynağı açılan listesini genişletin ve Örnekler'i seçin.
Yerleşik örnekler listesinde hotels-sample'ı seçin.
Devam etmek için İleri: Bilişsel beceriler ekle (İsteğe bağlı) seçeneğini belirleyin.

Bilişsel beceriler için yapılandırmayı atlama

Verileri içeri aktarma sihirbazı, dizin oluşturmada beceri kümesi ve yapay zeka zenginleştirmesi oluşturmayı destekler.

Bu hızlı başlangıç için Bilişsel beceriler ekle sekmesindeki yapay zeka zenginleştirme yapılandırma seçeneklerini yoksayın.
Atla: Devam etmek için hedef dizini özelleştir'i seçin.

İpucu

Yapay zeka zenginleştirmeyle mi ilgileniyorsunuz? Bu Hızlı Başlangıcı deneyin: Azure portalında beceri kümesi oluşturma

Dizini yapılandırma

Sihirbaz, yerleşik hotels-sample dizini için bir şema çıkartır. Dizini yapılandırmak için şu adımları izleyin:

Dizin adı (hotels-sample-index) ve Key alanı (HotelId) için sistem tarafından oluşturulan değerleri kabul edin.
Tüm alan öznitelikleri için sistem tarafından oluşturulan değerleri kabul edin.
Devam etmek için İleri: Dizin oluşturucu oluştur'u seçin.

Dizin için en azından bir Dizin adı ve alanlar koleksiyonu gerekir. Her belgeyi benzersiz olarak tanımlamak için bir alan belge anahtarı olarak işaretlenmelidir. Değer her zaman bir dizedir. Sihirbaz benzersiz dize alanlarını tarar ve anahtar için bir tane seçer.

Her alanın, arama dizininde alanın nasıl kullanılacağını denetleyebilen bir adı, veri türü ve öznitelikleri vardır. Onay kutuları aşağıdaki öznitelikleri etkinleştirir veya devre dışı bırakır:

Alınabilir: Sorgu yanıtında döndürülen alanlar.
Filtrelenebilir: Filtre ifadesini kabul eden alanlar.
Sıralanabilir: Orderby ifadesini kabul eden alanlar.
Modellenebilir: Modelli gezinti yapısında kullanılan alanlar.
Aranabilir: Tam metin aramasında kullanılan alanlar. Dizelerde arama yapılabilir. Sayısal alanlar ve Boolean alanları genellikle aranamaz olarak işaretlenir.

Dizeler Alınabilir ve Aranabilir olarak özniteliklendirilir. Tamsayılar Alınabilir, Filtrelenebilir, Sıralanabilir ve Modellenebilir olarak özniteliklendirilir.

Öznitelikler depolamayı etkiler. Filtrelenebilir alanlar fazladan depolama alanı tüketir, ancak Alınabilir alanı kullanmaz. Daha fazla bilgi için bkz . Özniteliklerin ve önericilerin depolama etkilerini gösteren örnek.

Otomatik tamamlama veya önerilen sorgular istiyorsanız dil Çözümleyicileri veya Önericiler'i belirtin.

Dizin oluşturucuyu yapılandırma ve çalıştırma

Son adım dizin oluşturucuyu yapılandırıp çalıştırır. Bu nesne, yürütülebilir bir işlemi tanımlar. Veri kaynağı, dizin ve dizin oluşturucu bu adımda oluşturulur.

Dizin Oluşturucu adı (hotels-sample-indexer) için sistem tarafından oluşturulan değeri kabul edin.
Bu hızlı başlangıç için, dizin oluşturucuyu hemen bir kez çalıştırmak için varsayılan seçeneği kullanın. Barındırılan veriler statik olduğundan değişiklik izleme özelliği etkinleştirilmez.
Dizin oluşturucuyu oluşturmak ve aynı anda çalıştırmak için Gönder'i seçin.

Dizin oluşturucu ilerleme durumunu izleme

Dizin oluşturucunun veya dizinin oluşturulmasını portalda izleyebilirsiniz. Hizmete Genel Bakış sayfası, Azure yapay zeka Arama hizmeti oluşturulan kaynakların bağlantılarını sağlar.

Sol tarafta Dizin oluşturucular'ı seçin.

Sayfa sonuçlarının Azure portalında güncelleştirilmiş olması birkaç dakika sürebilir. Yeni oluşturulan dizin oluşturucuyu devam ediyor veya Başarılı durumuyla listede görmeniz gerekir. Listede ayrıca dizine alınan belge sayısı da gösterilir.

Arama dizini sonuçlarını denetleme

Sol tarafta Dizinler'i seçin.
hotels-sample-index öğesini seçin.

Azure portalı sayfasının yenilenmesini bekleyin. Belge sayısı ve depolama boyutuna sahip dizini görmeniz gerekir.
Dizin şemasını görüntülemek için Alanlar sekmesini seçin.

Hangi alanların Filtrelenebilir veya Sıralanabilir olduğunu görmek için hangi sorguların yazıldığını denetleyin.

Alan ekleme veya değiştirme

Alanlar sekmesinde, Ad, desteklenen veri türü ve ilişkilendirmelerle alan ekle'yi kullanarak yeni bir alan oluşturabilirsiniz.

Mevcut alanları değiştirmek daha zordur. Mevcut alanların dizinde fiziksel bir gösterimi olduğundan kodda bile değiştirilemezler. Var olan bir alanı temelden değiştirmek için özgün alanın yerini alan yeni bir alan oluşturmanız gerekir. Puanlama profilleri ve CORS seçenekleri gibi diğer yapılar herhangi bir zamanda dizine eklenebilir.

Dizin tasarımı sırasında neleri düzenleyip düzenleyebileceğinizi net bir şekilde anlamak için dizin tanımı seçeneklerini görüntülemek için bir dakikanızı ayırmanız gerekir. Alan listesindeki gri seçenekler değiştirilemedi veya silinemedi değerleri gösterir.

Arama gezgini ile sorgulama

Artık Arama gezgini ile sorgulanabilen bir arama dizininiz var. Arama gezgini, Search POST REST API'sine uygun REST çağrıları gönderir. Araç basit sorgu söz dizimini ve tam Lucene sorgu söz dizimini destekler.

Arama gezgini sekmesinde, aranacak metni girin.
Çıkışın görünür olmayan alanlarına hızla atlamak için Mini haritayı kullanın.
Söz dizimini belirtmek için JSON görünümüne geçin.

Oteller için örnek sorgular örnek dizin

Aşağıdaki örneklerde JSON görünümü ve 2024-05-01-preview REST API sürümü varsayılır.

İpucu

JSON görünümü artık parametre adı tamamlama için intellisense'i destekliyor. İmleci JSON görünümünün içine yerleştirin ve tüm sorgu parametrelerinin listesini göstermek için bir boşluk karakteri yazın veya yalnızca "s" ile başlayan sorgu parametrelerini göstermek için "s" gibi tek bir harf yazın. Intellisense geçersiz parametreleri dışlamaz, bu nedenle en iyi kararınızı kullanın.

Filtre örnekleri

Otopark, etiketler, yenileme tarihi, derecelendirme ve konum filtrelenebilir.

{
    "search": "beach OR spa",
    "select": "HotelId, HotelName, Description, Rating",
    "count": true,
    "top": 10,
    "filter": "Rating gt 4"
}

Boole filtreleri varsayılan olarak "true" kabul eder.

{
    "search": "beach OR spa",
    "select": "HotelId, HotelName, Description, Rating",
    "count": true,
    "top": 10,
    "filter": "ParkingIncluded"
}

Jeo-uzamsal arama, filtre tabanlıdır. İşlev, geo.distance konumsal veriler için tüm sonuçları belirtilen Location ve geography'POINT koordinatlara göre filtreler. Sorgu, "Redmond, Washington, ABD" olan enlem boylam koordinatlarının -122.12 47.675 kilometre içinde yer alan otelleri arar. Sorgu, otel adları ve adres konumlarıyla toplam eşleşme &$count=true sayısını görüntüler.

{
    "search": "*",
    "select": "HotelName, Address/City, Address/StateProvince",
    "count": true,
    "top": 10,
    "filter": "geo.distance(Location, geography'POINT(-122.12 47.67)') le 5"
}

Tam Lucene söz dizimi örnekleri

Varsayılan söz dizimi basit söz dizimidir, ancak belirsiz arama veya terim artırma veya normal ifadeler istiyorsanız, tam söz dizimini belirtin.

{
    "queryType": "full",
    "search": "seatle~",
    "select": "HotelId, HotelName,Address/City, Address/StateProvince",
    "count": true
}

Varsayılan olarak, gibi seatleSeattle yanlış yazılmış sorgu terimleri tipik bir aramada eşleşme döndüremeyez. queryType=full parametresi, tilde ~ işlenenini destekleyen tam Lucene sorgu ayrıştırıcısını çağırır. Bu parametreler mevcut olduğunda, sorgu belirtilen anahtar sözcük için benzer bir arama gerçekleştirir. Sorgu, anahtar sözcükle tam olarak eşleşmeyen ancak benzer sonuçlarla birlikte eşleşen sonuçlar arar.

Dizininiz için bu örnek sorgulardan birkaçını denemek için bir dakikanızı ayırmanız gerekir. Sorgular hakkında daha fazla bilgi edinmek için bkz . Azure AI Search'te sorgulama.

Kaynakları temizleme

Kendi aboneliğinizde çalışırken, oluşturduğunuz kaynaklara hala ihtiyacınız olup olmadığını belirlemek, projenin sonunda 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.

Hizmetinizin kaynaklarını Azure portalında Sol bölmedeki Tüm kaynaklar veya Kaynak grupları altında bulabilir ve yönetebilirsiniz.

Ücretsiz bir hizmet kullanıyorsanız sınırın üç dizin, dizin oluşturucu ve veri kaynağı olduğunu unutmayın. Sınırın altında kalmak için Azure portalında tek tek öğeleri silebilirsiniz.

Sonraki adımlar

Tarayıcıda çalışan kullanıma hazır bir web uygulaması oluşturmak için azure portal sihirbazını deneyin. Bu hızlı başlangıçta oluşturduğunuz küçük dizinde bu sihirbazı kullanın veya daha zengin bir arama deneyimi için yerleşik örnek veri kümelerinden birini kullanın.

Portalda tanıtım uygulaması oluşturma

Aracılığıyla paylaş