नोट
इस पेज तक पहुँच के लिए प्रमाणन की आवश्यकता होती है. आप साइन इन करने या निर्देशिकाओं को बदलने का प्रयास कर सकते हैं.
इस पेज तक पहुँच के लिए प्रमाणन की आवश्यकता होती है. आप निर्देशिकाओं को बदलने का प्रयास कर सकते हैं.
ग्राहकों की प्रतिक्रियाओं को संग्रहीत करने के लिए चर का उपयोग करें ताकि आप बाद में बातचीत में उनकी सामग्री का पुन: उपयोग कर सकें।
आप तार्किक अभिव्यक्तियाँ बनाने के लिए वेरिएबल्स का भी उपयोग कर सकते हैं, जो ग्राहक को विभिन्न वार्तालाप मार्गों पर गतिशील रूप से भेजती हैं। उदाहरण के लिए, किसी ग्राहक का नाम एक चर में सहेजें जिसे कहा जाता customerNameहै, और एजेंट ग्राहक को नाम से संबोधित कर सकता है क्योंकि बातचीत जारी रहती है।
आप अन्य विषयों और Power Automate प्रवाह में चर को पास कर सकते हैं और वहां से उन्हें वापस प्राप्त कर सकते हैं।
चर बनाएं
कोई भी नोड जो आउटपुट लौटाता है, जैसे कि प्रश्न नोड, स्वचालित रूप से उपयुक्त प्रकार का आउटपुट चर बनाता है।
सुझाव
नोड्स का नाम बदलें ताकि उन्हें पहचानना आसान हो जाए। सीधे नाम अपडेट करने के लिए नोड के नाम फ़ील्ड का चयन करें, या नोड के तीन बिंदुओं (...) का चयन करें और मेनू से नाम बदलें चुनें। आप कोड संपादक में नोड्स का नाम भी बदल सकते हैं।
ट्रिगर नोड्स और चरण नोड्स पर जाएँ का नाम बदलना संभव नहीं है।
नोड नाम की लंबाई 500 अक्षरों तक हो सकती है.
उपयोग करने हेतु एक निकाय का चयन करें
प्रश्न नोड डिफ़ॉल्ट रूप से बहुविकल्पीय विकल्पों का उपयोग करते हैं। किसी भिन्न पूर्वनिर्मित या कस्टम निकाय का उपयोग करने के लिए, पहचानें बॉक्स का चयन करें और फिर इच्छित जानकारी के प्रकार का चयन करें.
चर का नाम बदलें
अपने एजेंटों को बनाए रखना आसान बनाने के लिए, प्रत्येक चर के डिफ़ॉल्ट नाम को एक सार्थक नाम से बदलें।
चर का चयन करें। चर गुण पैनल प्रकट होता है.
वैरिएबल नाम के अंतर्गत, वह नाम डालें जिसे आप अपने वैरिएबल के लिए चाहते हैं.
एक चर सेट करें
सामान्यतया, आप किसी चर में उपयोगकर्ता इनपुट संग्रहीत करने के लिए एक प्रश्न नोड का उपयोग करें। हालाँकि, हो सकता है कि आप किसी चर का मान स्वयं सेट करना चाहें। उन मामलों में, सेट वैरिएबल वैल्यू नोड का उपयोग करें।
नोड के नीचे ऐड नोड
आइकन का चयन करें जिसके बाद आप एक सेट वेरिएबल वैल्यू नोड जोड़ना चाहते हैं।परिवर्तनीय प्रबंधन> का चयन करेंएक चर मान सेट करें. कैनवास पर एक सेट वेरिएबल मान नोड दिखाई देता है।
चर सेट करें के अंतर्गत बॉक्स का चयन करें. एक चर चुनें पैनल प्रकट होता है।
यदि आप जिस चर को सेट करना चाहते हैं वह पहले से मौजूद है, तो उसे चुनें।
अन्यथा, नया बनाएं चुनें. यह क्रिया एक नया चर बनाती है. इसका प्रकार अज्ञात है जब तक कि आप इसे कोई मान निर्दिष्ट नहीं करते।
मान के लिए, निम्न विकल्पों में से किसी एक का उपयोग करके कोई मान असाइन करें:
a शाब्दिक मान टाइप करें।
समान प्रकार का कोई मौजूदा चर चुनें.
Power Fx सूत्र का प्रयोग करें। Power Fx सूत्र अधिक जटिल प्रकारों के लिए उपयोगी होते हैं जहाँ शाब्दिक मानों का उपयोग नहीं किया जा सकता है, जैसे तालिका और रिकॉर्ड प्रकार।
एक्शन नोड्स में चर का उपयोग करें
जब आप किसी क्रिया नोड में एक चर का उपयोग करते हैं, तो इसका आधार प्रकार किसी प्रवाह के लिए निर्दिष्ट पैरामीटर प्रकार से मेल खाता है, या किसी बॉट Framework कौशल के लिए, आप इसे उस पैरामीटर के लिए फ़ीड कर सकते हैं। एक्शन नोड्स से आउटपुट नए चर उत्पन्न करता है।
अधिक संदर्भ के लिए, किसी विषय से एजेंट प्रवाह को कॉल करें और जानकारी पास करने के लिए इनपुट और आउटपुट चर का उपयोग करें में उदाहरण परिदृश्य देखें।
परिवर्तनीय इनपुट के लिए शाब्दिक मानों का उपयोग करें
एक नोड में जहां आप इनपुट मापदंडों के लिए एक मान सेट करते हैं, आप मान के रूप में किसी अन्य चर का चयन करने के बजाय एक शाब्दिक मान दर्ज कर सकते हैं।
नोड शाब्दिक मानों को स्ट्रिंग, संख्या या बूलियन के रूप में व्याख्या करने का प्रयास करता है। उदाहरण के लिए, 123 को एक संख्या के रूप में समझा जाता है। यदि आप चाहते हैं कि इसकी व्याख्या स्ट्रिंग मान के रूप में की जाए, तो मान को दोहरे उद्धरणों में लपेटें, जैसे: "123"।
कुछ परिदृश्यों के लिए, जैसे कि जटिल प्रकारों का उपयोग करने वाले परिदृश्यों के लिए, आपको किसी विशिष्ट प्रकार को सेट करने के लिए Power Fx सूत्र का उपयोग करने की आवश्यकता हो सकती है.
Azure Key Vault रहस्यों के लिए पर्यावरण चर का उपयोग करें
एक पर्यावरण चर कुंजी तिजोरी में एक रहस्य का संदर्भ दे सकता है। गुप्त पर्यावरण चर, अद्वितीय विचारों वाले पर्यावरण चर का एक विशेष मामला है।
Power Apps में एक गुप्त परिवेश चर बनाने के लिए, आपको एक कुंजी वॉल्ट वॉल्ट कॉन्फ़िगर करना होगा.
कोपायलट स्टूडियो को इस कुंजी वॉल्ट वॉल्ट को पढ़ने के लिए अधिकृत करने के लिए, निम्नलिखित क्रियाएं पूरी करें:
Microsoft Copilot Studio सेवा एप्लिकेशन को Key Vault Secrets उपयोगकर्ता भूमिका असाइन करें।
पर्यावरण के सभी एजेंटों को रहस्य तक पहुंचने के लिए अधिकृत करने के लिए, रहस्य पर एक टैग
AllowedEnvironmentsबनाएं और अल्पविराम द्वारा अलग की गई अनुमत पर्यावरण आईडी जोड़ें।इस तिजोरी का उपयोग करने के लिए पर्यावरण से केवल विशिष्ट एजेंटों को अधिकृत करने के लिए, एक टैग
AllowedAgentsबनाएं और एजेंट पहचानकर्ता को प्रारूप{envId}/{schemaName}में रखें। एकाधिक मानों के लिए, मानों को अल्पविराम से अलग करें.यदि आप वर्णों की अधिकतम संख्या तक पहुँच जाते हैं, लेकिन फिर भी आपको अधिक एजेंट जोड़ने की आवश्यकता है, तो वर्णनात्मक लेकिन अद्वितीय नाम वाला एक और टैग जोड़ें (उदाहरण के लिए:
AllowedAgents2)।
संवाद रनटाइम गुप्त मान को पाँच मिनट के लिए कैश करता है। यह 30 सेकंड के लिए असफल पठन को कैश करता है।
चेतावनी
एजेंट में रहस्य जोड़कर, आप इस रहस्य के मूल्य को उजागर कर सकते हैं। जो कोई भी पर्यावरण में एजेंट को संपादित कर सकता है, वह एक संदेश नोड जोड़ सकता है और किसी संदेश में गुप्त पर्यावरण चर का मान लौटा सकता है।
वेरिएबल्स पैनल
चर पैनल में, आप उन सभी चरों को देख सकते हैं जो किसी विषय के लिए उपलब्ध हैं, भले ही वे किस नोड में परिभाषित या उपयोग किए गए हों।
चर पैनल खोलने के लिए, विषय के मेनू बार पर चर का चयन करें।
प्रत्येक विषय चर के लिए, आप चुन सकते हैं कि क्या यह अन्य विषयों से अपना मान प्राप्त कर सकता है, अन्य विषयों पर अपना मान लौटा सकता है या दोनों. आप चर गुण पैनल में किसी चर का चयन करके उसके गुणों को संपादित भी कर सकते हैं।
परिवर्तनीय गुण पैनल
परिवर्तनीय गुण पैनल में, आप किसी चर का नाम बदल सकते हैं, देख सकते हैं कि आपका एजेंट इसका उपयोग कहां करता है, या इसे वैश्विक चर में परिवर्तित कर सकते हैं। आप किसी वैश्विक वैरिएबल को वापस किसी विषय चर में नहीं बदल सकते. आप यह भी चुन सकते हैं कि कोई विषय चर अन्य विषयों से मान प्राप्त कर सकता है या उन्हें अपना मान दे सकता है।
किसी चर के लिए चर गुण पैनल खोलने के लिए, चर पैनल में वांछित चर का चयन करें। आप किसी भी नोड से चर गुण पैनल भी खोल सकते हैं जो वांछित चर का चयन करके चर का उपयोग करता है।
विषयों के बीच चर पास करें
जब आप एक विषय को दूसरे पर पुनर्निर्देशित करते हैं, तो आप मूल विषय से गंतव्य विषय तक चरों के मानों को पास कर सकते हैं और गंतव्य विषय से मूल विषय तक मान भी लौटा सकते हैं। विषयों के बीच चरों को पास करना विशेष रूप से तब उपयोगी होता है जब पहले वाले विषय में पहले से ही वह जानकारी एकत्रित हो चुकी हो जिसकी बाद वाले विषय को आवश्यकता होती है। आपके उपयोगकर्ता निश्चित रूप से एक ही प्रश्न का एक से अधिक बार उत्तर न देने की सराहना करते हैं।
अन्य विषयों से मान प्राप्त करें
जब कोई विषय किसी चर को परिभाषित करता है (उदाहरण के लिए, a Question नोड में), तो एजेंट उपयोगकर्ता से चर का मान भरने के लिए प्रश्न पूछता है। यदि एजेंट ने पहले ही किसी विषय में मूल्य अर्जित कर लिया है, तो प्रश्न को दोबारा पूछने का कोई कारण नहीं है। ऐसे मामलों में, आप चर को अन्य विषयों से मान प्राप्त करें पर सेट कर सकते हैं। जब कोई अन्य विषय इस पर पुनर्निर्देशित करता है, तो वह या तो किसी चर का मान या शाब्दिक मान को इस चर में पास कर सकता है, और प्रश्न को छोड़ सकता है। उपयोगकर्ता के लिए एजेंट से बात करने का अनुभव सहज है।
यह उदाहरण दो विषयों का उपयोग करता है, अभिवादन और ग्राहक से बात करें। दोनों विषयों में ग्राहक का नाम पूछा जाता है। हालाँकि, यदि अभिवादन विषय पहले चलता है, तो ग्राहक से बात करें विषय अपना प्रश्न छोड़ देता है। इसके बजाय, यह ग्रीटिंग विषय से पारित चर के मान का उपयोग करता है।
ग्राहक से बात करें विषय का प्रवाह इस प्रकार है:
जैसा कि परीक्षण पैनल में दिखाया गया है, यदि यह विषय पहले ट्रिगर किया जाता है, तो यह उपयोगकर्ता से पूछता है, "मुझे आपको क्या कहना चाहिए?" यह मान को एक स्ट्रिंग चर में संग्रहीत करता है जिसे कहा जाता है customerName। चर को customerName अन्य विषयों से अपना मान प्राप्त करने के लिए भी सेट किया गया है। विषय इस संदेश के साथ समाप्त होता है, "मुझे आशा है कि आपका दिन बहुत अच्छा गुजर रहा होगा, customerName!"
यहाँ अभिवादन विषय का प्रवाह है:
जैसा कि परीक्षण पैनल में दिखाया गया है, यदि यह विषय पहले ट्रिगर होता है, तो यह उपयोगकर्ता से पूछता है, "आपका नाम क्या है?" यह मान को एक स्ट्रिंग चर में संग्रहीत करता है जिसे कहा जाता है customerName। विषय यह संदेश भेजता है, "आपसे मिलकर खुशी हुई, ग्राहक का नाम!" फिर यह ग्राहक से बात करें विषय पर पुनर्निर्देशित करता है, जो संदेश भेजता है, "मुझे आशा है कि आपका दिन बहुत अच्छा बीतेगा, ग्राहक का नाम!" हालाँकि, ध्यान दें कि ग्राहक से बात करें विषय ने उपयोगकर्ता का नाम फिर से पूछना छोड़ दिया। इसके बजाय, यह customerName विषय से पारित चर के मान का उपयोग करता है।
अंत में, यहाँ फिर से दूसरी बातचीत है, इस बार ग्राहक से बात करें विषय के परिप्रेक्ष्य से:
अन्य विषयों से मान प्राप्त करने के लिए विषय सेट करने के लिए चरणों के माध्यम से चलें। यह उदाहरण परिदृश्य पूर्वनिर्धारित विषय ग्रीटिंग स्रोत विषय के रूप में और गंतव्य विषय के रूप में ग्राहक से बात करें का उपयोग करता है, लेकिन समान चरण किसी भी विषय के लिए काम करते हैं जो संभव होने पर किसी पूर्व विषय से मान का उपयोग करना चाहिए।
गंतव्य विषय सेट करें
गंतव्य विषय अन्य विषयों से मान प्राप्त करता है। इस उदाहरण में, यह ग्राहक से बात करें।
एक नया विषय बनाएँ और उसे "ग्राहक से बात करें" नाम दें।
"मुझसे बात करें," "मुझसे बात करें," और "मेरे साथ चैट करें" जैसे ट्रिगर वाक्यांश जोड़ें।
एक प्रश्न नोड जोड़ें और संदेश के लिए "मुझे आपको क्या कॉल करना चाहिए?" दर्ज करें।
पहचान के अंतर्गत, पूर्वनिर्मित इकाई व्यक्ति का नाम का चयन करें.
वेरिएबल का नाम चुनें. चर गुण पैनल खुलता है.
डिफ़ॉल्ट नाम को इसके साथ
customerNameबदलें, और उसके बाद अन्य विषयों से मान प्राप्त करें का चयन करें।
एक संदेश नोड जोड़ें।
संदेश बॉक्स में, "मुझे आशा है कि आपका दिन बहुत अच्छा गुजर रहा होगा" दर्ज करें।
चर सम्मिलित करें आइकन ({x}) का चयन करें, और फिर ग्राहक नाम का चयन करें.
चर के बाद स्थान का चयन करें और एक विस्मयादिबोधक बिंदु (!) दर्ज करें।
विषय को सहेजें.
स्रोत विषय सेट करें
स्रोत विषय वह विषय है जो किसी अन्य विषय पर पुनर्निर्देशित करता है। यह मूल्य प्रदान करता है और इसे गंतव्य विषय पर भेजता है। इस उदाहरण में, यह अभिवादन है।
ग्रीटिंग विषय पर जाएं और ट्रिगर नोड को छोड़कर, डिफ़ॉल्ट नोड्स को हटा दें।
एक प्रश्न नोड जोड़ें और संदेश के लिए "आपका नाम क्या है?" दर्ज करें।
पहचान के अंतर्गत, पूर्वनिर्मित इकाई व्यक्ति का नाम का चयन करें.
डिफ़ॉल्ट नाम को
customerNameFromGreetingसे बदलें।एक संदेश नोड जोड़ें।
संदेश बॉक्स में, "आपसे मिलकर खुशी हुई," दर्ज करें।
चर सम्मिलित करें आइकन ({x}) का चयन करें, और फिर ग्राहकनामसेग्रीटिंग का चयन करें.
चर के बाद स्थान का चयन करें और एक विस्मयादिबोधक बिंदु (!) दर्ज करें।
एक रीडायरेक्ट नोड जोड़ें, और गंतव्य विषय ग्राहक से बात करें का चयन करें.
इनपुट जोड़ें का चयन करें, और फिर गंतव्य विषय से वह चर चुनें, जिसमें आप मान पास करना चाहते हैं.
इस उदाहरण में > आइकन का चयन करें, और फिर वह वेरिएबल चुनें जिसका मान आप पास करना चाहते हैं, customerNameFromGreeting.
रीडायरेक्ट नोड इस तरह दिखना चाहिए:
विषय को सहेजें.
मूल विषयों पर मान लौटाएँ
एक एजेंट में, एक विषय एक विशिष्ट जानकारी एकत्र करता है। कई अन्य विषय इसे कॉल कर सकते हैं और उम्मीद कर सकते हैं कि यह एक चर के रूप में जानकारी वापस करेगा। चर मूल विषय का हिस्सा बन जाता है और इसे किसी अन्य चर की तरह इस्तेमाल किया जा सकता है। एजेंट द्वारा प्राप्त जानकारी को सभी विषयों पर उपलब्ध कराकर, यह दृष्टिकोण वैश्विक चर की आवश्यकता को कम करता है।
आइये, पिछले अनुभाग के उदाहरण से आगे बढ़ें। आप ग्राहक से बात करें विषय में एक नया प्रश्न पूछें, और उसके बाद अभिवादन विषय के लिए उत्तर लौटाएँ।
लौटाए गए चर के लिए स्रोत विषय सेट करें
जब आप किसी विषय पर कोई चर लौटाते हैं, तो स्रोत विषय वह विषय होता है जो मूल विषय पर वापस जाने के लिए मान प्रदान करता है. इस उदाहरण में, स्रोत विषय है ग्राहक से बात करें.
स्रोत विषय पर जाएँ.
एक प्रश्न नोड जोड़ें और संदेश के लिए "आप किस शहर में रहते हैं?" दर्ज करें।
पहचानें के अंतर्गत, पूर्वनिर्मित इकाई शहर का चयन करें.
चर गुण पैनल खोलने के लिए चर का चयन करें. इसे नाम
customerCityदें, और फिर मूल विषयों पर मान लौटाएँ का चयन करें.
एक संदेश नोड जोड़ें।
चर सम्मिलित करें आइकन ({x}) का चयन करें, और फिर ग्राहक शहर का चयन करें.
संदेश बॉक्स में वेरिएबल के बाद, "वर्ष का यह समय बहुत सुंदर होगा!" दर्ज करें।
विषय को सहेजें.
लौटाए गए चर के लिए गंतव्य विषय सेट करें
जब आप किसी विषय पर कोई चर लौटाते हैं, तो गंतव्य विषय को वर्तमान विषय से मान प्राप्त होता है. निम्नलिखित उदाहरण में, गंतव्य विषय अभिवादन है।
गंतव्य विषय पर जाएँ.
आपके द्वारा स्रोत विषय में चुना गया चर रीडायरेक्ट नोड पर आउटपुट चर के रूप में दिखाई देता है।
विषय को सहेजें.
मूल्यों का विश्लेषण करें
पार्स मान नोड एक मान को एक प्रकार से दूसरे प्रकार में कनवर्ट करता है। पार्स मान नोड के लिए एक सामान्य उपयोग का उदाहरण कच्चे JSON को परिवर्तित करना है। उदाहरण के लिए, एक एजेंट एक प्रवाह को कॉल करता है जो एपीआई को कॉल करता है। एपीआई एक परिणाम देता है। आपको इस परिणाम को पार्स करने और एक या अधिक आदिम चर वापस करने का एक तरीका चाहिए। पार्स मान नोड का उपयोग करके, आप संपूर्ण एपीआई परिणाम को स्ट्रिंग के रूप में भेज सकते हैं, जैसे कि निम्नलिखित:
{
"Name": "Parker",
"Position": "Product manager",
"Company": "Contoso",
"FormerPositions": [{
"Position": "Customer service representative"
}
]
}
पार्स मान नोड स्ट्रिंग चर को रिकॉर्ड प्रकार के चर में परिवर्तित करता है। Power Fx संपादक इस प्रकार के लिए IntelliSense कोड पूर्णता और सुझाव प्रदान करता है.
JSON स्ट्रिंग्स को पार्स करने के अलावा, पार्स मान नोड के लिए एक प्रमुख उपयोग रनटाइम पर बिना टाइप किए गए ऑब्जेक्ट्स को पार्स कर रहा है। सबसे आम उपयोग का मामला तब होता है जब आपको कोई ईवेंट प्राप्त होता है और ईवेंट मान को पार्स करने की आवश्यकता होती है। या हो सकता है कि आप प्रॉपर्टी को System.Activity.ChannelData पार्स करना चाहें, जो चैनल के हिसाब से रनटाइम पर बदलती रहती है.
अगर आपको Teams से आने वाले ईवेंट की जानकारी को पार्स करना है, तो अपेक्षित ईवेंट कैसा दिख सकता है, इसका उदाहरण खोजने के लिए Teams डेवलपर दस्तावेज़ देखें. फिर आप नमूना डेटा के रूप में उदाहरण ईवेंट का उपयोग करके इस अनुभाग में दिए गए निर्देशों का पालन कर सकते हैं.
किसी विषय में पार्स मान नोड जोड़ने के लिए:
नोड के अधीन नोड जोड़ें आइकन का चयन करें जिसके बाद आप एक मान को पार्स करना चाहते हैं। परिवर्तनीय प्रबंधन को इंगित करें, और पार्स मान का चयन करें।
एक पार्स वैल्यू नोड जोड़ें, और उस वेरिएबल का चयन करें जिसे आप पार्स करना चाहते हैं।
डेटा प्रकार के लिए, नमूना डेटा से चुनें.
नमूना JSON से स्कीमा प्राप्त करें का चयन करें, खुलने वाले संपादक में वांछित JSON उदाहरण दर्ज करें, और पुष्टि करें का चयन करें।
पार्स किए गए मान को होल्ड करने के लिए वेरिएबल का चयन करें। आमतौर पर, आप एक नया चर बनाते हैं।
आउटपुट चर में अब अपेक्षित प्रकार है: रिकॉर्ड।
