Kılavuz: Klasik kurumsal sohbet web uygulaması dağıtma

Yalnızca şunlar için geçerlidir:Dökümhane (klasik) portalı. Bu makale yeni Dökümhane portalında kullanılamaz. Yeni portal hakkında daha fazla bilgi edinin.

Not

Bu makaledeki bağlantılar, şu anda görüntülediğiniz Dökümhane (klasik) belgeleri yerine yeni Microsoft Foundry belgelerinde içerik açabilir.

Bu makalede, Microsoft Foundry portalında büyük bir dil modeliyle verilerinizi kullanan bir kurumsal sohbet web uygulaması dağıtacaksınız.

Veri kaynağınız modeli belirli verilerle dayandırmaktadır. Temel oluşturma, modelin sorunuzun bağlamını anlamak için verilerinizi kullandığı anlamına gelir. Dağıtılan modelin kendisini değiştirmezsiniz. Verileriniz özgün veri kaynağınızda ayrı ve güvenli kalır.

Bu öğreticideki adımlar şunlardır:

• Kaynakları yapılandırın.
• Verilerinizi ekleyin.
• Modeli verilerinizle test edin.
• Web uygulamanızı dağıtın.

Önkoşullar

Önemli

Bu makale, merkez tabanlı projeler için eski sistem desteği sağlar. Foundry projeleri için çalışmaz. Bkz. Ne tür bir projem olduğunu nasıl bilebilirim?

SDK uyumluluk notu: Kod örnekleri için belirli bir Microsoft Döküm SDK'sı sürümü gerekir. Uyumluluk sorunlarıyla karşılaşırsanız hub tabanlı bir projeden Foundry projesine geçiş yapmayı göz önünde bulundurun.

• Etkin aboneliği olan bir Azure hesabı. Hesabınız yoksa ücretsiz deneme aboneliği içeren bir free Azure hesabı oluşturun.
• Bir projeniz yoksa merkez tabanlı bir proje oluşturun.

• Azure'da dağıtılan bir OpenAI sohbet modeli. Eğer sahip değilseniz, bu kaynağı oluşturmak için Foundry oyun alanı hızlı başlangıç kılavuzunu tamamlayın.

• Örnek ürün verilerini dizine almak için bir Arama hizmeti bağlantısı. Bir arama hizmetiniz yoksa, arama hizmeti oluşturma ve bağlama adımlarını izleyin.

• Ürün verilerinin yerel bir kopyası. GitHub üzerindeki Azure-Samples/rag-data-openai-python-promptflow deposunda bu öğretici senaryosu için örnek perakende ürün bilgileri bulunur. product_info_11.md dosyası, bu öğretici örneği için TrailWalker yürüyüş ayakkabıları hakkında ürün bilgilerine sahiptir. Zip dosyasında contoso Trek perakende ürün verileri örneğini yerel makinenize yükleyin.

• Microsoft. Web bir web uygulamasına dağıtabilmeniz için seçili aboneliğe kayıtlı kaynak sağlayıcısı. Kaynak sağlayıcısı kaydetme hakkında daha fazla bilgi için bkz. Kaynak sağlayıcısını kaydetme.

• Azure aboneliğinize rol atamaları eklemek için gerekli izinler. Yalnızca belirli Azure kaynaklarının Sahibi rol atamalarına göre izin verebilir.

Dökümhane portalı ve Azure portalı

Bu öğreticide, Dökümhane portalında bazı görevleri ve Azure portalında bazı görevleri gerçekleştireceksiniz.

Foundry portalı yapay zeka modellerini oluşturmaya, eğitip dağıtmaya yönelik web tabanlı bir ortamdır. Geliştirici olarak, sohbet web uygulamanızı derleyip dağıttığınız yerdir.

Azure portalı, bir yöneticinin Azure kaynakları yönetmesine ve izlemesine olanak tanır. Yönetici olarak, web uygulamasından erişim için gereken farklı Azure hizmetlerinin ayarlarını ayarlamak için portalı kullanırsınız.

Kaynakları yapılandırma

Önemli

Azure aboneliğinize rol atamaları eklemek için gerekli izinlere sahip olmanız gerekir. Rol ataması tarafından izin verilmesine yalnızca belirli Azure kaynaklarının Sahibi izin verir. Azure abonelik sahibinizden (BT yöneticiniz olabilir) bu bölümü sizin için tamamlamasını istemeniz gerekebilir.

Kaynakların bir web uygulamasında düzgün çalışmasını sağlamak için Azure portalında doğru izinleri ayarlayın.

İlk olarak, Foundry portalında ayarlamanız gereken kaynakları belirleyin.

1. Foundry portalını açın, ardından Azure OpenAI sohbet modelini dağıtmak için kullandığınız hub tabanlı projeyi seçin.

2. Sol bölmeden Yönetim merkezi'ni seçin.

3. Projenizin altında Bağlı kaynaklar'ı seçin.

4. Yapılandırmanız gereken üç kaynağı belirleyin: Azure OpenAI, Azure Yapay Zeka Arama ve workspaceblobstore karşılık gelen Azure Blob depolama.

   

   Ipucu

   Tabloda Tür seçeneğini görmüyorsanız, sağ üst köşedeki Sütunlar'ı seçin ve Seçili sütunlara ekleyin veya bu sütunları yeniden sıralayın. Birden çok Azure OpenAI kaynağınız varsa, dağıtılan sohbet modelinizi içeren kaynağı kullanın.

5. bu adların her birini Azure portalında arayın. Aralarında geçiş yapmak için her birini yeni bir tarayıcı sekmesinde açın.

6. İşiniz bittiğinde üç yeni tarayıcı sekmesi açılır: Arama hizmeti, Dökümhane ve blobstore Kapsayıcısı. Kaynakları ayarlamak için bunlar arasında geçiş yaptığınızdan üç sekmeyi de açık tutun.

Yönetilen kimliği etkinleştirme

Azure portalında Search hizmeti kaynağının tarayıcı sekmesinde yönetilen kimliği etkinleştirin:

1. Sol bölmedeki Ayarlar'ın altında Kimlik'i seçin.
2. DurumuAçık olarak değiştirin.
3. Kaydet'i seçin.

Azure portalındaki Foundry kaynağının tarayıcı sekmesinde yönetilen kimliği etkinleştirin:

1. Sol bölmedeki Kaynak Yönetimi'nin altında Kimlik'i seçin.
2. DurumuAçık olarak değiştirin.
3. Kaydet'i seçin.

Arama için erişim denetimini ayarlama

Azure portalındaki Search hizmeti kaynağının tarayıcı sekmesinde API erişim ilkesini ayarlayın:

1. Sol bölmedeki Ayarlar'ın altında Anahtarlar'ı seçin.
2. API Erişimi denetimi'nin altında Her İkisi'ni seçin.
3. İstendiğinde onaylamak için Evet'i seçin.

Rol atama

Aşağıdaki adımlarda her kaynak için bu düzeni yineleyin.

Herhangi bir kaynak için rol tabanlı erişim denetimi (RBAC) atamaya yönelik genel desen:

1. Verilen kaynağın Azure portalına gidin.
2. Azure portalının sol sayfasından Access denetimi (IAM) öğesini seçin.
3. +Rol ataması ekle'yi> seçin.
4. Atamanız gereken rolü arayın ve seçin. Ardından İleri'yi seçin.
5. Kendinize bir rol atarken:
   1. Kullanıcı, grup veya hizmet ilkesi'ni seçin.
   2. Üyeleri Seç'i seçin.
   3. Adınızı arayın ve seçin.
6. Başka bir kaynağa rol atarken:
   1. Yönetilen kimlik'i seçin.
   2. Üyeleri seç seçin.
   3. Atamak istediğiniz kaynak türünü bulmak için açılan listeyi kullanın. Örneğin, Döküm Araçları veya Arama hizmeti.
   4. Görüntülenen listeden kaynağı seçin. Yalnızca bir tane olabilir, ancak yine de seçmeniz gerekir.
7. Sihirbazı geçin ve rol atamasını eklemek için Gözden Geçir ve Ata'yı seçin.

Bu öğreticide ayarladığınız kaynaklara rol atamak için şu adımları kullanın:

• Azure portalında Search service için tarayıcı sekmesinde bu rolleri atayın:

  • Dizin Veri Okuyucusu, Foundry yönetilen kimliğe atanacak
  • Arama Hizmeti Katkıda BulunanıFoundry yönetilen kimliğine
  • Kendinize katkıda bulunan ( Katkıda Bulunan'ı bulmak için üstteki Ayrıcalıklı yönetici rolleri sekmesine geçin. Diğer tüm roller İş işlevi rolleri sekmesindedir.)

• Azure portalında Foundry için tarayıcı sekmesinde bu rolleri atayın:

  • Arama hizmeti yönetilen kimliğine Bilişsel Hizmetler OpenAI Katkıda Bulunanı
  • Kendine katkı sağlamak.

• Azure portalında Azure Blob depolama için tarayıcı sekmesinde bu rolleri atayın:

  • Foundry yönetilen kimliğine Depolama Blob Verileri Katkıda Bulunanı
  • Depolama Blob Veri Okuyucusu, Arama hizmeti yönetilen kimliğine
  • Kendinize katkı sağlayan

Kaynakları ayarlamayı bitirdiniz. İsterseniz Azure portal tarayıcı sekmelerini kapatabilirsiniz.

Verilerinizi ekleyin ve sohbet modelini yeniden deneyin

Foundry oyun alanı hızlı başlangıcında (bu eğitimin önkoşullarından biridir), verileriniz yokken modelinizin nasıl yanıt verdiğini görürsünüz. Ürünlerinizle ilgili soruları yanıt edebilmesi için verilerinizi modele ekleyin.

Bu bölümü tamamlamak için ürün verilerinin yerel bir kopyası gerekir. GitHub üzerindeki Azure-Samples/rag-data-openai-python-promptflow deposu, bu öğretici senaryosuyla ilgili örnek perakende ürün bilgilerini içerir. Özellikle, product_info_11.md dosya bu öğretici örneğiyle ilgili TrailWalker yürüyüş ayakkabıları hakkındaki ürün bilgilerini içerir. Zip dosyasında contoso Trek perakende ürün verileri örneğini yerel makinenize yükleyin.

Yardımcının ürünlerinizle ilgili soruları yanıtlamasına yardımcı olmak için sohbet oyun alanında verilerinizi eklemek için bu adımları izleyin. Dağıtılan modelin kendisini değiştirmiyorsunuz. Verileriniz, Azure aboneliğinizde ayrı ve güvenli bir şekilde depolanır.

1. Microsoft Foundry içinde projenize gidin.

2. Sol bölmeden Oyun Alanları'nı seçin.

3. Sohbet oyun alanı deneyin'i seçin.

4. Dağıtım açılan listesinden dağıtılan sohbet modelinizi seçin.

   

5. Sohbet oyun alanının sol tarafında Verilerinizi> ekleyin+ Yeni veri kaynağı ekle'yi seçin.

   

6. Veri kaynağı açılır listesinde Dosyaları Yükle'yi seçin.

   

7. Yerel dosyalarınıza göz atmak için Karşıya dosya yükle'yi> seçin.

8. Karşıya yüklemek istediğiniz dosyaları seçin. Ürün bilgileri dosyalarını indirdiğiniz veya daha önce oluşturduğunuz dosyaları seçin. Tüm dosyaları şimdi ekleyin. Daha sonra aynı oyun alanı oturumunda daha fazla dosya ekleyemezsiniz.

9. Dosyayı Azure Blob depolama hesabınıza yüklemek için Yükle öğesini seçin. Ardından İleri'yi seçin.

   

10. Azure Yapay Zeka Arama hizmetinizi seçin.

11. Vektör dizini adı için ürün bilgileri girin ve İleri'yi seçin.

12. Arama ayarları sayfasında Vektör ayarları'nın altında, Bu arama kaynağına vektör araması ekle onay kutusunun seçimini kaldırın. Bu ayar, modelin isteklere nasıl yanıt verdiğini belirlemeye yardımcı olur. Ardından İleri'yi seçin.

    Not

    Vektör araması eklerseniz ek ücret karşılığında burada daha fazla seçenek kullanılabilir.

13. Ayarlarınızı gözden geçirin ve Vektör dizini oluştur'u seçin.

14. Oyun alanında veri alımınızın devam ettiğini görebilirsiniz. Bu işlem birkaç dakika sürebilir. Devam etmeden önce, durum yerine veri kaynağını ve dizin adını görene kadar bekleyin.

    

15. Artık öncekiyle aynı soruyu soran modelle sohbet edebilirsiniz ("TrailWalker yürüyüş ayakkabıları ne kadardır")ve bu kez yanıt oluşturmak için verilerinizden gelen bilgileri kullanır. Kullanılan verileri görmek için başvurular düğmesini genişletebilirsiniz.

Web uygulamanızı dağıtma

Foundry portalındaki deneyimden memnun kaldığınızda modeli tek başına bir web uygulaması olarak dağıtın.

Azure portalında kaynak grubunuzu bulma

Bu öğreticide, web uygulamanızı Foundry hub'ınızla aynı kaynak grubuna dağıtın. Azure portalında web uygulaması için kimlik doğrulamasını ayarlayacaksınız.

Azure portalında kaynak grubunuz için şu adımları izleyin:

1. Foundry'deki projenize gidin. Sol bölmeden Yönetim merkezi'ni seçin.

2. Project başlığı altında Overview öğesini seçin.

3. Kaynak grubunu Azure portalında açmak için kaynak grubu adını seçin. Bu örnekte kaynak grubu olarak adlandırılmıştır rg-sdg-ai.

   

4. Şimdi Azure Portalı'nda, hub'ı dağıttığınız kaynak grubunun içeriğini görüntülediğiniz sayfadasınız. Kaynak grubu adını ve konumunu not edin. Bu bilgileri sonraki bölümde kullanacaksınız.

5. Bu sayfayı tarayıcı sekmesinde açık tutun. Daha sonra geri dönersiniz.

Web uygulamasını dağıtma

Yayımlama, aboneliğinizde bir Azure App Service oluşturur. Seçtiğiniz fiyatlandırma planına bağlı olarak maliyetler doğurabilirsiniz. Uygulamanızla işiniz bittiğinde Azure portalından silin.

Web uygulamasını dağıtmak için:

Önemli

Web uygulamasına dağıtmadan önce Microsoft.Web'i kaynak sağlayıcısı olarak kaydedin.

1. Verilerinizi oyun bahçesine eklemek için önceki bölümdeki adımları tamamlayın. Kendi verilerinizle veya kendi verileriniz olmadan bir web uygulaması dağıtabilirsiniz, ancak Foundry oyun alanı hızlı başlangıcında açıklandığı gibi dağıtılan bir modele ihtiyacınız vardır.

2. >Dağıt... bir web uygulaması olarak seçin.

   

3. Web uygulamasına dağıt sayfasında aşağıdaki ayrıntıları girin:

   • Ad: Web uygulamanız için eşsiz bir ad.
   • Ubscription: Azure aboneliğiniz. Kullanılabilir bir abonelik görmüyorsanız, önce Microsoft.Web kaynağını kayıt ettirin olarak kaydettirin.
   • Kaynak grubu: Web uygulamasının dağıtılacağı kaynak grubunu seçin. Hub ile aynı kaynak grubunu kullanın.
   • Konum: Web uygulamasının dağıtılacağı konumu seçin. Hub ile aynı konumu kullanın.
   • Fiyatlandırma planı: Web uygulaması için bir fiyatlandırma planı seçin.
   • Web uygulamasında sohbet geçmişini etkinleştirme: Öğretici için sohbet geçmişi kutusu seçili değildir. Özelliği etkinleştirirseniz, kullanıcılarınız kendi önceki sorgularına ve yanıtlarına erişebilir. Daha fazla bilgi için bkz. sohbet geçmişi açıklamaları.

4. Dağıt'ı seçin.

5. Uygulamanın dağıtılması için bekleyin. Bu işlem birkaç dakika sürebilir.

6. Hazır olduğunda, araç çubuğunda Başlat düğmesi etkinleştirilir. Uygulamayı henüz başlatmayın ve sohbet oyun alanı sayfasını kapatmayın; daha sonra uygulamaya dönersiniz.

Web uygulaması kimlik doğrulamasını yapılandırma

Varsayılan olarak, web uygulamasına yalnızca siz erişebilirsiniz. Bu öğreticide, Azure kiracınızın üyelerine erişimi kısıtlamak için kimlik doğrulaması ekleyin. Kullanıcılar, uygulamanıza erişmek için Microsoft Entra hesaplarıyla oturum açar. İsterseniz başka bir kimlik sağlayıcısı eklemek için benzer bir işlemi izleyebilirsiniz. Uygulama yalnızca kullanıcının oturum açma bilgilerini kullanarak kiracınızın üyesi olduğunu doğrular.

1. Azure portalıyla tarayıcı sekmesine dönün veya Azure portalını yeni bir tarayıcı sekmesinde açın. Web uygulamasını dağıttığınız kaynak grubunun içeriğini görüntüleyin. Web uygulamasını görmek için görünümü yenilemeniz gerekebilir.

2. Kaynak grubundaki kaynaklar listesinden App Service kaynağını seçin.

3. Ayarlar'ın altındaki daraltılabilir sol menüden Kimlik Doğrulaması'nı seçin.

   

4. Bu sayfada Microsoft bir Kimlik sağlayıcısının listelendiğini görürseniz başka bir şey yapmanız gerekmez. Sonraki adımı atlayabilirsiniz.

5. Aşağıdaki ayarlarla bir kimlik sağlayıcısı ekleyin:

   • Identity provider: Kimlik sağlayıcısı olarak Microsoft seçin. Bu sayfadaki varsayılan ayarlar uygulamayı yalnızca kiracınızla kısıtlar, bu nedenle burada başka bir şey değiştirmeniz gerekmez.
   • Kiracı türü: İş Gücü
   • Uygulama kaydı: Yeni uygulama kaydı oluşturma
   • Ad: Web uygulaması hizmetinizin adı
   • Desteklenen hesap türleri: Geçerli kiracı - Tek kiracı
   • Erişimi kısıtla: Kimlik doğrulaması gerektirir
   • Kimliği doğrulanmamış istekler: HTTP 302 Yeniden yönlendirme bulundu - web siteleri için önerilir

Web uygulamasını kullanma

Neredeyse oradasın. Artık web uygulamasını test edebilirsiniz.

1. Ayarları değiştirdiyseniz, kimlik doğrulama ayarlarının geçerlilik kazanması için yaklaşık 10 dakika bekleyin.

2. Dökümhane portalında sohbet oyun alanı sayfasının bulunduğu tarayıcı sekmesine dönün.

3. Dağıtılan web uygulamasını açmak için Başlat'ı seçin. İstenirse izin isteğini kabul edin.

4. Oyun alanında Başlat'ı görmüyorsanız sol bölmeden Web uygulamaları'nı seçin ve ardından listeden uygulamanızı seçerek açın.

   Kimlik doğrulama ayarları henüz etkin değilse web uygulamanızın tarayıcı sekmesini kapatın ve Dökümhane portalında sohbet oyun alanınıza dönün. Biraz daha bekleyin ve yeniden deneyin.

5. Web uygulamanızda, öncekiyle aynı soruyu sorun ("TrailWalker yürüyüş ayakkabıları ne kadardır"). Bu kez uygulama, yanıtı oluşturmak için verilerinizden gelen bilgileri kullanır. Kullanılan verileri görmek için başvuru düğmesini genişletin.

   

Sohbet geçmişini anlama

Sohbet geçmişi özelliği sayesinde kullanıcılarınız önceki sorgularını ve yanıtlarını görebilir.

Web uygulamasını dağıtırken sohbet geçmişini etkinleştirin. Web uygulamasında sohbet geçmişini etkinleştir onay kutusunu seçin.

Önemli

Sohbet geçmişinin etkinleştirilmesi, kaynak grubunuzda bir Cosmos DB örneği oluşturur ve kullanılan depolama alanı için ek ücret uygulanır . Web uygulamanızı silmek Cosmos DB örneğinizi otomatik olarak silmez. Cosmos DB örneğinizi ve tüm depolanan sohbetleri silmek için Azure portalında ilişkili kaynağa gidin ve silin.

Sohbet geçmişini etkinleştirdikten sonra kullanıcılarınız uygulamayı uygulamanın sağ üst köşesinde gösterebilir veya gizleyebilir. Geçmiş gösterildiğinde, konuşmaları yeniden adlandırabilir veya silebilirler. Uygulamada oturum açtıklarında, konuşmalar en yeniden en eskiye sıralanır ve konuşmadaki ilk sorguya göre adlandırılır.

Cosmos DB kaynağını siler ancak sohbet geçmişi seçeneğini stüdyoda etkin tutarsanız, kullanıcılarınız bir bağlantı hatası görür ancak sohbet geçmişi olmadan web uygulamasını kullanmaya devam edebilir.

Web uygulamasını güncelleştirme

Daha fazla veri eklemek veya modeli farklı senaryolarla test etmek için oyun alanı kullanın. Web uygulamasını yeni modelle güncelleştirmeye hazır olduğunuzda, Tekrar Web Uygulaması Olarak Yerleştir>...'i seçin. Var olan bir web uygulamasını güncelleştir'i seçin ve listeden mevcut web uygulamasını seçin. Yeni model mevcut web uygulamasına dağıtılır.

Kaynakları temizleme

Gereksiz Azure maliyetlerden kaçınmak için, ihtiyacınız yoksa bu hızlı başlangıçta oluşturduğunuz kaynakları silin. Azure portalında kaynakları yönetin.

İlgili içerik

• Sohbet uygulaması oluşturmaya başlama
• Azure AI SDK