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