Power Virtual Agents बॉट में अंतिम उपयोगकर्ता प्रमाणीकरण जोड़ें

Power Virtual Agents के उस संस्करण को चुनें, जिसका आप यहाँ उपयोग कर रहे हैं:

आप Power Virtual Agents बॉट वार्तालाप में सीधे उपयोगकर्ता प्रमाणीकरण सक्षम कर सकते हैं. उपयोगकर्ता प्रमाणीकरण का अर्थ है कि आप उपयोगकर्ता के मूल गुण जैसे नाम और ID, बॉट वैरिएबल में प्राप्त कर सकते हैं, लेकिन उपयोगकर्ता को प्रमाणीकरण नोड का उपयोग करके साइन इन करने के लिए भी संकेत देता है, उस उपयोगकर्ता के लिए उपयोगकर्ता टोकन पुनर्प्राप्त करता है और उसके बाद उस टोकन का उपयोग बैक-एंड सिस्टम से उपयोगकर्ता की जानकारी पुनर्प्राप्त करने के लिए करता है.

आप एकल साइन-ऑन (SSO) भी कॉन्फ़िगर कर सकते हैं, ताकि आपके उपयोगकर्ताओं को मैन्युअल रूप से साइन इन करने की आवश्यकता न हो.

महत्वपूर्ण

इस सुविधा का उपयोग करने से पहले, आपको अंतिम-उपयोगकर्ता प्रमाणीकरण कॉन्फ़िगरेशन निर्देशों का पालन करना चाहिए.

पूर्वावश्यकताएँ

प्रमाणीकरण चर

यदि आपका बॉट "केवल टीमों के लिए" या "मैनुअल" प्रमाणीकरण विकल्पों के साथ कॉन्फ़िगर किया गया है, तो आपके पास आपके विषयों में उपलब्ध प्रमाणीकरण चर का एक सेट होगा. अपने बॉट में प्रमाणीकरण कैसे कॉन्फ़िगर करें, इस बारे में अधिक जानकारी के लिए प्रमाणीकरण कॉन्फ़िगरेशन दस्तावेज़ देखें.

निम्न तालिका प्रमाणीकरण कॉन्फ़िगरेशन विकल्प द्वारा प्रमाणीकरण चर उपलब्धता की तुलना करती है:

प्रमाणीकरण चर कोई प्रमाणीकरण नहीं केवल Teams के लिए Manual
UserDisplayName ✔️ ✔️
UserID ✔️ ✔️
IsLoggedIn ✔️
AuthToken ✔️

UserDisplayName चर

UserDisplayName चर में पहचान प्रदाता में संग्रहित उपयोगकर्ता का प्रदर्शन नाम है. आप इस चर का उपयोग अंतिम उपयोगकर्ता का अभिवादन या उसे संदर्भित करने के लिए कर सकते हैं और उपयोगकर्ता को यह स्पष्ट रूप से बॉट को बताना भी नहीं होता है, जिससे यह अधिक व्यक्तिगत हो जाता है.

यह फ़ील्ड मान Azure Active Directory (Azure AD)name दावे से प्राप्त किया जाता है. OAuth प्रदाताओं के लिए, यह name दावे में संग्रहित मान है. Power Virtual Agents स्वचालित रूप से इस फ़ील्ड को चर में निकालता है, इसलिए सुनिश्चित करें कि आपके पास profile है, जो आपके प्रमाणीकरण कार्यक्षेत्र सेटअप का भाग है.

UserID चर

UserID चर में पहचान प्रदाता में संग्रहित उपयोगकर्ता की ID होती है. इस मान का उपयोग Power Automate प्रवाहों द्वारा किया जा सकता है, ताकि उन API को कॉल किया जा सके, जो मान के रूप में UserID को लेते हैं. यह फ़ील्ड मान Azure AD sub दावे से प्राप्त किया जाता है. OAuth प्रदाताओं के लिए, यह sub दावे में संग्रहित मान है. Power Virtual Agents स्वचालित रूप से इस फ़ील्ड को चर में निकालता है.

चेतावनी

UserDisplayName और UserID चर को भरे जाने की गारंटी नहीं है और पहचान प्रदाता में उपयोगकर्ता कॉन्फ़िगरेशन के आधार पर रिक्त स्ट्रिंग हो सकते हैं. यह सुनिश्चित करने के लिए कि आपके विषय सही ढंग से काम करते हैं अपने पहचान प्रदाता के उपयोगकर्ता के साथ परीक्षण करें, भले ही ये चर रिक्त हों.

IsLoggedIn चर

IsLoggedIn चर इंगित करता है कि क्या उपयोगकर्ता लॉग इन है (या तो लॉग इन करने या पहले से लॉग इन होने के परिणामस्वरूप, जिसे लॉगिन सफलता पथ भी कहा जाता है) या लॉग इन नहीं किया गया है (जिसके परिणामस्वरूप लॉगिन विफलता पथ होगा).

IsLoggedIn एक बूलियन-प्रकार का चर है जिसमें उपयोगकर्ता के लिए साइन इन की गई स्थिति शामिल है. आप इस चर का उपयोग अपने विषयों में ब्रांचिंग तर्क बनाने के लिए कर सकते हैं जो एक सफल साइन-इन (उदाहरण के लिए, पहले से दिए गए टेम्प्लेट में प्रमाणीकृत करें नोड जोड़ने के हिस्से के रूप में), या अवसरवादी रूप से उपयोगकर्ता की जानकारी केवल तभी प्राप्त करें जब उपयोगकर्ता साइन इन हो.

AuthToken चर

AuthToken चर में उपयोगकर्ता का टोकन शामिल होता है, जिसे उपयोगकर्ता द्वारा साइन इन करने के बाद प्राप्त किया जाता है. आप इस चर को Power Automate प्रवाह पर पास कर सकते हैं ताकि वे बैक-एंड API से जुड़ सकें और उपयोगकर्ता की जानकारी प्राप्त कर सकें, या उपयोगकर्ता की ओर से कार्रवाइयां कर सकें.

चेतावनी

सुनिश्चित करें कि आप केवल विश्वसनीय स्रोतों के लिए AuthToken चर पास कर रहे हैं. इसमें उपयोगकर्ता प्रमाणीकरण जानकारी शामिल है, जिसमें अगर छेड़छाड़ की जाती है, तो उपयोगकर्ता को नुकसान हो सकता है.

संदेश नोड्स के भीतर या उन प्रवाह पर, जिन पर आपको भरोसा नहीं है, AuthToken का उपयोग न करें.

परीक्षण प्रमाणीकरण चर

डिफ़ॉल्ट रूप से, टेस्ट बॉट फलक पॉप-अप करने के लिए वर्तमान में साइन-इन किए गए उपयोगकर्ता के खाते का उपयोग करेगा UserDisplayName तथा UserID चर. हालाँकि, प्रमाणीकरण का उपयोग करने वाले विषयों का परीक्षण करते समय, आप इन चरों के लिए अन्य मूल्यों (या यहां तक कि एक रिक्त मान) का उपयोग करना चाह सकते हैं.

उदाहरण के लिए, आप परीक्षण कर सकते हैं कि विशेष वर्ण कैसे उपयोग किए जाते हैं, या यदि चर खाली है तो क्या होगा.

यह केवल पर लागू होता है टेस्ट बॉट फलक; आप किसी चैनल में तैनात प्रकाशित बॉट में इस खंड में वर्णित आदेशों का उपयोग नहीं कर सकते.

निम्न तालिका उन चर को सूचीबद्ध करती है जो इन चरों को आबाद करेंगे. में कमांड दर्ज करें टेस्ट बॉट जैसा कि आप आम तौर पर बॉट के साथ बातचीत कर रहे थे वैसे ही फलक. यदि आप सफल रहे तो आपको बॉट से एक पुष्टिकरण संदेश प्राप्त होगा. यदि आपका बॉट प्रमाणीकरण का उपयोग नहीं करता है, तो आपको एक त्रुटि मिलेगी.

यदि आप रीसेट करते हैं टेस्ट बॉट फलक (या आप विषय के कारण परिवर्तन करते हैं जो इसका कारण बनते हैं टेस्ट बॉट स्वचालित रूप से रीसेट करने के लिए), आपको फिर से कमांड भेजने की आवश्यकता होगी.

चर कस्टम मान कमांड खाली (रिक्त) मान कमांड
UserDisplayName /debug set bot.UserDisplayName "Value" /debug set bot.UserDisplayName ""
UserID उपलब्ध नहीं है /debug set bot.UserID ""

महत्वपूर्ण

आप आबाद नहीं कर सकते UserID सुरक्षा कारणों से एक कस्टम मूल्य (खाली या रिक्त मान के अलावा) के साथ चर.

"केवल Teams के लिए" कॉन्फ़िगरेशन का उपयोग करते समय प्रमाणीकरण

यदि आपका प्रमाणीकरण विकल्प केवल Teams के लिए पर सेट है, तो आपको अपने विषयों में स्पष्ट रूप से प्रमाणीकरण जोड़ने की आवश्यकता नहीं है. इस कॉन्फ़िगरेशन में, कोई भी उपयोगकर्ता Microsoft Teams में स्वचालित रूप से अपने Teams क्रेडेंशियल्स के माध्यम से साइन इन करता है और उन्हें प्रमाणीकरण कार्ड के साथ स्पष्ट रूप से साइन इन करने की आवश्यकता नहीं होती है. यदि आपका प्रमाणीकरण विकल्प मैनुअल पर सेट है, तो आपको प्रमाणीकरण नोड (Teams चैनल के लिए भी) को जोड़ना होगा.

नोट

यदि आपका प्रमाणीकरण विकल्प "केवल Teams के लिए" पर सेट है, तो आपके पास अपने विषयों में स्पष्ट रूप से प्रमाणीकरण जोड़ने का विकल्प नहीं होता है.

विषय में उपयोगकर्ता प्रमाणीकरण जोड़ें

प्रमाणीकरण नोड टेम्प्लेट सम्मिलित करें:

  1. जिस बॉट को आप संपादित करना चाहते हैं, उसके लिए विषय पृष्ठ पर जाएं.

  2. जिस विषय के लिए आप प्रमाणीकरण टेम्प्लेट जोड़ना चाहते हैं, उसके लिए ऑथरिंग कैनवास खोलें.

  3. संदेश नोड जोड़ने के लिए धन (+) आइकन का चयन करें. एक साइन-ऑन अनुभव होने वाला है यह इंगित करने के लिए बॉट को क्या कहना चाहिए, यह दर्ज करें.

    एक नोड जोड़ने का स्क्रीनशॉट

  4. संदेश नोड के नीचे, प्लस (+) आइकन का चयन करें, कोई एक्शन कॉल करें का चयन करें, और फिर प्रमाणित का चयन करें.

    प्रमाणित का चयन करें

  5. एक बार चुनने के बाद, कई नए नोड अपने आप जुड़ जाएंगे. इन नोड्स में एक पैरेंट प्रमाणित नोड और उसके बाद सफलता और विफलता पथ दोनों के लिए नोड्स हैं.

    नए नोड्स

    नोट

    प्रमाणित नोड केवल संवाद ट्री (लीफ़ नोड के रूप में) की क्रिया पिकर में उपलब्ध है. इसे संवाद के बीच में नहीं जोड़ा जा सकता. एक बार जोड़ने के बाद, इसके नीचे अन्य नोड जोड़े जा सकते हैं.

प्रमाणित नोड

प्रमाणीकरण नोड वह जगह है जहां उपयोगकर्ता, यदि पहले से साइन इन नहीं है, तो साइन-इन कार्ड के साथ उसे संकेत दिया जाएगा.

साइन इन के लिए अनुरोध करें

जब उपयोगकर्ता एक बार प्रॉम्प्ट में अपना उपयोगकर्ता नाम और पासवर्ड दर्ज करते हैं (पहचान प्रदाता द्वारा होस्ट किया गया) में प्रवेश करता है, तो उन्हें चैनल के आधार पर, एक मान्यता कोड दर्ज करने का संकेत दिया जा सकता है. कुछ चैनल जैसे कि Microsoft Teams में, उपयोगकर्ता को सत्यापन कोड दर्ज करने की आवश्यकता नहीं है.

ध्यान दें कि यदि आपका बॉट SSO कॉन्फ़िगर है, तो उपयोगकर्ता को साइन इन करने के लिए नहीं कहा जाएगा.

उपयोगकर्ताओं को वार्तालाप के दौरान एक बार साइन इन करने के लिए कहा जाता है, भले ही उन्हें कोई अन्य साइन इन कार्ड मिले.

एक प्रामाणिक नोड के बिना AuthToken उपयोग

IsLoggedIn और AuthToken चर तब भी उपलब्ध हैं, जब आप एक कार्रवाई कॉल करें मेनू प्रविष्टि द्वारा प्रदान किए गए टेम्पलेट का उपयोग न करें. यदि आप उपयोगकर्ता के प्रमाणीकृत करें नोड के माध्यम से गुजरे बिना AuthToken चर पास करते हैं, तो उपयोगकर्ता को उस चरण में साइन इन करने के लिए संकेत दिया जाएगा.

AuthToken चर का पास करना तब उपयोगी हो सकता है यदि आप हमेशा उपयोगकर्ता से लॉग इन करने की अपेक्षा करते हैं, या यदि आपका उपयोगकर्ता किसी भिन्न विषय से पुनर्निर्देशित किया जा रहा है. हमारा सुझाव है कि जहां उपयोगकर्ता साइन इन करने में विफल रहता है, आप उन मामलों से व्यवहार करने के लिए कार्रवाई कॉल करें प्रविष्टि द्वारा प्रदान किए गए टेम्पलेट का उपयोग करें.

नोट

यदि उपयोगकर्ता किसी वार्तालाप के बीच में साइन आउट करते हैं, यदि विषय उस नोड में आता है जो AuthToken चर का उपयोग करता है, तो विषय को नोड में फिर से साइन इन करने के लिए कहा जाएगा,.

सफलता का पथ

सफलता का पथ जहां IsLoggedIn = True के बराबर है और विचार करता है जब उपयोगकर्ता सफलतापूर्वक साइन इन कर चुका होता है (या पहले से साइन इन था).

यदि आपके पास तर्क है जो AuthToken चर का उपयोग करता है (उदाहरण के लिए, उपयोगकर्ता की जानकारी को पुनः प्राप्त करने के लिए एक प्रवाह का उपयोग करके बैक-एंड सिस्टम से कनेक्ट करने के लिए), तो इसे इस पथ के माध्यम से गुजरना चाहिए.

असफलता का पथ

विफलता का रास्ता IsLoggedIn = True के अलावा किसी भी स्थिति के बराबर है. ज़्यादातर मामलों में विफलता पथ तब होता है जब उपयोगकर्ता लॉग इन करने में विफल रहा, गलत पासवर्ड का उपयोग किया, या साइन-इन अनुभव को रद्द कर दिया.

कोई भी तर्क जोड़ें जो आप इस मामले का इलाज करने के लिए चाह सकते हैं. एक उदाहरण के रूप में, हमने पुन: प्रयास के लिए विकल्प प्रदान किए हैं या लाइव एजेंट को आगे बढ़ाने के लिए. अपने विशेष परिदृश्य और उपयोग के लिए विफलता पथ के कार्यों को अनुकूलित करें.

अपने विषय का परीक्षण

यह सुनिश्चित कर लें कि अपने पहचान प्रदाता में कॉन्फ़िगर किए गए वास्तविक उपयोगकर्ता का उपयोग करके अपने विषय का परीक्षण करें. सुनिश्चित करें कि साइन-इन सफलता और विफलता दोनों ही पथ का प्रयोग किया जाता है, ताकि कोई आश्चर्य न हो कि यदि आपका उपयोगकर्ता साइन इन करने में विफल रहता है या पहचान प्रदाता के साइन-इन अनुभव के साथ कोई त्रुटि रहती है.

नोट

Can you tell us about your documentation language preferences? Take a short survey.

The survey will take about seven minutes. No personal data is collected (privacy statement).