Öğ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 öğretici, kitap kataloğunda aramalar yapıp web sitesini Azure Container Apps dağıtan bir web sitesi oluşturur. 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 kimlikle Azure Container Apps 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.

Arama deneyimi şunları içerir:

• Arama - Uygulama için arama işlevi sağlar.
• Öneri - Kullanıcı arama çubuğuna yazarken öneriler sağlar.
• Modeller ve filtreler - Yazara veya dile göre filtreleyen modelli bir gezinti 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ç	depo konumunu GitHub
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 projeyi .NET. Dağıtım bunu azd kanca üzerinden postprovision otomatik olarak çalıştırır.	/azure-search-static-web-app/bulk-insert
infra	Azure Yapay Zeka Arama, Azure Container Apps ve destekleyici kaynakları dağıtmak için tarafından azd 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.

• .NET 9 veya üzeri
• Git
• Visual Studio Code
• Visual Studio Code için C# Geliştirme Araçları uzantısı
• Azure Geliştirici CLI'sı (azd)
• Docker Desktop veya başka bir Docker uyumlu kapsayıcı çalışma zamanı

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. komutu azd up yerel deponuzdan uygulama ve altyapı dosyalarını okur, kapsayıcıları oluşturur, Azure kaynakları sağlar ve istemci ile API'yi Azure Container Apps 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, Visual Studio Code kalan görevleri tamamlarsınız.

   code .
   

Sonraki adım

Uygulamayı Azure Container Apps'e dağıtma