विषयों में चर का पुनः उपयोग करें

महत्त्वपूर्ण

Power Virtual Agents जनरेटिव एआई और उन्नत एकीकरण में महत्वपूर्ण निवेश के बाद, क्षमताएं और विशेषताएं अब इसका हिस्सा हैं। Microsoft Copilot Studio Microsoft Copilot

कुछ लेख और स्क्रीनशॉट इस बात का संदर्भ दे सकते हैं कि Power Virtual Agents जब हम दस्तावेज़ और प्रशिक्षण सामग्री को अपडेट करते हैं।

चर आपके सह-पायलट के प्रश्नों पर आपके ग्राहकों की प्रतिक्रियाओं को संग्रहीत करते हैं। उदाहरण के लिए, आप किसी ग्राहक का नाम नामक वेरिएबल में सहेज सकते हैं। UserName इसके बाद सह-पायलट बातचीत जारी रखते हुए ग्राहक को नाम से संबोधित कर सकता है।

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

किसी चर का पुनः उपयोग करने का एक तरीका यह है कि चर को विषयों के बीच पास किया जाए। दूसरा तरीका यह है कि चर को वैश्विक स्तर पर लागू किया जाए, और इस लेख में इसी पर चर्चा की गई है। वैश्विक चरों को इसलिए कहा जाता है क्योंकि वे संपूर्ण कोपायलट में सभी विषयों में उपलब्ध होते हैं।

वेब अप्प

सह-पायलट चर एकल उपयोगकर्ता सत्र के दौरान लागू होते हैं। आप निर्दिष्ट करते हैं कि किन चरों को सह-पायलट चरों के रूप में माना जाना चाहिए ताकि उन्हें विषय-स्तरीय चरों से अलग किया जा सके।

एक वैश्विक चर बनाएँ

आप विषय चर का दायरा बदलकर एक वैश्विक चर बनाते हैं।

1. एक चर बनाएँ या एक मौजूदा चर को खोलने के लिए चर फलक का उपयोग करें।

2. चर गुण फलक पर, वैश्विक (कोई भी विषय पहुँच सकता है) का चयन करें.

   चर नाम को विषय-स्तरीय चर से अलग करने के लिए उपसर्ग Global. दिया जाता है। उदाहरण के लिए, चर UserName को Global.UserName के रूप में प्रदर्शित किया जाता है।

   

3. विषय को सहेजें.

   वैश्विक चर का नाम सभी विषयों में अद्वितीय होना चाहिए। यदि कोई विवाद है, तो आपको अपने विषय को सहेजने से पहले चर का नाम बदलना होगा।

वैश्विक चर का उपयोग करें

जब आप किसी संदेश नोड या प्रश्न नोड में सह-पायलट संदेश लिख रहे हों, तो विषय के लिए उपलब्ध चरों को देखने के लिए {x} आइकन का चयन करें। वैश्विक चर किसी भी विषय चर के साथ कस्टम टैब में दिखाई देते हैं। चरों को वर्णानुक्रम में सूचीबद्ध किया गया है।

वैश्विक चर का उपयोग करके सभी विषय खोजें

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

1. संलेखन कैनवास में एक वैश्विक चर का चयन करें, या चर फलक खोलें और एक वैश्विक चर का चयन करें.

2. चर गुण फलक पर, संदर्भ अनुभाग में, उन विषयों में से किसी एक का चयन करें जहां चर का उपयोग सीधे उस विषय और नोड पर जाने के लिए किया जाता है।

   

वैश्विक चरों का जीवनचक्र

डिफ़ॉल्ट रूप से, वैश्विक चर का मान सत्र समाप्त होने तक बना रहता है। चर मान साफ़ करें नोड वैश्विक चर के मानों को रीसेट करता है और इसका उपयोग रीसेट वार्तालाप सिस्टम विषय में किया जाता है। विषय को या तो पुनर्निर्देशन द्वारा ट्रिगर किया जा सकता है या जब उपयोगकर्ता कोई ट्रिगर वाक्यांश टाइप करता है जैसे कि "फिर से शुरू करें।" उस स्थिति में, सभी वैश्विक चर रीसेट हो जाते हैं।

बाह्य स्रोतों से वैश्विक चर का मान सेट करें

यदि आप यह सुनिश्चित करना चाहते हैं कि सह-पायलट किसी संदर्भ के साथ बातचीत शुरू करे, तो आप किसी वैश्विक चर को किसी बाह्य स्रोत से आरंभ कर सकते हैं। मान लीजिए कि आपकी साइट को उपयोगकर्ताओं को लॉग इन करना आवश्यक है। चूंकि आपका सह-पायलट पहले से ही उपयोगकर्ता का नाम जानता है, इसलिए वह ग्राहकों द्वारा पहला प्रश्न लिखने से पहले ही उनका नाम लेकर अभिवादन कर सकता है।

1. एक वैश्विक चर का चयन करें.

2. चर गुण फलक पर, बाहरी स्रोत मान सेट कर सकते हैं का चयन करें.

एम्बेडेड कोपायलट में वैश्विक वैरिएबल सेट करें

यदि आप अपने सह-पायलट को किसी सरल वेब पेज में एम्बेड कर रहे हैं, तो आप सह-पायलट के URL में चर और उनकी परिभाषाएँ जोड़ सकते हैं। या, यदि आप थोड़ा और अधिक नियंत्रण चाहते हैं, तो आप प्रोग्रामेटिक रूप से वेरिएबल्स को कॉल करने और उपयोग करने के लिए <script> कोड ब्लॉक का उपयोग कर सकते हैं।

URL की क्वेरी स्ट्रिंग में वेरिएबल नाम Global. उपसर्ग के बिना वैश्विक वेरिएबल के नाम से मेल खाना चाहिए। उदाहरण के लिए, एक वैश्विक चर Global.UserName को क्वेरी में UserName के रूप में संदर्भित किया जाएगा।

निम्नलिखित उदाहरण चरों के लिए सरल घोषणा प्रदान करते हैं। उत्पादन परिदृश्य में, आप क्वेरी पैरामीटर या चर परिभाषा के रूप में दूसरा चर पास कर सकते हैं जो पहले से ही उपयोगकर्ता के नाम को संग्रहीत कर चुका है (उदाहरण के लिए, यदि आपके पास साइन-इन स्क्रिप्ट से उपयोगकर्ता नाम है).

वेरिएबल्स और उनकी परिभाषाओं को क्वेरी स्ट्रिंग पैरामीटर्स प्रारूप में कोपायलट के URL में जोड़ें। botURL?variableName1=variableDefinition1&variableName2=variableDefinition2

उदाहरण के लिए:

• आपके पास एक वैश्विक चर है जिसका नाम है Global.UserName.
• आपके सहपायलट का यूआरएल है https://web.powerva.microsoft.com/webchat/bots/12345.
• अपनी वेबसाइट पर सह-पायलट वार्तालाप शुरू करते समय उपयोगकर्ता का नाम पास करने के लिए, UserName= क्वेरी स्ट्रिंग को इस प्रकार संलग्न करें: https://web.powerva.microsoft.com/webchat/bots/12345?UserName=Renata.

पैरामीटर नाम अक्षर-संवेदी होता है. username=Renata इस उदाहरण में भी काम करेगा.

कस्टम कैनवास में वैश्विक वैरिएबल जोड़ें

आप वेरिएबल को कस्टम कैनवास में भी जोड़ सकते हैं.

1. पृष्ठ पर <script> अनुभाग में, जहां आपका सह-पायलट है, चर को निम्नानुसार परिभाषित करें, variableName1 उपसर्ग के बिना चर नाम के लिए Global. और variableDefinition1 परिभाषा के लिए प्रतिस्थापित करें। एकाधिक चरों को अल्पविराम (,) से अलग करें.

      const store = WebChat.createStore({}, ({ dispatch }) => next => action => {
        if (action.type === 'DIRECT_LINE/CONNECT_FULFILLED') {
          dispatch({
             type: "WEB_CHAT/SEND_EVENT",
             payload: {
               name: "pvaSetContext",
               value: {
                  "variableName1": "variableDefinition1",
                  "variableName2": "variableDefinition2"
               }
             },
           });
         }
           return next(action);
       });
   

2. अपने <script> अनुभाग में, store को कॉल करें जब आप अपने सह-पायलट को एम्बेड करते हैं, जैसा कि निम्नलिखित उदाहरण में है जहाँ store को styleOptions के ठीक ऊपर कॉल किया जाता है (आपको BOT_ID को अपने सह-पायलट की आईडी से बदलना होगा):

   const BOT_ID = "12345-5678";
   const theURL = "https://powerva.microsoft.com/api/botmanagement/v1/directline/directlinetoken?botId=" + BOT_ID;
   
   fetch(theURL)
       .then(response => response.json())
       .then(conversationInfo => {
           window.WebChat.renderWebChat(
               {
                   directLine: window.WebChat.createDirectLine({
                       token: conversationInfo.token,
                   }),
                   store,
                   styleOptions
               },
               document.getElementById('webchat')
           );
       })
       .catch(err => console.error("An error occurred: " + err));
   

क्लासिक

बॉट चर एक एकल उपयोगकर्ता सत्र के दौरान लागू होते हैं. यह आप निर्दिष्ट करते हैं कि किस चर को बॉट चर के रूप में माना जाना चाहिए ताकि उनमें और विषय-स्तरीय चरों में भिन्नता दिखाया जा सके.

बॉट वैरिएबल सेट करें

आपके द्वारा एक बॉट चर निर्धारित करने के बाद, यह सभी विषयों के लिए उपलब्ध होगा.

जब आप बॉट संदेश लिखते समय संदेश नोड या प्रश्न नोड में {x} बटन का चयन करते हैं, तो आप देखेंगे कि बॉट वैरिएबल उपलब्ध है. चरों को वर्णानुक्रम में क्रमबद्ध किया जाता है, इसलिए आप पाएंगे कि सभी बॉट चरों को चर मेनू में एक साथ समूहीकृत किया गया है क्योंकि वे सभी bot. से शुरू होते हैं।

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

किसी वैरिएबल को बॉट वैरिएबल के रूप में सेट करके उसे विभिन्न विषयों में पुनः उपयोग करें

1. संलेखन कैनवास में किसी भी चर का चयन करें.

2. चर गुण फलक पर, उपयोग के अंतर्गत, बॉट (कोई भी विषय पहुँच सकता है) का चयन करें।

3. चर नाम को विषय-स्तरीय चर से अलग करने के लिए एक उपसर्ग स्ट्रिंग bot. दी जाएगी। उदाहरण के लिए, चर UserName को अब bot.UserName के रूप में दिखाया गया है।

नोट

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

बॉट चर का प्रबंधन करें

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

बॉट वैरिएबल की परिभाषा के स्रोत पर जाएं

1. संलेखन कैनवास में किसी भी चर का चयन करें.

2. चर गुण फलक पर, स्रोत पर जाएँ का चयन करें.

यह आपको उस विषय की आसंधि में ले जाएगा जहां बॉट चर बनाया गया था.

बॉट वैरिएबल का उपयोग करके सभी विषय खोजें

1. संलेखन कैनवास में किसी भी बॉट चर का चयन करें.

2. चर गुण फलक पर, द्वारा प्रयुक्त अनुभाग में, उन विषयों में से किसी एक का चयन करें जहां चर का उपयोग सीधे उस विषय और नोड पर जाने के लिए किया जाता है।

बॉट चर आरंभीकरण

यदि किसी बॉट चर को आरंभीकृत (या "भरा हुआ") किए जाने से पहले ट्रिगर किया जाता है, तो बॉट स्वचालित रूप से विषय के उस भाग को ट्रिगर कर देगा, जहां बॉट चर को पहली बार परिभाषित किया गया है - भले ही वह किसी भिन्न विषय में हो - मूल विषय पर लौटने से पहले। यह वार्तालाप को बाधित किये बिना बॉट को सभी चरों को भरने की अनुमति देता है.

उदाहरण के लिए, ग्राहक "अपॉइंटमेंट बुकिंग" विषय पर वार्तालाप शुरू करता है, जिसमें एक बॉट वैरिएबल bot.UserName का उपयोग किया जाता है। हालाँकि, bot.UserName चर को सबसे पहले "स्वागत" विषय में परिभाषित किया गया है।

जब बातचीत "अपॉइंटमेंट बुकिंग" विषय में उस बिंदु पर पहुंचती है जहां bot.UserName का संदर्भ दिया गया है, तो बॉट सहजता से उस प्रश्न नोड पर पहुंच जाएगा जहां bot.UserName को सबसे पहले परिभाषित किया गया है।

ग्राहक द्वारा प्रश्न का उत्तर देने के बाद, बॉट "समयादेश बुकिंग" विषय को दोबारा आरंभ करेगा.

Power Automate प्रवाह या स्किल के माध्यम से क्रियाओं को क्रियान्वित करते समय बॉट चर का व्यवहार

कभी-कभी, आप चैटबॉट में एक चर को शुरू करने या भरने के लिए एक प्रवाह या स्किल का उपयोग कर सकते हैं.

हालाँकि, जब कोई उपयोगकर्ता चैटबॉट के साथ बातचीत करता है, तो हो सकता है कि वेरिएबल को बातचीत के पहले के बिंदु पर भरा गया हो, या हो सकता है कि आपने वेरिएबल को पहले ही बाहरी रूप से सेट कर दिया हो। ...

इस स्थिति में, प्रवाह या स्किल अभी भी चलेगा और चर में ओवरराइट होकर भर जाएगा, जो कुछ भी पहले चर में संग्रहित किया गया था.

बॉट चर जीवनचक्र और उसके मान को रीसेट करता है

बॉट चर किसी भी विषय से सुलभ हैं, और बॉट चर का निर्दिष्ट मान पूरे सत्र में बना रहता है।

मान केवल तभी साफ़ किया जाता है जब बॉट उपयोगकर्ता को स्टार्ट ओवर सिस्टम विषय पर रीडायरेक्ट किया जाता है, या जब उपयोगकर्ता सीधे इस विषय को ट्रिगर करता है (उदाहरण के लिए, स्टार्ट ओवर टाइप करके)। इस स्थिति में, सभी बॉट चर रीसेट हो जाएंगे और उनका कोई मान नहीं होगा।

बाह्य स्रोतों से एक बॉट चर का मान सेट करें

आप बाहरी स्रोत के साथ आरंभ करने हेतु एक बॉट चर सेट कर सकते हैं. यह बॉट को कुछ संदर्भ के साथ वार्तालाप आरंभ करने देता है.

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

बाहरी स्रोत से बॉट वैरिएबल सेट करें

1. संलेखन कैनवास में किसी भी चर का चयन करें.

2. चर गुण फलक पर, उपयोग अनुभाग में, चेकबॉक्स बाहरी स्रोत मान सेट कर सकते हैं का चयन करें.

1. यदि आप अपने बॉट को किसी साधारण वेबपेज में एम्बेड कर रहे हैं, तो आप वेरिएबल्स और उनकी परिभाषाओं को जोड़ सकते हैं, या आप प्रोग्रामेटिक रूप से वेरिएबल्स को कॉल करने और उपयोग करने के लिए कोड ब्लॉक का उपयोग कर सकते हैं।<script>

   नोट

   क्वेरी स्ट्रिंग में वेरिएबल का नाम बॉट वेरिएबल से मेल खाना चाहिए, बिना bot. उपसर्ग के. उदाहरण के लिए, एक बॉट चर bot.UserName को इस रूप में प्रस्तुत किया जाना चाहिए UserName=.

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

वेरिएबल को एम्बेडेड बॉट में जोड़ने के लिए

1. बॉट के URL में वेरिएबल और उनकी परिभाषाएँ क्वेरी स्ट्रिंग पैरामीटर्स ( botURL?variableName1=variableDefinition1&variableName2=variableDefinition2 के प्रारूप में) के रूप में जोड़ें, उदाहरण के लिए:

   • आपके पास एक बॉट वैरिएबल है जिसका नाम है bot.UserName.
   • आपके बॉट का यूआरएल है https://web.powerva.microsoft.com/webchat/bots/12345.
   • किसी वेबसाइट पर बॉट वार्तालाप प्रारंभ करते समय उपयोगकर्ता नाम पास करने के लिए, आप UserName= क्वेरी स्ट्रिंग को https://web.powerva.microsoft.com/webchat/bots/12345?UserName=Renata के रूप में संलग्न कर सकते हैं.

2. पैरामीटर नाम अक्षर-संवेदी होता है. इसका मतलब है username=Renata इस उदाहरण में भी काम करेगा।

वेरिएबल को कस्टम कैनवास में जोड़ने के लिए

1. जिस पृष्ठ पर आपका बॉट है, उसके <script> अनुभाग में, चर को इस प्रकार परिभाषित करें, variableName1 उपसर्ग के बिना चर नाम के लिए bot. और परिभाषा के लिए variableDefinition1 प्रतिस्थापित करें। एकाधिक चरों को अल्पविरामों से अलग करें ,.

      const store = WebChat.createStore({}, ({ dispatch }) => next => action => {
        if (action.type === 'DIRECT_LINE/CONNECT_FULFILLED') {
          dispatch({
             type: "WEB_CHAT/SEND_EVENT",
             payload: {
               name: "pvaSetContext",
               value: {
                  "variableName1": "variableDefinition1",
                  "variableName2": "variableDefinition2"
               }
             },
           });
         }
           return next(action);
       });
   

2. अपने <script> सेक्शन में, जब आप अपना बॉट एम्बेड करते हैं, तो store को कॉल करें, जैसा कि निम्नलिखित उदाहरण में है जहाँ store को उसके ठीक ऊपर कॉल किया जाता है जहाँ styleOptions को कॉल किया जाता है (आपको BOT_ID को अपनी आईडी से बदलना होगा):

   const BOT_ID = "12345-5678";
   const theURL = "https://powerva.microsoft.com/api/botmanagement/v1/directline/directlinetoken?botId=" + BOT_ID;
   
   fetch(theURL)
       .then(response => response.json())
       .then(conversationInfo => {
           window.WebChat.renderWebChat(
               {
                   directLine: window.WebChat.createDirectLine({
                       token: conversationInfo.token,
                   }),
                   store,
                   styleOptions
               },
               document.getElementById('webchat')
           );
       })
       .catch(err => console.error("An error occurred: " + err));
   

बॉट चर को हटाएँ

अन्य विषयों में उपयोग किए गए बॉट चर को हटाते समय, विषयों में उस चर के संदर्भों को Unknown के रूप में चिह्नित किया जाएगा।

ऑपरेशन की पुष्टि करने से पहले आपको बॉट चर को हटाने के बारे में एक चेतावनी मिलेगी.

वे आसंधियां जिनमें हटाए गए बॉट चर का संदर्भ अंतर्विष्ट है, आपको बताएँगे कि उनमें एक अज्ञात चर समाविष्ट है.

विलोपित किये गए बॉट चर के संदर्भों को अंतर्विष्ट करने वाली आसंधियों के साथ वाले विषय कार्य करना बंद कर सकते हैं. सुनिश्चित करें कि आप प्रकाशन से पहले हटाए गए चर का उपयोग कर रहे सभी विषयों को हटा दें या ठीक कर लें.

प्रमाणीकरण-संबंधित बॉट चर

बॉट के प्रमाणीकरण सेटअप के आधार पर, आपके पास उपलब्ध प्रमाणीकरण प्रदाता से संबद्ध बॉट चर का एक सेट होगा. कौन से चर उपलब्ध हैं और उनका उपयोग कैसे किया जाए, इसके बारे में विस्तृत जानकारी के लिए, बॉट में अंतिम-उपयोगकर्ता प्रमाणीकरण जोड़ें Microsoft Copilot Studio दस्तावेज़ विषय देखें।

टीमें

Teams में कोपायलट वैरिएबल का उपयोग करके सभी विषय खोजें

1. संलेखन कैनवास में किसी भी सह-पायलट चर का चयन करें.

2. चर गुण फलक पर, द्वारा प्रयुक्त अनुभाग में, उन विषयों में से किसी एक का चयन करें जहां चर का उपयोग सीधे उस विषय और नोड पर जाने के लिए किया जाता है।

   

सह-पायलट चर हटाएं

अन्य विषयों में प्रयुक्त सह-पायलट चर को हटाते समय, विषयों में उस चर के संदर्भों को Unknown के रूप में चिह्नित किया जाएगा।

ऑपरेशन की पुष्टि करने से पहले आपको कोपायलट वेरिएबल को हटाने के बारे में चेतावनी प्राप्त होगी।

हटाए गए कोपायलट चर के संदर्भ वाले नोड आपको बताएंगे कि उनमें एक अज्ञात चर मौजूद है।

हटाए गए सह-पायलट चरों के संदर्भ वाले नोड्स वाले विषय काम करना बंद कर सकते हैं। सुनिश्चित करें कि आप प्रकाशन से पहले हटाए गए चर का उपयोग कर रहे सभी विषयों को हटा दें या ठीक कर लें.

सह-पायलट चरों का उन्नत उपयोग

प्रमाणीकरण, बाहरी स्रोत और आरंभिक प्रवाह सहित सह-पायलट चरों का उपयोग करने वाले जटिल और उन्नत परिदृश्यों पर अधिक विवरण के लिए, इस आलेख का वेब ऐप संस्करण देखें। Microsoft Copilot Studio

संबंधित विषय

• चर का उपयोग करें
• सह-पायलट के लुक और अनुभव को अनुकूलित करें