C# Azure Yapay Zeka Arama uygulamasını Azure Container Apps dağıtma

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.

Azure Geliştirici CLI'sını (azd ) kullanarak arama özellikli web sitesini Azure Container Apps dağıtın. Bu dağıtım React istemcisini, .NET API'sini, Azure Yapay Zeka Arama, yönetilen kimliği ve destekleyici Azure kaynaklarını içerir.

Dağıtım, yönetilen kimliği Azure Yapay Zeka Arama için varsayılan kimlik doğrulama yöntemi olarak kullanır. Dağıtımdan önce olarak ayarlayarak USE_KEYLESS_AUTH anahtar tabanlı kimlik doğrulamasını false kabul edebilirsiniz.

Azure'a Giriş Yap

  1. Visual Studio Code depo kökünde gibi azure-search-static-web-appbir terminal açın.

  2. azd kullanarak Azure oturum açın.

    azd auth login

  3. Tarayıcınız tarafından istenirse, bu öğretici için kullandığınız Azure hesabını kullanarak oturum açma akışını tamamlayın.

Azd ortamı oluşturma

  • Ortam azd oluşturma. değerini, bu öğretici dağıtımlarını tanımlayan kısa bir adla değiştirin YOUR-ENVIRONMENT-NAME .

    azd env new YOUR-ENVIRONMENT-NAME

(İsteğe bağlı) Anahtar tabanlı kimlik doğrulamayı yapılandırma

Varsayılan kimlik doğrulama yöntemi yönetilen kimlik olduğundan çoğu ortam bu bölümü atlayabilir. Bu bölümü yalnızca ortamınız API anahtarları gerektiriyorsa tamamlayın.

USE_KEYLESS_AUTH değerini false olarak ayarlayın.

azd env set USE_KEYLESS_AUTH false

ayarlamazsanız USE_KEYLESS_AUTH, dağıtım yönetilen kimliği kullanır. Bicep altyapısı, kapsayıcı uygulaması kimliğine Azure Yapay Zeka Arama veri düzlemine erişim verir.

azd up ile dağıtma

  1. Depolama dizininin kök klasöründen azd up komutunu çalıştırın.

    azd up

  2. İstendiğinde, kaynakların Azure aboneliğini ve konumunu seçin.

  3. azd Altyapıyı sağlamayı, kapsayıcıları oluşturmayı, görüntüleri göndermeyi ve hizmetleri Azure Container Apps dağıtmayı bekleyin.

  4. Dağıtımdan sonra çıktıyı gözden geçirin. Çıktı, Azure Container Apps dağıtımı için istemci ve sunucu tam etki alanı adlarını (FQDN) içerir.

    AZURE_CLIENT_URL: <client-container-app-fqdn>
AZURE_SERVER_URL: <server-container-app-fqdn>
SEARCH_SERVICE_NAME: <search-service-name>

    AZURE_CLIENT_URL Web sitesini açmak için değerini kullanın. İstemci uygulaması, dağıtım sırasında yapılandırılan uç nokta üzerinden sunucu uygulamasını çağırır.

    Dağıtım ayrıca Azure Yapay Zeka Arama hizmetini oluşturmuş ve örnek depodaki postprovision kanca aracılığıyla dizini otomatik olarak yükledigood-books.

Container Apps web sitenizde aramayı kullanma

  1. Çıktıdan istemci FQDN'sini azd up bir tarayıcıda açın.

  2. Web sitesi arama çubuğuna gibi codebir arama sorgusu girin. Otomatik tamamlama özelliği, eşleşen kitap başlıklarını önerir.

  3. Bir öneri seçin veya kendi sorgunuzu girmeye devam edin. Arama sorgunuzu bitirdiğinizde Enter tuşuna basın.

  4. Sonuçları gözden geçirin ve daha fazla ayrıntı görmek için bir kitap seçin.

Troubleshooting

Web uygulaması dağıtılmıyorsa veya çalışmıyorsa, sorunu belirlemek ve düzeltmek için aşağıdaki listeyi kullanın:

  • Tamamlandı mı azd up ?

    azd up İlk başarısız sağlama, derleme veya dağıtma adımının çıktısını gözden geçirin. Dağıtım sağlama sırasında durursa abonelik izinlerinizi ve seçili bölgeyi denetleyin. Kapsayıcı derleme veya dağıtma adımları sırasında dağıtım durdurulursa, bildirilen sorunu düzeltdikten sonra yeniden çalıştırın azd up .

  • İstemci uç noktasını açabilir misiniz?

    Çıkıştan AZURE_CLIENT_URL değeri azd up açın. Sayfa yüklenmiyorsa Azure portalına gidin, istemci kapsayıcı uygulamasını açın ve düzeltme durumunu ve günlüklerini gözden geçirin.

  • İstemci sunucu uç noktasını çağırabilir mi?

    Tarayıcı geliştirici araçlarınızı açın ve istemci uygulamasından gelen ağ çağrılarını gözden geçirin. API'ye yapılan çağrılar başarısız olursa, sunucu kapsayıcı uygulamasının çalıştığını ve istemci uygulamasının dağıtım sırasında sunucu FQDN'sini aldığını onaylayın.

  • Sunucu Azure Yapay Zeka Arama sorgulayabilir mi?

    Aramalar hata döndüriyorsa sunucu kapsayıcı uygulaması günlüklerini gözden geçirin. Yönetilen kimlik için, kimliğin Azure Yapay Zeka Arama veri düzlemi erişimine sahip olduğunu onaylayın. Anahtar tabanlı kimlik doğrulaması için dağıtımdan önce olarak ayarladığınızı USE_KEYLESS_AUTHfalse ve oluşturulan kapsayıcı ortamının arama hizmeti yapılandırmasını içerdiğini onaylayın.

Kaynakları temizle

Bu öğreticinin oluşturduğu Azure kaynaklarını silmek için kullanınazd down --purge. --purge bayrağı, geçici silmeyi destekleyen kaynakları saklama süreleri için kurtarılabilir durumda bırakmak yerine kalıcı olarak kaldırır. Temizleme, bu öğreticiyi daha sonra yeniden dağıtırsanız adlandırma çakışmalarını önler.

  1. Depo kökünden temizleme komutunu çalıştırın.

    azd down --purge

  2. Listeleyen kaynakları azd gözden geçirin.

  3. Sorulduğunda silme işlemini onaylayın.

Dağıtımın azd dışında bir Azure Yapay Zeka Arama hizmeti oluşturduysanız, Azure portalında arama hizmetinize gidin ve sayfanın üst kısmındaki Sil'i seçin.

Sonraki adım

Arama tümleştirme kodunu keşfetme

  • Last updated on