Yardımcı pilota son kullanıcı kimlik doğrulaması ekleme

Önemli

Power Virtual Agents yetenekleri ve özellikleri, Microsoft Copilot genelinde üretken yapay zekaya ve gelişmiş tümleştirmelere yapılan önemli yatırımların ardından artık Microsoft Copilot Studio'nun parçasıdır.

Bazı makalelerde ve ekran görüntülerinde, belgeler ve eğitim içeriği güncelleştirilirken Power Virtual Agents'a başvurulabilir.

Kullanıcı kimlik doğrulamasını doğrudan yardımcı pilot konuşması içinden etkinleştirebilirsiniz. Kullanıcı kimlik doğrulaması ad ve kimlik gibi kullanıcı temel özelliklerini değişkenlerde almanızı sağlar. Ayrıca kullanıcıdan kimlik doğrulama düğümünü kullanarak oturum açmasını istemenizi, ilgili kullanıcı için kullanıcı belirtecini almanızı ve ardından bu belirteci kullanarak arka uç sisteminden kullanıcı bilgilerini almanızı sağlar.

Not

Web uygulamasında ve Microsoft Teams'de oluşturulan yardımcı pilotlar, Yalnızca Teams ve Power Apps için kimlik doğrulamasını kullanmak için önceden yapılandırılmış bir kimlik doğrulama özelliğiyle sunulur.

Ayrıca kullanıcılarınızın el ile oturum açmasına gerek olmaması için çoklu oturum açma (SSO) özelliğini de yapılandırabilirsiniz. Daha fazla bilgi için bkz. Web için SSO yapılandırma.

Önkoşullar

• Değişkenler kullanma
• Son kullanıcı kimlik doğrulamasını yapılandırma

Web uygulaması

Müşterilerinizin doğrudan konuşma içinde oturum açmasına izin vermek için konuya kimlik doğrulaması ekleyin. Kullanıcı değişkenleri ile konuşmayı kişiselleştirebilir ve kullanıcı adına arka uç sistemlerine erişmek için bu değişkenleri kullanabilirsiniz.

Microsoft Entra ID ile el ile kimlik doğrulamasını yapılandırma

Konularınızda kimlik doğrulamayı kullanabilmeniz için kullanıcı kimlik doğrulamasını Microsoft Entra ID ile yapılandırmanız gerekir.

Microsoft Entra ID ile kullanıcı kimlik doğrulamasını yapılandırma bölümündeki yönergeleri izleyin.

Oturum açma sistem konusu ile kullanıcı kimlik doğrulaması ekleme

Yardımcı pilot oluşturduğunuzda, Copilot Studio otomatik olarak Oturum aç adı verilen bir sistem konusu ekler. Bunu kullanmak için, yardımcı pilotunuzun kimlik doğrulamasını el ile olacak şekilde ayarlamanız ve kullanıcıların oturum açmasını gerektirmeniz gerekir. Müşteri yardımcı pilotla konuşmaya başladığında Oturum aç konusu tetiklenir ve kullanıcıdan oturum açması istenir. Oturum aç konusunu yardımcı pilotunuza uygun şekilde özelleştirebilirsiniz.

1. Copilot Studio'da yardımcı pilotunuzu açın, sayfanın üst kısmındaki Ayarlar'ı ve ardından Güvenlik öğesini seçin.

2. Kimlik Doğrulaması kutucuğunu seçin.

3. El ile Kimlik Doğrulaması'nı ve ardından Kullanıcıların oturum açmasını iste'yi seçin.

   

4. Tüm el ile kimlik doğrulama alanlarını yapılandırın.

5. Kaydet'i seçin.

Özel konuyla kullanıcı kimlik doğrulaması ekleme

Oturum aç konusu konuşmanın başında kullanıcının kimlik doğrulamasını yapar. Kullanıcının daha sonra oturum açmasına izin vermek için, herhangi bir özel konu için bir Kimlik doğrulama düğümü ekleyebilirsiniz.

Müşteriler kullanıcı adı ve parolalarını girdiği zaman, bir doğrulama kodu girmeleri istenebilir. Oturum açtıktan sonra başka bir kimlik doğrulama düğümüne ulaşsa bile tekrar kimlik doğrulaması istenmez.

1. Sayfanın üst kısmındaki Ayarlar'ı ve ardından Güvenlik öğesini seçin.

2. Kimlik Doğrulaması kutucuğunu seçin.

   Not

   Özel konuya kullanıcı kimlik doğrulaması eklemek için El ile kimlik doğrulaması'nı seçmeniz gerekir.

3. Kullanıcıların oturum açmasını iste onay kutusunun işaretini kaldırın.

4. Tüm el ile kimlik doğrulama alanlarını yapılandırın.

5. Kaydet'i seçin.

6. Sayfanın üst kısmında Konular'ı seçin.

7. Düğüm ekle ( ) >Gelişmiş>Kimlik Doğrulama'yı seçin.

8. Kimlik sağlayıcınızda yapılandırılan bir kullanıcıyı kullanarak konunuzu test edin.

Bahşiş

Başarılı oturum açma ve başarısız oturum açma için yollar oluşturmanız önemlidir. Kimlik sağlayıcısının oturum açma deneyimiyle ilgili hatalar dahil olmak üzere birçok nedenle oturum açılamayabilir.

Kimlik doğrulama değişkenleri

Yardımcı pilotunuz için kullanıcı kimlik doğrulamasını yapılandırdığınızda konularınızda kimlik doğrulama değişkenlerini kullanabilirsiniz. Aşağıdaki tabloda, kimlik doğrulaması seçeneğine göre bu değişkenlerin kullanılabilirliği karşılaştırılmaktadır.

Kimlik Doğrulama Değişkeni	Kimlik Doğrulaması Yok	Yalnızca Teams ve Power Apps için	El ile
User.DisplayName	kullanılamaz	müsait	müsait
User.FirstName	kullanılamaz	müsait	müsait
User.LastName	kullanılamaz	müsait	müsait
User.PrincipalName	kullanılamaz	müsait	müsait
User.Email	kullanılamaz	müsait	müsait
User.Id	kullanılamaz	müsait	müsait
User.IsLoggedIn	kullanılamaz	müsait	müsait
User.AccessToken	kullanılamaz	kullanılamaz	müsait
SignInReason	kullanılamaz	müsait	müsait

User.DisplayName

Uyarı

Bu değişkenin değer içerme garantisi yoktur. Konunuzun düzgün çalıştığından emin olmak için kimlik sağlayıcınızdan gelen bir kullanıcıyla test edin.

User.DisplayName değişkeni, kimlik sağlayıcısında depolanan görünen adı içerir. Kullanıcı ismini yardımcı pilota açıkça belirtmeden önce onu karşılamak veya ondan bahsetmek için bu değişkeni kullanarak konuşmayı daha fazla kişiselleştirin.

Copilot Studio, User.DisplayName değerini otomatik olarak kimlik sağlayıcısı tarafından sağlanan name üzerinden alır; profile kapsamı manuel kimlik doğrulama yapılandırdığında tanımlanmış ise. Kapsam hakkında daha fazla bilgi için bkz. Microsoft Entra ID ile kullanıcı kimlik doğrulamasını yapılandırma.

User.Id

Uyarı

Bu değişkenin değer içerme garantisi yoktur. Konunuzun düzgün çalıştığından emin olmak için kimlik sağlayıcınızdan gelen bir kullanıcıyla test edin.

User.Id değişkeni, kimlik sağlayıcısında depolanan userID'yi içerir. Değer olarak UserID'yi alan API'leri çağırmak için Power Automate akışlarında bu değişkeni kullanın.

Copilot Studio, kimlik sağlayıcısından gelen sub talebe göre User.DisplayName değerini otomatik olarak ayarlar.

User.IsLoggedIn

User.IsLoggedIn, kullanıcının oturum açma durumunu depolayan bir Boole değişkenidir. true değeri, kullanıcının oturum açtığını belirtir. Konunuzda başarılı oturum açmayı denetleyen dallanma mantığı oluşturmak veya yalnızca kullanıcının oturum açması durumunda, gerektiğinde kullanıcı bilgilerini getirmek için bu değişkeni kullanabilirsiniz.

User.AccessToken

Uyarı

User.AccessToken değişkenini yalnızca güvenilir kaynaklara geçirdiğinizden emin olun. Bu, güvenliği aşılırsa kullanıcıya zarar verebilecek şekilde kullanıcı kimlik doğrulaması bilgilerini içerir.

User.AccessToken değişkeni, kullanıcı oturum açtıktan sonra alınan kullanıcı belirtecini içerir. Arka uç API'lerine bağlanabilecekleri ve kullanıcının bilgilerini getirebilecekleri şekilde veya kullanıcı adına eylem uygulamak için bu değişkeni Power Automate akışlarına geçirebilirsiniz.

User.AccessToken öğesini İleti düğümlerinde veya güvenmediğiniz akışlarda kullanmayın.

SignInReason

SignInReason, kullanıcının oturum açması gerektiğini belirten seçim yapılan türde bir değişkendir. İki olası değeri vardır:

• SignInRequired, kullanıcının Oturum aç sistem konusunu kullanarak konuşmanın başlangıcında oturum açması gerektiğini belirtir. Kullanıcıların oturum açmalarını zorunlu kıl seçeneği açık olmalıdır.

• Initializer, kullanıcı henüz oturum açmadıysa ve konuşmada kimlik doğrulama değişkenlerini kullanan bir noktaya ulaştıysa oturum açmasının isteneceğini belirtir.

Klasik

Kimlik doğrulama değişkenleri

Yardımcı pilotunuz Yalnızca Teams ve Power Apps için veya El ile kimlik doğrulaması seçenekleriyle yapılandırıldıysa konularınız için kullanılabilir kimlik doğrulama değişkenleri kümesi olacaktır. Yardımcı pilotunuzda kimlik doğrulaması yapılandırma hakkında daha fazla bilgi için kimlik doğrulama yapılandırması belgelerine bakın.

Aşağıdaki tabloda kimlik doğrulaması yapılandırma seçeneğine göre doğrulama değişkeni kullanılabilirliği karşılaştırılmıştır:

Kimlik Doğrulama Değişkeni	Kimlik Doğrulaması Yok	Yalnızca Teams ve Power Apps için	El ile
UserDisplayName	❌	✔	✔
UserID	❌	✔	✔
IsLoggedIn	❌	❌	✔
AuthToken	❌	❌	✔

UserDisplayName değişkeni

UserDisplayName değişkeni, kimlik sağlayıcısında depolanan kullanıcı görünen adını içerir. Son kullanıcı yardımcı pilota açıkça belirtmeden önce kullanıcıyı karşılamak veya kullanıcıdan bahsetmek için bunu kullanarak botunuzu daha fazla kişiselleştirebilirsiniz.

Bu alan değeri Microsoft Entra ID name talebinden elde edilir. OAuth sağlayıcıları için bu, name talebinde depolanan değerdir. Copilot Studio, bu alanı otomatik olarak değişkene ayıklar. Bu nedenle kimlik doğrulama kapsamı kurulumunda profile öğesinin bulunduğundan emin olun.

UserID değişkeni

UserID değişkeni, kimlik sağlayıcısında depolanan kullanıcı kimliğini içerir. Power Automate akışları değer olarak UserID'yi alan API'leri çağırmak için bu değeri kullanabilir. Bu alan değeri Microsoft Entra ID sub talebinden elde edilir. OAuth sağlayıcıları için bu, sub talebinde depolanan değerdir. Copilot Studio, bu alanı otomatik olarak değişkene ayıklar.

Uyarı

UserDisplayName ve UserID değişkenlerin doldurulacağı garanti edilmez ve kimlik sağlayıcısındaki kullanıcı yapılandırmasına bağlı olarak boş dizeler olabilir. Bu değişkenler boş olsa da, konularınızın düzgün çalıştığından emin olmak için kimlik sağlayıcınızdan gelen bir kullanıcıyla test edin.

IsLoggedIn değişkeni

IsLoggedIn değişkeni, kullanıcının oturum açıp açmadığını (oturum açma başarılı yolu olarak da bilinir) veya oturum açmaması (oturum açma başarısızlık yolu ile sonuçlanmasına yol açar) belirtir.

IsLoggedIn, kullanıcının oturum açma durumunu içeren Boole türü bir değişkendir. Konunuzda (örneğin, Kimliği Doğrula düğümü eklemenin parçası olarak zaten sağlanan şablonda) başarılı oturum açmayı denetleyen dallanma mantığı oluşturmak veya yalnızca kullanıcının oturum açması durumunda, gerektiğinde kullanıcı bilgilerini getirmek için bu değişkeni kullanabilirsiniz.

AuthToken değişkeni

AuthToken değişkeni, kullanıcı oturum açtıktan sonra alınan kullanıcı belirtecini içerir. Arka uç API'lerine bağlanabilecekleri ve kullanıcının bilgilerini getirebilecekleri şekilde veya kullanıcı adına eylem uygulamak için bu değişkeni Power Automate akışlarına geçirebilirsiniz.

Uyarı

AuthToken değişkenini yalnızca güvenilir kaynaklara geçirdiğinizden emin olun. Bu, güvenliği aşılırsa kullanıcıya zarar verebilecek şekilde kullanıcı kimlik doğrulaması bilgilerini içerir.

AuthToken öğesini İleti düğümlerinde veya güvenmediğiniz akışlarda kullanmayın.

Kimlik doğrulama değişkenlerini test etme

Varsayılan olarak, Test botu bölmesi UserDisplayName ve UserID değişkenlerini doldurmak için o anda oturum açmış kullanıcının hesabını kullanır. Ancak, kimlik doğrulaması kullanan konuları test ederken, bu değişkenler için başka değerler (veya boş bir değer) kullanmak isteyebilirsiniz.

Örneğin, özel karakterlerin nasıl kullanıldığını veya değişkenin boş olması durumunda ne olacağını test etmek isteyebilirsiniz.

Bu, yalnızca Test botu bölmesi için geçerlidir. Bu bölümde açıklanan komutları kanala dağıtılan yayımlanmış bir yardımcı pilotta kullanamazsınız.

Aşağıdaki tabloda bu değişkenleri dolduracak komutlar listelenmektedir. Komutu normalde yardımcı pilotla sohbet ediyormuşsunuz gibi Test botu bölmesine girin. Başarılı olursa yardımcı pilotta bir onay iletisi alırsınız. Yardımcı pilotunuz kimlik doğrulaması kullanmıyorsa bir hata iletisi alırsınız.

Test botu bölmesini sıfırlarsanız (veya Test botu'nun otomatik olarak sıfırlanmasına neden olabilecek konu değişiklikleri yaparsanız) komutları yeniden göndermeniz gerekir.

Değişken	Özel değer komutu	Boş değer komutu
UserDisplayName	/debug set bot.UserDisplayName "Value"	/debug set bot.UserDisplayName ""
UserID	Kullanılamaz	/debug set bot.UserID ""

Önemli

Güvenlik nedeniyle UserID değişkenini özel bir değerle (boş bir değer haricinde) dolduramazsınız.

"Yalnızca Teams ve Power Apps için" yapılandırmasını kullanırken kimlik doğrulama

Kimlik doğrulama seçeneğiniz Yalnızca Teams ve Power Apps için olarak ayarlanmışsa, konularınıza açıkça kimlik doğrulaması eklemeniz gerekmez. Bu yapılandırmada, Microsoft Teams'deki tüm kullanıcılar otomatik olarak Teams kimlik bilgileriyle oturum açar ve kimlik doğrulaması kartıyla açıkça oturum açmalarına gerek yoktur. Kimlik doğrulama seçeneğiniz El ile olarak ayarlanmışsa kimlik doğrulama düğümünü (Teams kanalı da dahil) eklemeniz gerekir.

Not

Kimlik doğrulama seçeneğiniz Yalnızca Teams ve Power Apps için olarak ayarlanmışsa, konularınıza açıkça kimlik doğrulaması ekleme seçeneğiniz yoktur.

Konuya kullanıcı kimlik doğrulaması ekleme

Kimlik doğrulama düğümü bir kullanıcıdan bir oturum açma kartı kullanarak oturum açmasını ister. Kullanıcı zaten oturum açtıysa, başka bir Kimlik doğrulama düğümüne erişse bile tekrar oturum açması istenmez.

Kullanıcı istemde (kimlik sağlayıcısı tarafından barındırılan) kullanıcı adını ve parolasını girdiğinde kanala bağlı olarak kullanıcıdan doğrulama kodu girmesi istenebilir. Microsoft Teams gibi bazı kanallar, kullanıcının doğrulama kodu girmesini gerektirmez.

Yardımcı pilotunuzda SSO yapılandırılmışsa kullanıcıdan oturum açma istenmeyeceğini unutmayın.

Konunuza Kimlik doğrulama düğümü eklemek için:

1. Düzenlemek istediğiniz yardımcı pilota ait Konular sayfasına gidin.

2. Kimlik doğrulaması şablonu eklemek istediğiniz konu için Yazma tuvali'ni açın.

   Not

   Yardımcı pilotunuz Dynamics 365 Customer Service'e bağlıysa, Kimlik Doğrulama düğümü, yardımcı pilotun kullanıcıları ilk kez selamlarken izlediği konuşma yolunun bir parçası olamaz; aksi takdirde oturum açma kartı iki kez gösterilir. Bunun yerine, Kimlik doğrulama düğümünü kullanıcı yanıtı tarafından tetiklenen başka bir konuya eklemeniz gerekir.

3. İleti düğümü eklemek için artıDüğüm ekle (+) öğesini seçin. Bir oturum açma deneyiminin gerçekleşmek üzere olduğunu belirtmek için yardımcı pilotun söylemesi gerekenleri girin.

   

4. İleti düğümünün altında, Düğüm ekle (+) simgesini, Eylem çağır'ı ve ardından Kimlik doğrula'yı seçin.

   

   Not

   Kimlik doğrulaması düğümü yalnızca bir iletişim kutusu ağacının sonundaki eylem seçicisinden kullanılabilir (yaprak düğüm olarak). Bu, bir iletişimin ortasına eklenemez. Eklendikten sonra, altına başka düğümler eklenebilir.

5. Seçildikten sonra bir dizi yeni düğüm otomatik olarak eklenir. Bu düğümler üst Kimlik doğrulaması düğümü içerir ve bunu başarı ve başarısızlık yolu için olan düğümler takip eder.

   

Kimliği Doğrula düğümü olmadan AuthToken kullanımı

IsLoggedIn ve AuthToken değişkenleri, Eylem çağır menü girişi tarafından sağlanan şablonu kullanmasanız bile kullanılabilir. İlk olarak kullanıcı Kimliği Doğrulama düğümünden geçmeden AuthToken değişkenini geçirirseniz bu adımda kullanıcıdan oturum açması istenir.

Kullanıcıyı her zaman oturum açmasını bekliyorsanız veya Kullanıcı farklı bir konu yeniden yönlendiriliyorsa, AuthToken değişken geçirilmesi yararlı olabilir. Kullanıcının oturum açamadığı servis taleplerini işlemek için Eylem çağır girişi tarafından sağlanan şablonu kullanmanızı öneririz.

Not

Konuşmanın ortasında oturumu kapatması durumunda konuda AuthToken değişkenini kullanan düğüme geldiğinde kullanıcıdan yeniden oturum açması istenir.

Başarı yolu

Başarı yolu, kullanıcı başarılı şekilde oturum açtığında (veya zaten oturum açtıysa) IsLoggedIn = True ve hesapları gösterir.

AuthToken değişkenini (örneğin, bir kullanıcının bilgilerini almak üzere akış kullanarak bir arka uç sistemine bağlanmak için) kullanan mantığa sahipseniz bu yoldan gidilmesi gerekir.

Hata yolu

Hata yolu, IsLoggedIn = True dışındaki tüm koşulları gösterir. Çoğu durumda hata yolu, Kullanıcı oturum açamadığından, yanlış parola kullanmış veya oturum açma deneyimini iptal ettiğinden oluşur.

Bu servis talebine değerlendirmek isteyebileceğiniz mantığa ekleyin. Örneğin, yeniden deneme veya canlı temsilciye görev aktarma seçenekleri sağladık. Özel senaryonuz ve kullanımınız için başarısızlık yolu eylemlerini özelleştirin.

Konunuzu test etme

kimlik sağlayıcınızın içinde yapılandırılan gerçek bir kullanıcıyı kullanarak konu sınadığınıza emin olun. Oturum açma başarı ve hata yollarının gösterildiğinden emin olun, böylece kullanıcınız oturum açamazsa veya kimlik sağlayıcının oturum açma deneyimi ile ilgili hata oluştuğunda sürprizle karşılaşmaz.

İlgili içerik

Ayrıca kullanıcılarınızın el ile oturum açmasına gerek olmaması için çoklu oturum açma (SSO) özelliğini de yapılandırabilirsiniz. Daha fazla bilgi için bkz. Microsoft Entra ID ile çoklu oturum açma yapılandırma.