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.
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.
Önemli
Oturum açma konusunun yalnızca Copilot Studio tarafından sağlanan kimlik doğrulama yöntemini sağlamak için kullanılması önerilir. Başka eylemler, akışlar veya başka kimlik doğrulama yöntemleri çağrılmak üzere değiştirilmemelidir.
Copilot Studio'da yardımcı pilotunuzu açın, sayfanın üst kısmındaki Ayarlar'ı ve ardından Güvenlik öğesini seçin.
Kimlik doğrulaması'nı seçin.
El ile Kimlik Doğrulaması'nı ve ardından Kullanıcıların oturum açmasını iste'yi seçin.
Tüm manuel kimlik doğrulama alanlarını gerektiği gibi yapılandırın.
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şsalar bile tekrar istenmezler.
Sayfanın üst kısmındaki Ayarlar'ı ve ardından Güvenlik öğesini seçin.
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.
Kullanıcıların oturum açmasını iste onay kutusunun işaretini kaldırın.
Tüm manuel kimlik doğrulama alanlarını gerektiği gibi yapılandırın.
Kaydet'i seçin.
Sayfanın üst kısmında Konular'ı seçin.
Düğüm ekle ( ) >Gelişmiş>Kimlik Doğrulama'yı seçin.
Konunuzu kimlik sağlayıcınızla yapılandırılmış bir kullanıcıyla 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ızdaki 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.
Değişkenler hakkında daha fazla bilgi için bkz: Değişkenlerle çalışma.
Kimlik doğrulama değişkeni |
Kimlik doğrulaması yok |
Microsoft ile kimlik doğrulaması yap |
El ile kimlik doğrulaması yap |
User.DisplayName |
Kullanılamaz |
Uygun |
Uygun |
User.FirstName |
Kullanılamaz |
Uygun |
Uygun |
User.LastName |
Kullanılamaz |
Uygun |
Uygun |
User.PrincipalName |
Kullanılamaz |
Uygun |
Uygun |
User.Email |
Kullanılamaz |
Uygun |
Uygun |
User.Id |
Kullanılamaz |
Uygun |
Uygun |
User.IsLoggedIn |
Kullanılamaz |
Uygun |
Uygun |
User.AccessToken |
Kullanılamaz |
Kullanılamaz |
Uygun |
SignInReason (Oturum Açma) |
Kullanılamaz |
Uygun |
Uygun |
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.
Değişken User.DisplayName
, kimlik sağlayıcısında depolanan görünen ad öğesini 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.
Değişken User.Id
, kimlik sağlayıcısında depolanan kullanıcı kimliğini 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 ne zaman oturum açması gerektiğini belirten seçim türü bir değişkendir. İki olası değeri vardır:
SignInRequired
Kullanıcının, oturum açma sistem konusu'nu kullanarak konuşmanın başında oturum açması gerektiğini belirtir. Kullanıcıların oturum açmasını gerektir seçeneği açık olmalıdır.
Initializer
Bir kullanıcı oturum açmadığında ve konuşmada kimlik doğrulama değişkenlerini kullanan bir noktaya ulaştığında, oturum açmasının istendiğini gösterir.
Kimlik doğrulama değişkenleri
Copilot'unuz Microsoft ile Kimlik Doğrulama veya El ile kimlik doğrulama seçenekleriyle yapılandırılmışsa , konularınızda bir dizi kimlik doğrulama değişkeni vardır. Yardımcı pilotunuzda kimlik doğrulamanın nasıl yapılandırılacağı hakkında daha fazla bilgi için Copilot Studio içinde kullanıcı kimlik doğrulamasını yapılandırma konusuna 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 |
Microsoft ile kimlik doğrulaması yap |
El ile |
User.DisplayName |
❌ |
✔️ |
✔️ |
User.Id |
❌ |
✔️ |
✔️ |
User.IsLoggedIn |
❌ |
❌ |
✔️ |
User.AccessToken |
❌ |
❌ |
✔️ |
UserDisplayName değişkeni
User.DisplayName
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. Sağlayıcılar için OAuth bu değer talepte name
saklanır. 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
User.Id
değişkeni, kimlik sağlayıcısında depolanan kullanıcı kimliğini içerir. Power Automate akışlar, UserID'yi değer olarak alan API'leri çağırmak için bu değeri kullanabilir.
Bu alan değeri Microsoft Entra ID sub
talebinden elde edilir. Sağlayıcılar için OAuth bu değer talepte sub
saklanır. Copilot Studio, bu alanı otomatik olarak değişkene ayıklar.
Uyarı
ve User.DisplayName
User.Id
değişkenlerinin doldurulması 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
Değişken User.IsLoggedIn
, kullanıcının oturum açıp açmadığını (oturum açmanın veya zaten oturum açmanın bir sonucu olarak, oturum açma başarılı yolu olarak da bilinir) veya oturum açıp açmadığını (oturum açma hatası yoluna neden olur) gösterir.
User.IsLoggedIn
, kullanıcının oturum açma durumunu içeren bir Boole değişkenidir. 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.
User.AccessToken değişkeni
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.
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
öğ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 tuşu, ve User.DisplayName
değişkenlerini doldurmak User.Id
için şu anda oturum açmış olan 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.
Aşağıdaki tabloda, bu değişkenleri doldurmak için kullanılan komutlar listelenmektedir. Bu komutlar yalnızca Test botupane için geçerlidir; bunları bir kanala dağıtılan yayımlanmış bir yardımcı pilotta kullanamazsınız.
İstediğiniz komutu şuraya girin: Test botu normalde yardımcı pilotla sohbet ediyormuşsunuz gibi kullanın. 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 panelini sıfırlarsanız (veya Test botu'nun otomatik olarak sıfırlanmasına neden olan bir konuda değişiklik yaparsanız), komutları yeniden göndermeniz gerekir.
Değişken |
Özel değer komutu |
Boş değer komutu |
User.DisplayName |
/debug set bot.UserDisplayName "Value" |
/debug set bot.UserDisplayName "" |
User.Id |
Kullanılamaz |
/debug set bot.UserID "" |
Önemli
Güvenlik nedeniyle, değişkeni User.Id
özel bir değerle (boş veya boş bir değer dışında) dolduramazsınız.
"Microsoft ile Kimlik Doğrulama" kullanılırken kimlik doğrulaması
Kimlik doğrulama seçeneğiniz Microsoft ile Kimlik Doğrulaması Yap olarakayarlanmış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 olarakayarlanmışsa, bir Kimlik Doğrulama düğümü eklemeniz gerekir (Teams kanalı için bile).
Not
Kimlik doğrulama seçeneğiniz Microsoft ile Kimlik Doğrulaması Yap olarakayarlanmışsa, konularınıza açıkça kimlik doğrulaması ekleme seçeneğiniz yoktur.
Konuya kullanıcı kimlik doğrulaması ekleme
Kimlik Doğrula düğümü, kullanıcıdan bir oturum açma kartıyla oturum açmasını ister. Bir kullanıcı oturum açtıktan sonra, başka bir Kimlik Doğrulama düğümüne ulaşsalar bile tekrar 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. gibi Microsoft Teams bazı kanallar, kullanıcıdan bir doğrulama kodu gerektirmez.
Yardımcı pilotunuzda SSO yapılandırılmışsa kullanıcıdan oturum açma istenmeyeceğini unutmayın.
Konunuza bir Kimlik Doğrulama düğümü eklemek için:
Düzenlemek istediğiniz yardımcı pilota ait Konular sayfasına gidin.
Kimlik doğrulama şablonunu eklemek istediğiniz konuyu 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ğrula düğümünü bir kullanıcı yanıtı tarafından tetiklenen başka bir konuya eklemeniz gerekir.
İ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.
İ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.
Yeni düğümler otomatik olarak görünür: üst öğeAuthenticate düğümü, ardından bir başarı yolu ve bir hata yolu için düğümler.
Authenticate düğümü olmadan User.AccessToken kullanımı
ve User.IsLoggedIn
User.AccessToken
değişkenleri, Eylem çağır menü girişi tarafından sağlanan şablonu kullanmasanız bile kullanılabilir. Kullanıcının Kimlik Doğrulama User.AccessToken
düğümünden geçmesine izin vermeden değişkeni geçirirseniz , kullanıcıdan bu adımda oturum açması istenir.
Kullanıcının her zaman oturum açmış olmasını bekliyorsanız veya kullanıcınız farklı bir konudan yönlendiriliyorsa değişkeni User.AccessToken
iletmek 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
Kullanıcı bir konuşmanın ortasında oturumu kapatırsa, konu değişkeni User.AccessToken
kullanan bir düğüme geldiğinde yeniden oturum açması istenir.
Başarı yolu
Başarı yolu, kullanıcının nerede User.IsLoggedIn = True
ve ne zaman başarılı bir şekilde oturum açtığını (veya zaten oturum açtığını) hesaba katar.
Değişkeni User.AccessToken
kullanan bir mantığınız varsa (örneğin, bir kullanıcının bilgilerini almak için bir akış kullanarak bir arka uç sistemine bağlanmak için), bu yolun altına girmelidir.
Hata yolu
Hata yolu, IsLoggedIn = True
dışındaki tüm koşulları gösterir. Çoğu durumda, kullanıcının oturum açamaması, yanlış parola kullanması veya oturum açma deneyimini iptal etmesi nedeniyle hata yolu 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. Hem oturum açma başarısı hem de hata yollarının kullanıldığından emin olun, bu nedenle kullanıcınız oturum açamazsa veya kimlik sağlayıcısının oturum açma deneyimiyle ilgili bir hata olursa sürprizlerle karşılaşmazsınız.