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

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

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

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

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

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

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

वेब अनुप्रयोग

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

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

चर प्रकार

एक चर एक आधार प्रकार के साथ जुड़ा हुआ है। प्रकार निर्धारित करता है कि चर में कौन से मान हो सकते हैं और वे ऑपरेटर जिनका उपयोग आप इसके साथ तार्किक व्यंजक बनाते समय कर सकते हैं.

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

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

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

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

निकायों

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

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

चर बनाएं

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

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

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

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

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

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

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

एक चर सेट करें

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

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. विषय को सहेजें.

क्लासिक

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

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

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

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

इकाई	चर आधार प्रकार
एकाधिक विकल्प	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 को कॉल करता है। इसके बाद API परिणाम लौटाता है। आमतौर पर, आपको इस प्रत्युत्तर को पार्स करना होगा और एक या अधिक प्राथमिक चर को 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 प्रॉपर्टी को पार्स करना चाह सकते हैं, जो चैनल के अनुसार रनटाइम पर बदलती रहती है।

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

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

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

नोट

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

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

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

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

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

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

   

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

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

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

   

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

   

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

   

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

   

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

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

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

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

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

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

   

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

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

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

   

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

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

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

   

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

   

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

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

संबंधित सामग्री

• विषयों में चर का पुनः उपयोग करें
• एक को-पायलट के रंगरूप को अनुकूलित करें