Öğretici: Azure Container Apps'da C# web uygulamasına Azure Yapay Zeka Arama ekleme

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.

Bu öğreticide, bir kitap kataloğunda arama yapan bir web sitesi oluşturulur ve bu web sitesi Azure Container Apps'e dağıtılır. Dağıtım, Azure Yapay Zeka Arama için varsayılan kimlik doğrulama yöntemi olarak Azure Geliştirici CLI'sini (azd) ve yönetilen kimliği kullanır.

Bu eğitimde şunları yapacaksınız:

  • Azure Yapay Zeka Arama dağıtın ve Azure Geliştirici CLI'sı ile bir dizini otomatik olarak dağıtın.
  • C# uygulamasında arama sorgularını, önerileri, modelleri, sayfalandırmayı ve belge aramasını tümleştirin.
  • Uygulamayı, varsayılan kimlik doğrulama yöntemi olarak yönetilen kimliği kullanarak Azure Container Apps’e dağıtın.

Örnek ne yapar?

Bu örnek web sitesi 10.000 kitaplık bir kataloğa erişim sağlar. Arama çubuğuna metin girerek katalogda arama yapabilirsiniz. Siz metin girerken, web sitesi metni otomatik olarak tamamlarken arama dizininin öneri özelliğini kullanır.

Sorgu tamamlandığında web sitesi, ayrıntılarının bir bölümünü içeren kitap listesini görüntüler. Arama dizininde depolanan tüm ayrıntılarını görmek için bir kitap seçebilirsiniz.

Yazar ve dil modelleri ve sayfalandırma denetimleriyle köpek için arama sonuçlarını gösteren örnek uygulamanın ekran görüntüsü.

Arama deneyimi şunları içerir:

  • Arama - Uygulama için arama işlevi sağlar.
  • Öneri - Kullanıcı arama çubuğuna yazarken öneriler sağlar.
  • Fasetler ve filtreler - Yazara veya dile göre filtreleme yapan fasetli bir gezinme yapısı sağlar.
  • Sayfalandırılmış sonuçlar - Sonuçlar arasında gezinmek için sayfalama denetimleri sağlar.
  • Belge arama - Ayrıntılar sayfasının tüm içeriğini almak için kimliğine göre bir belgeyi arar.

Örnek nasıl düzenlenmiştir?

Örnek kod aşağıdaki bileşenleri içerir:

Uygulama Amaç GitHub deposu konumu
client Arama ile kitapları görüntülemek için React uygulaması (sunu katmanı). API'yi çağırır. /azure-search-static-web-app/client
api Azure Container Apps üzerinde bir kapsayıcıda barındırılan ve .NET SDK ile Azure Yapay Zeka Arama API'sini çağıran C# Azure İşlevleri API (iş katmanı). /azure-search-static-web-app/api
bulk-insert Dizini oluşturan ve belgeleri yükleyen .NET projesi. azd dağıtımı bunu postprovision kancası aracılığıyla otomatik olarak çalıştırır. /azure-search-static-web-app/bulk-insert
infra azd tarafından Azure Yapay Zeka Arama, Azure Container Apps ve destekleyici kaynakları dağıtmak için kullanılan Bicep altyapısı. Azure-Samples/azure-search-static-web-app

Geliştirme ortamınızı ayarlama

Yerel geliştirme ortamınız için aşağıdaki yazılımı yükleyin. azd up komut, Azure Yapay Zeka Arama dahil olmak üzere tüm Azure kaynakları sağlar, böylece bunları önceden oluşturmanız gerekmez.

Bu öğretici, Azure İşlevleri API'sini yerel olarak çalıştırmaz. Yerel olarak çalıştırmak istiyorsanız Azure İşlevleri Core Tools'u yükleyin.

Git ile arama örneğini kopyalama

Örneği yerel bir kopyadan dağıtabilirsiniz. azd up komutu, yerel deponuzdan uygulama ve altyapı dosyalarını okur, kapsayıcıları oluşturur, Azure kaynaklarını hazırlar ve istemciyi ve API’yi Azure Container Apps’e dağıtır.

  1. Bash terminalinde örnek uygulamayı yerel bilgisayarınıza kopyalayın.

    git clone https://github.com/Azure-Samples/azure-search-static-web-app.git
    
  2. Aynı Bash terminalinde bu arama örneği için depo dizinine gidin.

    cd azure-search-static-web-app
    
  3. Depoyu açmak için Visual Studio Code komutunu code .kullanın. Aksi belirtilmedikçe, geri kalan görevleri Visual Studio Code'da tamamlarsınız.

    code .
    

Sonraki adım