चरों का उपयोग करें

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

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

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

आप ग्राहकों की प्रतिक्रियाओं को सहेजने और बाद में बातचीत में उनकी सामग्री का पुनः उपयोग करने के लिए चरों का उपयोग कर सकते हैं।

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

चरों को अन्य विषयों और Power Automate प्रवाहों में भी पास किया जा सकता है और उनसे वापस भी लाया जा सकता है।

वेब अप्प

चर तीन स्तरों या दायरे में मौजूद हो सकते हैं:

• विषय चरों का उपयोग केवल उन्हीं विषयों में किया जा सकता है जिनमें वे बनाए गए हैं। यह स्कोप आपके द्वारा बनाए गए वेरिएबल्स के लिए डिफ़ॉल्ट है.
• वैश्विक चर का उपयोग सभी विषयों में किया जा सकता है। आप विषय वैरिएबल को वैश्विक वैरिएबल बनाने के लिए इसका दायरा बदल सकते हैं।
• सिस्टम वेरिएबल आपके सह-पायलट के साथ स्वचालित रूप से बनाए जाते हैं। वे वार्तालाप या उपयोगकर्ता के बारे में अधिक प्रासंगिक जानकारी प्रदान करते हैं। वे सभी विषयों में उपलब्ध हैं।

परिवर्तनशील प्रकार

एक चर एक आधार प्रकार से संबद्ध होता है। प्रकार यह निर्धारित करता है कि चर में कौन से मान हो सकते हैं तथा आप इसके साथ तार्किक अभिव्यक्ति बनाते समय कौन से ऑपरेटर का उपयोग कर सकते हैं।

प्रकार	विवरण
String	पाठ को दर्शाने के लिए प्रयुक्त वर्णों का एक क्रम
Boolean	एक तार्किक मान जो केवल true या हो सकता है false
नंबर	कोई भी वास्तविक संख्या
टेबल	मानों की एक सूची, लेकिन सभी मान एक ही प्रकार के होने चाहिए
रिकॉर्ड	नाम-मूल्य युग्मों का एक संग्रह जहां मान किसी भी प्रकार के हो सकते हैं
तिथिसमय	समय के एक बिंदु के सापेक्ष एक तारीख, समय, सप्ताह का दिन या महीना
विकल्प	स्ट्रिंग मानों की एक सूची जिसमें संबंधित समानार्थी शब्द हैं
रिक्त	"कोई मान नहीं" या "अज्ञात मान" के लिए प्लेसहोल्डर; अधिक जानकारी के लिए, देखें रिक्त स्थान Power Fx

किसी वेरिएबल का प्रकार पहली बार सेट किया जाता है जब उसे कोई मान निर्दिष्ट किया जाता है। इसके बाद, उस चर का प्रकार निश्चित हो जाता है और उसे किसी अन्य प्रकार का मान नहीं दिया जा सकता। उदाहरण के लिए, एक वेरिएबल को 1 का शुरुआती मान दिया गया है और उसे नंबर प्रकार दिया गया है। इसे a String मान "apples" पर असाइन करने का प्रयास करने पर त्रुटि उत्पन्न होगी।

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

चरों का क्रम लेखन कैनवास के ऊपर से नीचे तक निर्धारित किया जाता है। अर्थात्, लेखन कैनवास के शीर्ष पर स्थित नोड्स को नीचे स्थित नोड्स से पहले माना जाता है। जब आप Condition नोड्स के साथ शाखाएँ बनाते हैं, तो शाखाएँ बाएँ से दाएँ क्रम में व्यवस्थित होती हैं। अर्थात्, सबसे बाईं शाखा के नोड्स को सबसे दाहिनी शाखा के नोड्स से पहले माना जाता है।

निकायों

Microsoft Copilot Studio उपयोगकर्ता की प्रतिक्रियाओं से एक विशिष्ट प्रकार की जानकारी की पहचान करने के लिए entities का उपयोग करता है। पहचानी गई जानकारी उस प्रकार के एक वेरिएबल में सहेजी जाती है जो जानकारी के लिए उपयुक्त है। निम्न तालिका में पूर्वनिर्मित निकायों से संबद्ध चर आधार प्रकार सूचीबद्ध है.

इकाई	चर आधार प्रकार
बहुविकल्पीय विकल्प	विकल्प
उपयोगकर्ता की पूरी प्रतिक्रिया	String
आयु	नंबर
Boolean	Boolean
शहर	String
रंग	String
महाद्वीप	String
देश या क्षेत्र	String
तिथि और समय	तिथिसमय
ईमेल करें	String
ईवेंट	String
Integer	Integer
भाषा	String
Money	नंबर
नंबर	नंबर
क्रमवाचक	नंबर
संगठन	String
प्रतिशत	नंबर
व्यक्ति का नाम	String
फ़ोन नंबर	String
रुचिकर बिंदु	String
गति	नंबर
स्टेट	String
पता	String
तापमान	नंबर
URL	String
वज़न	नंबर
ज़िप कोड	String
कस्टम निकाय	विकल्प

चर बनाएं

कोई भी नोड जो आपको आउटपुट के रूप में एक वेरिएबल का चयन करने के लिए प्रेरित करता है, जैसे कि a प्रश्न नोड, स्वचालित रूप से उचित प्रकार का आउटपुट वैरिएबल बनाता है।

उपयोग करने हेतु एक निकाय का चयन करें

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

चर का नाम बदलें

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

1. चर गुण फलक में इसे खोलने के लिए चर का चयन करें.

2. वेरिएबल नाम के अंतर्गत, अपने वेरिएबल के लिए एक नया नाम दर्ज करें।

एक चर सेट करें

आमतौर पर आप उपयोगकर्ता इनपुट को एक वेरिएबल में सहेजने के लिए a प्रश्न नोड का उपयोग करेंगे। हालाँकि, ऐसी परिस्थितियाँ हो सकती हैं जहाँ आप स्वयं मूल्य निर्धारित करना चाहें। उन मामलों में, a सेट वेरिएबल वैल्यू नोड का उपयोग करें।

1. नोड जोड़ने के लिए नोड जोड़ें (+) चुनें, और फिर एक चर मान सेट करें चुनें.

2. वेरिएबल सेट करें के अंतर्गत बॉक्स का चयन करें, और फिर नया वेरिएबल बनाएँ का चयन करें.

   

   एक नया चर बनाया गया है. इसका प्रकार अज्ञात है जब तक आप इसे कोई मान निर्दिष्ट नहीं करते।

   

3. से value के लिए, निम्न विकल्पों में से किसी एक का उपयोग करके मान निर्दिष्ट करें:

   • a शाब्दिक मान टाइप करें.
   • उसी प्रकार के मौजूदा वेरिएबल का चयन करें। यह क्रिया आपके वेरिएबल को आपके द्वारा चुने गए वेरिएबल के समान मान पर सेट करती है।
   • एक Power Fx सूत्र का उपयोग करें। Power Fx सूत्र अधिक जटिल प्रकारों के लिए उपयोगी होते हैं जहां शाब्दिक मानों का उपयोग नहीं किया जा सकता है, जैसे तालिका और रिकॉर्ड प्रकार।

शाब्दिक मूल्यों का प्रयोग करें

किसी चर मान का चयन करने के बजाय, आप किसी भी चर में शाब्दिक मान दर्ज कर सकते हैं।

नोड शाब्दिक मानों को स्ट्रिंग, संख्या या बूलियन प्रकार के रूप में व्याख्या करने का प्रयास करता है। उदाहरण के लिए, 123 को एक संख्या के रूप में समझा जाता है। यदि आप चाहते हैं कि इसकी व्याख्या एक स्ट्रिंग मान के रूप में की जाए, तो आप मान को दोहरे उद्धरण चिह्नों में लपेट सकते हैं, जैसे: "123"।

कुछ परिदृश्यों के लिए, या जहाँ आप अधिक जटिल प्रकारों का उपयोग कर रहे हैं, एक विशिष्ट प्रकार सेट करने के लिए Power Fx सूत्र का उपयोग करें।

चर फलक

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

वैरिएबल्स पैन खोलने के लिए, विषय के मेनू बार में, वैरिएबल्स का चयन करें।

चर गुण फलक

परिवर्तनीय गुण फलक में, आप किसी चर का नाम बदल सकते हैं, देख सकते हैं कि इसका उपयोग कहां किया गया है, या इसे वैश्विक चर में परिवर्तित कर सकते हैं. हालाँकि, आप इसे वैश्विक चर से वापस विषय चर में परिवर्तित नहीं कर सकते। आप यह भी चुन सकते हैं कि यह अन्य विषयों से मान प्राप्त कर सकता है या उन्हें अपना मान दे सकता है।

चर गुण फलक खोलने के लिए, चर फलक में एक चर का चयन करें. आप किसी भी नोड में चर का चयन करके चर गुण फलक भी खोल सकते हैं।

सिस्टम चर

प्रत्येक सह-पायलट में अंतर्निहित सिस्टम वैरिएबल्स होते हैं जो वार्तालाप के बारे में अतिरिक्त जानकारी प्रदान करते हैं।

सूची में सभी सिस्टम वैरिएबल नहीं दिखाए गए हैं. आपको इन छुपे हुए सिस्टम चरों तक Power Fx सूत्र के साथ पहुंचना होगा।

किसी सूत्र में सिस्टम चरों का उपयोग करने के लिए, आपको चर नाम से पहले जोड़ना होगा। Power Fx System. उदाहरण के लिए, सिस्टम चर User.DisplayName को सूत्र में शामिल करने के लिए, आपको इसे System.User.DisplayName के रूप में संदर्भित करना होगा।

नाम	Type	छिपा हुआ	परिभाषा
गतिविधि.चैनल	विकल्प	दृश्यमान	वर्तमान वार्तालाप की चैनल आईडी
गतिविधि.चैनलडेटा	कोई भी	छुपा हुआ	एक ऑब्जेक्ट जिसमें चैनल-विशिष्ट सामग्री शामिल है
गतिविधि.चैनलआईडी	string	छुपा हुआ	वर्तमान वार्तालाप की चैनल आईडी, एक स्ट्रिंग के रूप में
Activity.From.Id	string	छुपा हुआ	प्रेषक की चैनल-विशिष्ट अद्वितीय आईडी
Activity.From.Name	string	छुपा हुआ	प्रेषक का चैनल-विशिष्ट उपयोगकर्ता-अनुकूल नाम
Activity.Name	string	दृश्यमान	कार्यक्रम का नाम
गतिविधि.पाठ	string	दृश्यमान	उपयोगकर्ता द्वारा भेजा गया सबसे हाल का संदेश
क्रिया के प्रकार	विकल्प	दृश्यमान	गतिविधि का प्रकार
गतिविधि.प्रकारआईडी	string	छुपा हुआ	गतिविधि का प्रकार, एक स्ट्रिंग के रूप में
गतिविधि.मूल्य	कोई भी	छुपा हुआ	ओपन-एंडेड मूल्य
Bot.Name	string	दृश्यमान	आपके सह-पायलट का नाम
चैनल.प्रदर्शननाम	string	छुपा हुआ	चैनल का नाम प्रदर्शित करें
Conversation.Id	string	दृश्यमान	वर्तमान वार्तालाप की विशिष्ट आईडी
LastActivity.Id	string	दृश्यमान	पहले भेजी गई गतिविधि की आईडी
LastMessage.Id	string	दृश्यमान	उपयोगकर्ता द्वारा भेजे गए पिछले संदेश की आईडी
अंतिम संदेश.पाठ	string	दृश्यमान	उपयोगकर्ता द्वारा भेजा गया पिछला संदेश
Recognizer.TriggerMessage.Id	string	दृश्यमान	वर्तमान विषय को ट्रिगर करने वाले उपयोगकर्ता संदेश की आईडी
पहचानकर्ता.ट्रिगरसंदेश.पाठ	string	दृश्यमान	वह उपयोगकर्ता संदेश जिसने वर्तमान विषय को ट्रिगर किया
उपयोगकर्ता.प्रदर्शननाम	string	दृश्यमान	साइन-इन किए गए उपयोगकर्ता का प्रदर्शन नाम

विषयों के बीच चर पास करें

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

अन्य विषयों से मान प्राप्त करें

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

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

ग्राहक से बातचीत विषय का प्रवाह इस प्रकार है:

जैसा कि टेस्ट कोपायलट पैन में दिखाया गया है, यदि यह विषय पहले ट्रिगर होता है, तो यह उपयोगकर्ता से पूछता है, "मुझे आपको क्या कॉल करना चाहिए?" यह नामक स्ट्रिंग चर में मान संग्रहीत करता है। userName userName चर को अन्य विषयों से अपना मान प्राप्त करने के लिए भी सेट किया गया है। विषय इस संदेश के साथ समाप्त होता है, "मुझे आशा है कि आपका दिन शानदार रहेगा, {userName}!"

अभिवादन विषय का प्रवाह इस प्रकार है:

जैसा कि टेस्ट कोपायलट फलक में दिखाया गया है, यदि यह विषय पहले ट्रिगर होता है, तो यह उपयोगकर्ता से पूछता है, "आपका नाम क्या है?" यह मान को एक स्ट्रिंग वेरिएबल में संग्रहीत करता है जिसे कहा जाता है। UserName विषय यह संदेश भेजता है, "आपसे मिलकर खुशी हुई, {UserName}!" इसके बाद यह टॉक टू कस्टमर विषय पर रीडायरेक्ट करता है, जो यह संदेश भेजता है, "मुझे आशा है कि आपका दिन शानदार गुजर रहा होगा, {userName}!" हालाँकि, ध्यान दें कि टॉक टू कस्टमर विषय ने फिर से उपयोगकर्ता का नाम पूछना छोड़ दिया। इसके बजाय, इसने ग्रीटिंग विषय से पारित UserName चर का मान उपयोग किया।

अंत में, यहाँ वह दूसरी बातचीत फिर से है, इस बार ग्राहक से बातचीत के परिप्रेक्ष्य से विषय:

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

गंतव्य विषय सेट करें

गंतव्य विषय को विषय पर पुनर्निर्देशित किया जा रहा है, जो अन्य विषयों से मान प्राप्त करेगा। हमारे उदाहरण में, यह ग्राहक से बात है।

1. अपना गंतव्य विषय बनाएं या उस पर जाएं.

2. एक प्रश्न नोड जोड़ें और संदेश के लिए What should I call you? दर्ज करें।

3. पहचान के अंतर्गत, पूर्वनिर्मित इकाई व्यक्ति का नाम का चयन करें.

4. चर गुण फलक खोलने के लिए चर का चयन करें. इसे नाम दें userName, और फिर चुनें अन्य विषयों से मान प्राप्त करें।

   

5. एक संदेश नोड जोड़ें.

6. संदेश बॉक्स में I hope you're having a wonderful day, लिखें.

7. चर सम्मिलित करें आइकन ({x}) का चयन करें, और फिर उपयोगकर्ता नाम का चयन करें.

8. वेरिएबल के बाद स्पेस चुनें और ! टाइप करें।

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

स्रोत विषय सेट करें

स्रोत विषय पुनर्निर्देशन करने वाला विषय है, जो वह मान प्रदान करता है जिसे गंतव्य विषय पर भेजा जाएगा। हमारे उदाहरण में, यह अभिवादन है।

1. स्रोत विषय पर जाएँ।

2. रीडायरेक्ट नोड जोड़ें और गंतव्य विषय का चयन करें.

3. + इनपुट जोड़ें का चयन करें, और फिर गंतव्य विषय से वह चर चुनें, जिस पर आप मान पास करना चाहते हैं।

   

4. > आइकन का चयन करें, और फिर उस वेरिएबल का चयन करें जिसका मान आप पास करना चाहते हैं।

   

   रीडायरेक्ट नोड इस तरह दिखना चाहिए:

   

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

मूल विषयों पर मान लौटाएँ

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

आइये, पिछले अनुभाग के उदाहरण से आगे बढ़ें। हम ग्राहक से बातचीत विषय में एक नया प्रश्न पूछेंगे, और फिर अभिवादन विषय में उत्तर लौटाएंगे।

लौटाए गए वेरिएबल के लिए स्रोत विषय सेट करें

जब आप एक वैरिएबल को विषय पर लौटा रहे हैं, तो स्रोत विषय को विषय पर रीडायरेक्ट किया जा रहा है, जो वह मान प्रदान करता है जिसे मूल विषय पर वापस भेज दिया जाएगा। इस उदाहरण में, यह ग्राहक से बात है।

1. स्रोत विषय पर जाएँ।

2. एक प्रश्न नोड जोड़ें और संदेश के लिए What city do you live in? दर्ज करें.

3. पहचानें के अंतर्गत, पूर्वनिर्मित इकाई शहर का चयन करें।

4. चर गुण फलक खोलने के लिए चर का चयन करें. नाम लो userCity, और फिर चुनें मूल विषयों पर मान लौटाएँ.

   

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

लौटाए गए चर के लिए गंतव्य विषय सेट करें

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

1. गंतव्य पर जाएं विषय.

2. आपके द्वारा स्रोत विषय में चयनित वेरिएबल रीडायरेक्ट नोड में आउटपुट वेरिएबल के रूप में दिखाई देना चाहिए।

   

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

क्लासिक

निकाय और चर प्रकार

Microsoft Copilot Studio उपयोगकर्ता की प्रतिक्रियाओं से एक विशिष्ट प्रकार की जानकारी की पहचान करने के लिए entities का उपयोग करता है। जब पहचानी गई जानकारी को सहेजा जाता है तो एक परिवर्तनीय प्रकार उसके साथ संबद्ध हो जाता है। चर प्रकार निकाय के समरूप होता है.

प्रत्येक निकाय या चर प्रकार आधार प्रकार से प्रतिचित्रित होता है, जैसा कि नीचे की टेबल में सूचीबद्ध किया गया है. आधार प्रकार उन ऑपरेटरों को निर्धारित करता है जिनका उपयोग आप संबंधित चर के साथ तार्किक अभिव्यक्ति बनाते समय कर सकते हैं। यह यह भी निर्धारित करता है कि क्या आप किसी चर को प्रवाह में फीड कर सकते हैं या इनपुट पैरामीटर के रूप में कौशल प्रदान कर सकते हैं।Bot Framework

उदाहरण के लिए, a boolean आधार प्रकार ऑपरेटर "बराबर है" को मैप करता है, जिसके संभावित मान सत्य या असत्य होते हैं। A number base प्रकार आपको संख्यात्मक ऑपरेटर देता है जैसे "बराबर है," "इससे बड़ा है," या "इससे बड़ा या बराबर है," इत्यादि।

इकाई	चर आधार प्रकार
एकाधिक विकल्प	String
उपयोगकर्ता की पूरी प्रतिक्रिया	String
आयु	नंबर
Boolean	Boolean
शहर	String
रंग	String
महाद्वीप	String
देश या क्षेत्र	String
तिथि और समय	String
अवधि	String
ईमेल करें	String
ईवेंट	String
भाषा	String
Money	String
नंबर	String
क्रमवाचक	String
संगठन	String
प्रतिशत	नंबर
व्यक्ति का नाम	String
फ़ोन नंबर	String
रुचिकर बिंदु	String
गति	नंबर
स्टेट	String
पता	String
तापमान	नंबर
URL	String
वज़न	नंबर
ज़िप कोड	String
कस्टम निकाय	String

चर बनाएं

बॉट संलेखन कैनवास में, एक प्रश्न नोड जोड़ें. नोड में एक चर स्वचालित रूप से बनाया जाता है।

1. अपने बॉट के विषय पृष्ठ पर जाएं और विषय खोलें जिसमें आप एक वेरिएबल जोड़ना चाहते हैं।

2. नोड जोड़ें (+) चुनें, और फिर प्रश्न पूछें चुनें।

   

   एक वेरिएबल जिसमें उपयोगकर्ता की प्रतिक्रिया होती है, स्वचालित रूप से बनाया जाता है।

   

उपयोग करने हेतु एक निकाय का चयन करें

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

चर का नाम बदलें

स्वचालित रूप से बनाए गए वेरिएबल एक डिफ़ॉल्ट नाम के साथ आते हैं। किसी वेरिएबल का नाम बदलने के लिए, वेरिएबल नाम का चयन करें, एक नया नाम दर्ज करें, और हो गया चुनें।

क्रिया नोड्स में चर का उपयोग करें

जब आप किसी क्रिया नोड में किसी चर का उपयोग करते हैं, तो यदि उसका आधार प्रकार किसी प्रवाह या Bot Framework कौशल के लिए निर्दिष्ट पैरामीटर प्रकार से मेल खाता है, तो आप उसे उस पैरामीटर में फीड कर सकते हैं। एक्शन नोड्स से आउटपुट नए वेरिएबल्स उत्पन्न करता है।

क्रिया नोड्स में लिटरल मान का उपयोग करें

आप मेनू से किसी चर का चयन करने के बजाय क्रिया नोड में चर इनपुट फ़ील्ड में शाब्दिक मान टाइप कर सकते हैं।

पार्स मान नोड

पार्स वैल्यू नोड आपको एक प्रकार के मान को दूसरे प्रकार के मान में बदलने की अनुमति देता है। विषय में नोड जोड़ते समय, नोड जोड़ें (+), फिर चर प्रबंधन, और पार्स मान का चयन करें।

पार्स वैल्यू नोड का उपयोग करने वाले प्रमुख परिदृश्य कच्चे JSON या अनटाइप किए गए वेरिएबल्स (जिनका मूल्य या संरचना रनटाइम तक ज्ञात नहीं है; उदाहरण के लिए चैनलडेटा) को ठोस प्रकारों में परिवर्तित करने पर ध्यान केंद्रित करते हैं।

प्रक्रिया तब शुरू होती है जब एक फ्लो को कॉल किया जाता है, जो बदले में एक API को कॉल करता है। एपीआई फिर एक परिणाम देता है। आमतौर पर, आपको इस प्रतिक्रिया को पार्स करने और एक या अधिक आदिम चर को Microsoft Copilot Studio पर वापस करने की आवश्यकता होगी। पार्स वैल्यू नोड के साथ, आप संपूर्ण API परिणाम को एक स्ट्रिंग के रूप में भेज सकते हैं:

{
    "Name": "Gary",
    "Position": "PM",
    "Company": "Microsoft",
    "FormerPositions": [{
            "Position": "Engineer"
        }
    ]
}

अब आपके पास जो स्ट्रिंग वेरिएबल है, उसे इस नए नोड का उपयोग करके Power Fx में पूर्ण इंटेलीसेंस समर्थन के साथ रिकॉर्ड वेरिएबल में परिवर्तित किया जा सकता है। नमूना डेटा का उपयोग करने वाला एक उदाहरण इस प्रक्रिया को स्पष्ट करने में मदद करेगा।

पार्स वैल्यू नोड का उपयोग करने का उदाहरण

1. एक पार्स वैल्यू नोड जोड़ें, और वह वेरिएबल चुनें जिसे आप पार्स करना चाहते हैं।

   

2. डेटा प्रकार चुनें. इस मामले में "नमूना डेटा से" चुनें।

   

3. अब आप 'नमूना JSON से स्कीमा प्राप्त करें' पर क्लिक करके JSON प्रदान कर सकते हैं। इस पर क्लिक करने से एक संपादक खुलता है जहां आप उदाहरण पेस्ट कर सकते हैं।

   

4. अंत में, निर्दिष्ट करें कि आप पार्स किए गए मान को किस वेरिएबल में रखना चाहते हैं। आमतौर पर आप इसके लिए एक नया वेरिएबल बनाएंगे।

   

   ध्यान दें कि आउटपुट वेरिएबल अब सही प्रकार का है - रिकॉर्ड।

   

अब आप अपने नये वेरिएबल का उपयोग कर सकते हैं। यहां Power Fx संपादक में, आप देख सकते हैं कि आपको विभिन्न संपत्तियों के लिए पूर्ण इंटेलिजेंस मिलता है।

JSON स्ट्रिंग्स को पार्स करने के साथ-साथ, पार्स वैल्यू नोड का मुख्य उपयोग रनटाइम पर UntypedObjects को पार्स करने के लिए होगा। इनमें से सबसे आम तब होगा जब आपको कोई ईवेंट प्राप्त होगा और आपको ईवेंट मान को पार्स करने की आवश्यकता होगी। या आप System.Activity.ChannelData प्रॉपर्टी को पार्स करना चाह सकते हैं, जो चैनल के अनुसार रनटाइम पर भिन्न होती है।

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

विषयों के बीच वेरिएबल पास करना

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

नोट

Custom Entity, Date and Time, Duration, और Multiple-choice प्रकार के वेरिएबल को विषयों के बीच पारित नहीं किया जा सकता है।

अन्य विषयों से मान प्राप्त करें

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

अन्य विषयों से मान प्राप्त करने के लिए, वेरिएबल की संपत्ति सेट करें:

1. में सवाल नोड, उस वेरिएबल का चयन करें जिसे आप अन्य विषयों से मान प्राप्त करना चाहते हैं।

2. में चर गुण फलक, नीचे विषय (सीमित दायरा) चुनना अन्य विषयों से मूल्य प्राप्त करें.

   

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

4. उस विषय पर जाएं जिस पर आप रीडायरेक्ट करना चाहते हैं। इसमें दिए गए चरणों का पालन करें दूसरे विषय पर पुनर्निर्देशित करें सही विषय पर रीडायरेक्ट करने के लिए।

5. + गंतव्य विषय के लिए इनपुट जोड़ें चुनें।

   

6. पुनर्निर्देशित विषय में एक वेरिएबल चुनें जिसमें आप वेरिएबल पास करना चाहते हैं।

   

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

   

   वेरिएबल को पुनर्निर्देशित नोड में दिखाया गया है।

   

मूल विषयों पर मान लौटाएँ

जब कोई विषय कोई प्रश्न पूछता है, या किसी अन्य तरीके से किसी क्रिया से कोई चर प्राप्त करता है, तो चर को उस मूल विषय पर वापस लौटाया जा सकता है, जो उस पर पुनर्निर्देशित किया गया था।

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

किसी चर को मूल विषय पर वापस लाने के लिए, चर का गुणधर्म सेट करें:

1. में सवाल नोड, उस वेरिएबल का चयन करें जिसे आप अन्य विषयों से मान प्राप्त करना चाहते हैं।

2. चर गुण फलक में, विषय (सीमित दायरा) के अंतर्गत मूल विषयों पर मान लौटाएँ का चयन करें.

   

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

4. उस विषय पर जाएं जिस पर आप रीडायरेक्ट करना चाहते हैं। इसमें दिए गए चरणों का पालन करें दूसरे विषय पर पुनर्निर्देशित करें सही विषय पर रीडायरेक्ट करने के लिए।

   जो वेरिएबल विषय पर लौटाया जा रहा है वह पुनर्निर्देशित विषय में दिखाया गया है। अपने विषय में लौटाए गए चर का उपयोग करें।

   

वेरिएबल्स फलक का उपयोग करना

एक साथ कई चरों की प्राप्ति या वापसी स्थिति का चयन करने के लिए चर फलक का उपयोग करें।

1. विषय के मेनू बार पर, वेरिएबल्स चुनें।

   

2. विषय में प्रत्येक वेरिएबल के लिए, चुनें कि क्या आप मानों को पारित करना चाहते हैं, प्राप्त करना चाहते हैं, या दोनों विषयों के बीच।

   

परिवर्तनीय इनपुट पर शाब्दिक मानों का उपयोग करना

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

संबंधित विषय

• सभी विषयों में वेरिएबल का पुन: उपयोग करें
• सह-पायलट के लुक और अनुभव को अनुकूलित करें