वेरिएबल के साथ कार्य करें
आप ग्राहकों की प्रतिक्रियाओं को सहेजने और बाद में बातचीत में उनकी सामग्री का पुनः उपयोग करने के लिए चरों का उपयोग कर सकते हैं।
आप तार्किक अभिव्यक्तियाँ बनाने के लिए चरों का भी उपयोग कर सकते हैं जो ग्राहक को गतिशील रूप से विभिन्न वार्तालाप पथों पर ले जाती हैं। उदाहरण के लिए, ग्राहक का नाम UserName नामक चर में सहेजें, और सह-पायलट बातचीत जारी रहने पर ग्राहक को नाम से संबोधित कर सकता है।
चरों को अन्य विषयों और Power Automate प्रवाहों में भी पास किया जा सकता है और उनसे वापस भी लाया जा सकता है।
चर चार स्तरों या दायरे में मौजूद हो सकते हैं:
- विषय चरों का उपयोग केवल उन्हीं विषयों में किया जा सकता है जिनमें वे बनाए गए हैं। यह स्कोप आपके द्वारा बनाए गए वेरिएबल्स के लिए डिफ़ॉल्ट है.
- वैश्विक चर का उपयोग सभी विषयों में किया जा सकता है। आप विषय चर का दायरा बदलकर उसे वैश्विक चर बना सकते हैं।
- सिस्टम चर आपके सह-पायलट के साथ स्वचालित रूप से बनाए जाते हैं। वे वार्तालाप या उपयोगकर्ता के बारे में अधिक प्रासंगिक जानकारी प्रदान करते हैं। वे सभी विषयों में उपलब्ध हैं।
- पर्यावरण चर में बनाए जाते हैं Power Platform और केवल पढ़ने के लिए होते हैं Copilot Studio. वे पैरामीटर कुंजियों और मानों को संग्रहीत करते हैं, जो फिर Copilot Studio सहित विभिन्न अन्य अनुप्रयोग ऑब्जेक्ट्स के लिए इनपुट के रूप में काम करते हैं। खपत वाली वस्तुओं से पैरामीटर को अलग करना आपको उसी परिवेश में या जब आप अन्य परिवेशों के समाधानों को स्थानांतरित करते हैं, तो मानों को बदलने देता है. विकल्प उन कंपोनेंट में हार्ड-कोडेड पैरामीटर मान छोड़ना है जो उनका उपयोग करते हैं.
परिवर्तनशील प्रकार
एक चर एक आधार प्रकार से संबद्ध होता है। प्रकार यह निर्धारित करता है कि चर में कौन से मान हो सकते हैं तथा आप इसके साथ तार्किक अभिव्यक्ति बनाते समय कौन से ऑपरेटर का उपयोग कर सकते हैं।
Type | विवरण |
---|---|
String | पाठ को दर्शाने के लिए प्रयुक्त वर्णों का अनुक्रम |
Boolean | एक तार्किक मान जो केवल true या हो सकता है false |
नंबर | कोई भी वास्तविक संख्या |
टेबल | मानों की सूची, लेकिन सभी मान एक ही प्रकार के होने चाहिए |
रिकॉर्ड | नाम-मूल्य युग्मों का एक संग्रह जहाँ मान किसी भी प्रकार के हो सकते हैं |
तिथिसमय | किसी समय बिंदु से संबंधित तिथि, समय, सप्ताह का दिन या महीना |
विकल्प | संबंधित समानार्थी शब्दों के साथ स्ट्रिंग मानों की सूची |
रिक्त | "कोई मान नहीं" या "अज्ञात मान" के लिए प्लेसहोल्डर; अधिक जानकारी के लिए, देखें रिक्त स्थान Power Fx |
किसी चर का प्रकार तब निर्धारित किया जाता है जब उसे पहली बार कोई मान निर्दिष्ट किया जाता है। इसके बाद, उस चर का प्रकार निश्चित हो जाता है और उसे किसी अन्य प्रकार का मान नहीं दिया जा सकता। उदाहरण के लिए, 1
का प्रारंभिक मान दिए गए चर को संख्या प्रकार निर्दिष्ट किया जाता है। इसे String value of "apples"
पर असाइन करने का प्रयास करने पर त्रुटि उत्पन्न होती है।
जब आप किसी सह-पायलट का परीक्षण कर रहे हों, तो एक चर अस्थायी रूप से अज्ञात प्रकार के रूप में दिखाई दे सकता है। किसी अज्ञात चर का अभी तक कोई मान नहीं है.
चरों का क्रम लेखन कैनवास के ऊपर से नीचे तक निर्धारित किया जाता है। अर्थात्, लेखन कैनवास के शीर्ष पर स्थित नोड्स को नीचे स्थित नोड्स से पहले माना जाता है। जब आप Condition नोड्स के साथ शाखाएँ बनाते हैं, तो शाखाएँ बाएँ से दाएँ क्रम में व्यवस्थित होती हैं। अर्थात्, सबसे बाईं शाखा के नोड्स को सबसे दाईं शाखा के नोड्स से पहले माना जाता है।
निकायों
Copilot Studio उपयोगकर्ता की प्रतिक्रियाओं से एक विशिष्ट प्रकार की जानकारी की पहचान करने के लिए इकाइयों का उपयोग करता है। पहचानी गई जानकारी उस प्रकार के चर में सहेजी जाती है जो जानकारी के लिए उपयुक्त है। निम्न तालिका पूर्वनिर्मित निकायों से संबद्ध चर आधार प्रकार को सूचीबद्ध करती है।
इकाई | परिवर्तनीय आधार प्रकार |
---|---|
बहुविकल्पीय विकल्प | विकल्प |
उपयोगकर्ता की पूरी प्रतिक्रिया | String |
आयु | नंबर |
Boolean | Boolean |
शहर | String |
रंग | String |
महाद्वीप | String |
देश या क्षेत्र | String |
तिथि और समय | तिथिसमय |
ईमेल करें | String |
ईवेंट | String |
Integer | Integer |
भाषा | String |
Money | नंबर |
नंबर | नंबर |
क्रमवाचक | नंबर |
संगठन | String |
प्रतिशत | नंबर |
व्यक्ति का नाम | String |
फ़ोन नंबर | String |
रुचिकर बिंदु | String |
गति | नंबर |
स्टेट | String |
पता | String |
तापमान | नंबर |
URL | String |
वज़न | नंबर |
ज़िप कोड | String |
कस्टम निकाय | विकल्प |
चर बनाएं
कोई भी नोड जो आपको आउटपुट के रूप में एक चर का चयन करने के लिए संकेत देता है, जैसे कि a प्रश्न नोड, स्वचालित रूप से उपयुक्त प्रकार का एक आउटपुट चर बनाता है।
टिप
नोड्स का नाम बदलें ताकि उन्हें पहचानना आसान हो जाए। नाम को सीधे अपडेट करने के लिए नोड के नाम फ़ील्ड का चयन करें, या नोड के अधिक आइकन (… ) का चयन करें और मेनू से नाम बदलें का चयन करें। आप कोड संपादक में नोड्स का नाम भी बदल सकते हैं।
ट्रिगर नोड्स और Go to चरण नोड्स का नाम बदलना संभव नहीं है।
नोड नाम की लंबाई 500 अक्षरों तक हो सकती है.
उपयोग करने हेतु एक निकाय का चयन करें
प्रश्न नोड्स डिफ़ॉल्ट रूप से बहुविकल्पीय विकल्पों के साथ बनाए जाते हैं। किसी भिन्न पूर्वनिर्मित या कस्टम इकाई का उपयोग करने के लिए, पहचानें बॉक्स का चयन करें और उस जानकारी का प्रकार चुनें जिसे सह-पायलट को सुनना चाहिए।
चर का नाम बदलें
जब आप वेरिएबल्स बनाते हैं तो उन्हें स्वचालित रूप से एक नाम दे दिया जाता है। सर्वोत्तम अभ्यास यह है कि आप अपने चरों को अर्थपूर्ण नाम दें, ताकि उनका उद्देश्य उन लोगों के लिए स्पष्ट हो जाए, जिन्हें आपके सह-पायलट का रखरखाव करना होता है।
चर गुण फलक में इसे खोलने के लिए चर का चयन करें.
चर नाम के अंतर्गत, अपने चर के लिए एक नया नाम दर्ज करें।
एक चर सेट करें
आम तौर पर आप उपयोगकर्ता इनपुट को किसी चर में सहेजने के लिए प्रश्न नोड का उपयोग करते हैं। हालाँकि, ऐसी परिस्थितियाँ हो सकती हैं जहाँ आप स्वयं मूल्य निर्धारित करना चाहें। उन मामलों में, सेट वैरिएबल वैल्यू नोड का उपयोग करें।
नोड जोड़ने के लिए नोड जोड़ें (+) का चयन करें, और फिर चर प्रबंधन>चर मान सेट करें का चयन करें.
वेरिएबल सेट करें के अंतर्गत बॉक्स का चयन करें, और फिर नया वेरिएबल बनाएँ का चयन करें.
एक नया चर बनाया गया है. इसका प्रकार तब तक अज्ञात रहता है जब तक आप इसे कोई मान निर्दिष्ट नहीं करते।
मूल्य के लिए , निम्न विकल्पों में से किसी एक का उपयोग करके मान निर्दिष्ट करें:
- a शाब्दिक मान टाइप करें.
- समान प्रकार का कोई मौजूदा चर चुनें. यह क्रिया आपके चर को आपके द्वारा चयनित चर के समान मान पर सेट करती है।
- एक Power Fx सूत्र का उपयोग करें। Power Fx सूत्र अधिक जटिल प्रकारों के लिए उपयोगी होते हैं जहाँ शाब्दिक मानों का उपयोग नहीं किया जा सकता है, जैसे तालिका और रिकॉर्ड प्रकार।
शाब्दिक मानों का उपयोग करें
किसी चर मान का चयन करने के बजाय, आप किसी भी चर में शाब्दिक मान दर्ज कर सकते हैं।
नोड शाब्दिक मानों को स्ट्रिंग, संख्या या बूलियन के रूप में व्याख्या करने का प्रयास करता है। उदाहरण के लिए, 123
को एक संख्या के रूप में समझा जाता है। यदि आप चाहते हैं कि इसे एक स्ट्रिंग मान के रूप में समझा जाए, तो आप मान को दोहरे उद्धरण चिह्नों में रैप कर सकते हैं, जैसे: "123"
.
कुछ परिदृश्यों के लिए, या जहाँ आप अधिक जटिल प्रकारों का उपयोग कर रहे हैं, एक विशिष्ट प्रकार सेट करने के लिए Power Fx सूत्र का उपयोग करें।
चर फलक
चर फलक वह स्थान है जहां आप विषय में उपलब्ध सभी चर देख सकते हैं, भले ही वे किस नोड में परिभाषित या उपयोग किए गए हों। प्रत्येक चर के लिए, आप यह चुन सकते हैं कि वह अन्य विषयों से अपना मान प्राप्त कर सकता है, अन्य विषयों को अपना मान लौटा सकता है, या दोनों। आप चर गुण फलक में किसी चर का चयन करके उसके गुणों को संपादित भी कर सकते हैं।
वैरिएबल्स पैन खोलने के लिए, विषय के मेनू बार में, वैरिएबल्स का चयन करें।
चर गुण फलक
परिवर्तनीय गुण फलक में, आप किसी चर का नाम बदल सकते हैं, देख सकते हैं कि इसका उपयोग कहां किया गया है, या इसे वैश्विक चर में परिवर्तित कर सकते हैं. हालाँकि, आप इसे वैश्विक चर से वापस विषय चर में परिवर्तित नहीं कर सकते। आप यह भी चुन सकते हैं कि यह अन्य विषयों से मान प्राप्त कर सकता है या उन्हें अपना मान दे सकता है।
चर गुण फलक खोलने के लिए, चर फलक में एक चर का चयन करें. आप किसी भी नोड में चर का चयन करके चर गुण फलक भी खोल सकते हैं।
परिवेश चर
पर्यावरण चर एक अवधारणा है। Power Platform पर्यावरण चर, किसी अनुप्रयोग को विभिन्न वातावरणों के बीच ले जाने के लिए मूल अनुप्रयोग जीवनचक्र प्रबंधन (ALM) परिदृश्य को सक्षम करते हैं। Power Platform इस परिदृश्य में, अनुप्रयोग बिल्कुल वैसा ही रहता है, सिवाय कुछ प्रमुख बाह्य संदर्भों के, जो स्रोत परिवेश और गंतव्य परिवेश के बीच भिन्न होते हैं।
पर्यावरण चरों का उपयोग उसी तरह करें जैसे विषय, वैश्विक, और प्रणाली चरों का उपयोग करें। एक उल्लेखनीय अंतर यह है कि आप पर्यावरण चरों का उपयोग केवल केवल पढ़ने योग्य मोड में ही कर सकते हैं। सह-पायलट लेखक Copilot Studio में पर्यावरण चर को संशोधित नहीं कर सकते। हालाँकि, व्यवस्थापक पोर्टल में पर्यावरण चर का मान बदल सकते हैं. Power Apps
Copilot Studio में पर्यावरण चर प्रकार Power Apps डेटा प्रकारों से इस प्रकार मैप होते हैं:
टाइप करें Copilot Studio | टाइप करें Power Apps |
---|---|
दशमलव संख्या | नंबर |
JSON | मान से प्रकार का पता लगाएं. यदि नहीं तो Json => अनिर्दिष्ट (सत्यापन त्रुटि) |
टेक्स्ट | string |
हां/नहीं | Boolean |
डेटा स्रोत | string |
सीक्रेट | String |
नोट
पर्यावरण चर त्रुटियाँ टेस्ट चैट में और प्रकाशन करते समय दिखाई देती हैं। हालाँकि, ये त्रुटियाँ विषय सूची में नहीं दिखाई गई हैं क्योंकि वे विषय चर नहीं हैं।
आप Copilot Studio में पर्यावरण चर को लिख या संपादित नहीं कर सकते. आपको पर्यावरण चर को बदलने या सेट करने के लिए पोर्टल का उपयोग करना होगा। Power Apps Copilot Studioसे, आप किसी पर्यावरण चर के बारे में जानकारी देखने के लिए चर फलक का उपयोग कर सकते हैं। चर फलक में मूल लेखन अनुभव के लिए एक लिंक भी है।
Azure Key Vault रहस्यों के लिए पर्यावरण चर का उपयोग करें
एक पर्यावरण चर कुंजी वॉल्ट में एक गुप्त संदर्भ दे सकता है। यह अद्वितीय विचारों वाले पर्यावरण चरों का एक विशेष मामला है।
पोर्टल में गुप्त वातावरण चर बनाने के लिए, आपको इसके कुंजी वॉल्ट को कॉन्फ़िगर करना होगा। Power Apps
इसके अतिरिक्त, आपको इस कुंजी वॉल्ट को पढ़ने के लिए अधिकृत करने के लिए निम्नलिखित क्रियाएं करनी होंगी: Copilot Studio
अनुप्रयोग को भूमिका असाइन करें.
Key Vault Secrets User
Microsoft Virtual Agents Service
परिवेश से सभी सह-पायलटों को गुप्त जानकारी तक पहुंचने के लिए अधिकृत करने के लिए, गुप्त जानकारी पर एक टैग बनाएं और अल्पविराम से अलग करके अनुमत परिवेश आईडी जोड़ें।
AllowedEnvironments
इस कुंजी वॉल्ट का उपयोग करने के लिए पर्यावरण से केवल विशिष्ट सह-पायलटों को अधिकृत करने के लिए, एक टैग
AllowedCopilots
बनाएं और सह-पायलट पहचानकर्ता को{envId}/{schemaName}
प्रारूप में डालें। एकाधिक मानों के लिए, मानों को अल्पविराम से अलग करें.
यदि आप वर्णों की अधिकतम संख्या तक पहुंच जाते हैं, लेकिन फिर भी अधिक सह-पायलट जोड़ने की आवश्यकता होती है, तो वर्णनात्मक लेकिन अद्वितीय नाम के साथ एक और टैग जोड़ें (उदाहरण के लिए: AllowedCopilots2
)।
गुप्त मान को डायलॉग रनटाइम में पांच मिनट के लिए कैश किया जाता है। असफल पठन को 30 सेकंड के लिए कैश किया जाता है।
चेतावनी
सह-पायलट में रहस्य जोड़कर, आप इस रहस्य के मूल्य को उन सभी उपयोगकर्ताओं के समक्ष उजागर कर सकते हैं जो पर्यावरण में सह-पायलट को संपादित कर सकते हैं, क्योंकि ऐसे उपयोगकर्ता SendMessage
नोड में मूल्य लौटाने के लिए सह-पायलट को संपादित कर सकते हैं।
सिस्टम चर
प्रत्येक सह-पायलट में अंतर्निहित सिस्टम वैरिएबल्स होते हैं जो वार्तालाप के बारे में अतिरिक्त जानकारी प्रदान करते हैं।
नोट
ध्वनि-सक्षम सह-पायलट चरों के बारे में अधिक जानकारी के लिए, ध्वनि चरों का उपयोग करें देखें।
सभी सिस्टम वेरिएबल सूची में नहीं दिखाए गए हैं. आपको इन छुपे हुए सिस्टम चरों तक Power Fx सूत्र के साथ पहुंचना होगा।
किसी Power Fx सूत्र में सिस्टम चरों का उपयोग करने के लिए, आपको चर नाम से पहले System.
जोड़ना होगा। उदाहरण के लिए, सिस्टम चर User.DisplayName
को सूत्र में शामिल करने के लिए, इसे System.User.DisplayName
के रूप में संदर्भित करें।
Name | प्रकार | परिभाषा |
---|---|---|
Activity.Attachments |
तालिका | उपयोगकर्ता द्वारा प्रदान की गई फ़ाइल अनुलग्नक |
Activity.Channel |
विकल्प | वर्तमान वार्तालाप की चैनल आईडी |
Activity.ChannelData |
कोई भी | एक ऑब्जेक्ट जिसमें चैनल-विशिष्ट सामग्री शामिल है |
Activity.ChannelId |
string | वर्तमान वार्तालाप की चैनल आईडी, एक स्ट्रिंग के रूप में |
Activity.From.Id |
string | प्रेषक की चैनल-विशिष्ट अद्वितीय आईडी |
Activity.From.Name |
string | प्रेषक का चैनल-विशिष्ट उपयोगकर्ता-अनुकूल नाम |
Activity.Name |
string | कार्यक्रम का नाम |
Activity.Recipient.Id |
string | आने वाली गतिविधि का प्रकार गुण. |
Activity.Recipient.Name |
string | चैनल के भीतर सह-पायलट के लिए प्रदर्शन नाम का प्रतिनिधित्व करता है। टेलीफोनी चैनल संदर्भ में, इस चर का मान वह फ़ोन नंबर है जिससे सह-पायलट जुड़ा हुआ है। |
Activity.Text |
string | उपयोगकर्ता द्वारा भेजा गया सबसे हाल का संदेश |
Activity.Type |
विकल्प | गतिविधि का प्रकार |
Activity.TypeId |
string | गतिविधि का प्रकार, एक स्ट्रिंग के रूप में |
Activity.Value |
कोई भी | खुले अंत वाला मूल्य |
Bot.EnvironmentId |
string | सह-पायलट की पर्यावरण आईडी |
Bot.Id |
string | सहपायलट की आईडी |
Bot.Name |
string | आपके सह-पायलट का नाम |
Bot.SchemaName |
string | सह-पायलट का स्कीमा नाम |
Bot.TenantId |
string | सहपायलट की किरायेदार आईडी |
ClientPluginActions |
विकल्प | जनरेटिव क्रियाओं के लिए विचार करने योग्य डायनामिक क्लाइंट प्लगइन क्रियाओं का संग्रह |
Conversation.Id |
string | वर्तमान वार्तालाप की विशिष्ट आईडी |
Conversation.InTestMode |
Boolean | बूलियन ध्वज जो दर्शाता है कि वार्तालाप परीक्षण कैनवास में हो रहा है या नहीं |
Conversation.LocalTimeZone |
string | IANA समय क्षेत्र डेटाबेस प्रारूप में उपयोगकर्ता द्वारा उपयोग किए जाने वाले समय क्षेत्र का नाम |
Conversation.LocalTimeZoneOffset |
datetime | वर्तमान स्थानीय समय क्षेत्र के लिए UTC से समय ऑफसेट |
Error.Code |
string | वर्तमान त्रुटि के लिए त्रुटि कोड. नोट: यह चर केवल तभी समर्थित है जब ट्रिगर है |
Error.Message |
string | वर्तमान त्रुटि के लिए त्रुटि संदेश. नोट: यह चर केवल तभी समर्थित है जब ट्रिगर है |
FallbackCount |
संख्या | यह चर उन समयों की गणना करता है जब विषय का उपयोगकर्ता इनपुट से मिलान नहीं हो पाता। नोट: यह चर केवल तभी समर्थित है जब ट्रिगर है। |
InactivityTimer.Continue |
Boolean | बूलियन ध्वज जो यह दर्शाता है कि टाइमर को जारी रखने की आवश्यकता है या नहीं। नोट: यह चर केवल तभी समर्थित है जब ट्रिगर है। |
InactivityTimer.Count |
संख्या | कॉन्फ़िगर किए गए समय के बाद उपयोगकर्ता की निष्क्रियता के कारण OnInactivity टाइमर के सक्रिय होने की संख्या. नोट: यह चर केवल तभी समर्थित है जब ट्रिगर है। |
LastMessage.Id |
string | उपयोगकर्ता द्वारा भेजे गए पिछले संदेश की आईडी |
LastMessage.Text |
string | उपयोगकर्ता द्वारा भेजा गया पिछला संदेश |
Recognizer.ExtractedEntities |
विकल्प | ट्रिगरिंग संदेश से निकाले गए निकायों का प्रतिनिधित्व करता है। नोट: यह चर केवल तभी समर्थित है जब ट्रिगर |
Recognizer.IntentOptions |
विकल्प | जब पहचानकर्ता अस्पष्ट परिणाम लौटाता है तो आशय विकल्पों का प्रतिनिधित्व करता है। नोट: यह चर केवल तभी समर्थित है जब ट्रिगर |
Recognizer.SelectedIntent |
विकल्प | पहचानकर्ता से चयनित आशय का प्रतिनिधित्व करता है। नोट: यह चर केवल तभी समर्थित है जब ट्रिगर |
Recognizer.TriggeringMessage.Id |
string | वर्तमान विषय को ट्रिगर करने वाले उपयोगकर्ता संदेश की आईडी |
Recognizer.TriggeringMessage.Text |
string | वह उपयोगकर्ता संदेश जिसने वर्तमान विषय को ट्रिगर किया |
Recognizer.MultipleTopicsMatchedReason |
string | यह निर्धारित करने के लिए उपयोग किया जाता है कि एकाधिक विषय क्यों मेल खाते हैं। नोट: यह चर केवल तभी समर्थित है जब ट्रिगर |
User.Language |
विकल्प | इस चर का उपयोग प्रति वार्तालाप उपयोगकर्ता भाषा स्थान निर्धारित करने के लिए किया जाता है। |
SignInReason |
विकल्प | विषय को ट्रिगर करते समय किस साइन-इन विकल्प की आवश्यकता है, यह निर्धारित करने के लिए उपयोग किया जाता है। नोट: यह चर केवल तभी समर्थित है जब ट्रिगर |
एकीकृत प्रमाणीकरण के लिए चर (डिफ़ॉल्ट)
Microsoft Entra आईडी प्रमाणीकरण का उपयोग करने के लिए कॉन्फ़िगर किए गए सह-पायलटों के लिए निम्नलिखित चर उपलब्ध हैं। यह नये सह-पायलटों के लिए डिफ़ॉल्ट कॉन्फ़िगरेशन है।
अधिक जानकारी के लिए, प्रमाणीकरण चर देखें.
नाम | Type | परिभाषा |
---|---|---|
User.DisplayName |
string | वर्तमान में सहपायलट से बात कर रहे उपयोगकर्ता का प्रदर्शन नाम. |
User.Email |
string | वर्तमान में सह-पायलट से बात कर रहे उपयोगकर्ता का ईमेल पता. |
User.FirstName |
string | वर्तमान में सहपायलट से बात कर रहे उपयोगकर्ता का प्रथम नाम. |
User.Id |
string | वर्तमान में सह-पायलट से बात कर रहे उपयोगकर्ता की विशिष्ट आईडी। |
User.IsLoggedIn |
Boolean | बूलियन ध्वज जो यह दर्शाता है कि वर्तमान में सह-पायलट से बात कर रहा उपयोगकर्ता प्रमाणित है या नहीं। |
User.LastName |
string | वर्तमान में सह-पायलट से बात कर रहे उपयोगकर्ता का पारिवारिक नाम. |
User.PrincipalName |
string | वर्तमान में सह-पायलट से बात कर रहे उपयोगकर्ता का उपयोगकर्ता प्रमुख नाम. |
जेनेरिक OAuth 2 के साथ मैन्युअल प्रमाणीकरण के लिए चर
जेनेरिक OAuth 2 सेवा प्रदाता का उपयोग करने के लिए कॉन्फ़िगर किए गए सह-पायलटों के लिए निम्नलिखित चर उपलब्ध हैं।
नाम | प्रकार | परिभाषा |
---|---|---|
User.AccessToken |
string | सह-पायलट के साथ प्रमाणीकरण करने वाले उपयोगकर्ता के लिए पहुँच टोकन. |
User.DisplayName |
string | वर्तमान में सहपायलट से बात कर रहे उपयोगकर्ता का प्रदर्शन नाम. |
User.Id |
string | वर्तमान में सह-पायलट से बात कर रहे उपयोगकर्ता की विशिष्ट आईडी। |
User.IsLoggedIn |
Boolean | बूलियन ध्वज जो यह दर्शाता है कि वर्तमान में सह-पायलट से बात कर रहा उपयोगकर्ता प्रमाणित है या नहीं। |
Microsoft Entra आईडी के साथ मैन्युअल प्रमाणीकरण के लिए चर
Microsoft Entra ID (पूर्व में Azure Active Directory) सेवा प्रदाताओं का उपयोग करने के लिए कॉन्फ़िगर किए गए सह-पायलटों के लिए निम्नलिखित चर उपलब्ध हैं।
नाम | प्रकार | परिभाषा |
---|---|---|
User.AccessToken |
string | सह-पायलट के साथ प्रमाणीकरण करने वाले उपयोगकर्ता के लिए पहुँच टोकन. |
User.DisplayName |
string | वर्तमान में सहपायलट से बात कर रहे उपयोगकर्ता का प्रदर्शन नाम. |
User.Email |
string | वर्तमान में सह-पायलट से बात कर रहे उपयोगकर्ता का ईमेल पता. |
User.FirstName |
string | वर्तमान में सहपायलट से बात कर रहे उपयोगकर्ता का प्रथम नाम. |
User.Id |
string | वर्तमान में सह-पायलट से बात कर रहे उपयोगकर्ता की विशिष्ट आईडी। |
User.IsLoggedIn |
Boolean | बूलियन ध्वज जो यह दर्शाता है कि वर्तमान में सह-पायलट से बात कर रहा उपयोगकर्ता प्रमाणित है या नहीं। |
User.LastName |
string | वर्तमान में सह-पायलट से बात कर रहे उपयोगकर्ता का पारिवारिक नाम. |
User.PrincipalName |
string | वर्तमान में सह-पायलट से बात कर रहे उपयोगकर्ता का उपयोगकर्ता प्रमुख नाम. |
आवाज-सक्षम सह-पायलटों के लिए चर
निम्नलिखित चर केवल ध्वनि-सक्षम सह-पायलटों में उपलब्ध हैं।
नोट
ध्वनि-सक्षम सह-पायलट चरों के बारे में अधिक जानकारी के लिए, ध्वनि चरों का उपयोग करें देखें।
नाम | Type | परिभाषा |
---|---|---|
Activity.InputDTMFKeys |
string | टेलीफ़ोनी से प्राप्त कच्चा DTMF कुंजी मान. |
Activity.SpeechRecognition.Confidence |
संख्या | ASR परिकल्पना के सम्पूर्ण परिणाम के लिए कॉन्फिडेंस स्कोर, 0 से 1. |
Activity.SpeechRecognition.MinimallyFormattedText |
string | एएसआर परिकल्पना परिणाम का थोड़ा स्वरूपित पाठ। उदाहरण के लिए, पाँच सौ डॉलर। शब्दों की वर्तनी तो स्पष्ट है, लेकिन बुनियादी कैपिटलाइजेशन और विराम चिह्न भी शामिल हैं। |
Activity.UserInputType |
विकल्प | अंतिम उपयोगकर्ता के सबसे हाल के इनपुट से इनपुट प्रकार. मान परीक्षण, भाषण या डीटीएमएफ हो सकता है। |
Conversation.OnlyAllowDTMF |
Boolean | बूलियन ध्वज जो यह दर्शाता है कि क्या IVR को रनटाइम पर DTMF-only मोड पर सेट किया जाना चाहिए। |
Conversation.SipUuiHeaderValue |
string | कॉल प्रारंभ होने पर संदर्भ को IVR में भेजने के लिए प्रयुक्त UUI हेडर स्ट्रिंग। |
विषयों के बीच चर पास करें
जब आप एक विषय को दूसरे पर पुनर्निर्देशित करते हैं, तो आप मूल विषय और गंतव्य विषय के बीच चर के मानों को पास कर सकते हैं। विषयों के बीच चरों को पास करना विशेष रूप से तब उपयोगी होता है जब पहले वाले विषय ने पहले से ही वह जानकारी एकत्रित कर ली हो जिसकी बाद वाले विषय को आवश्यकता होती है। आपके उपयोगकर्ता इस बात से प्रसन्न होंगे कि उन्हें एक ही प्रश्न का उत्तर दोबारा नहीं देना पड़ेगा।
अन्य विषयों से मान प्राप्त करें
जब विषय कोई चर परिभाषित करता है (उदाहरण के लिए, प्रश्न नोड में), तो सह-पायलट उपयोगकर्ता से चर का मान भरने के लिए प्रश्न पूछता है। यदि सह-पायलट ने पहले ही विषय में मान प्राप्त कर लिया है, तो प्रश्न को दोबारा पूछने का कोई कारण नहीं है। इन मामलों में, आप चर को अन्य विषयों से मान प्राप्त करें पर सेट कर सकते हैं। जब कोई अन्य विषय इस पर पुनर्निर्देशित करता है, तो यह या तो किसी चर का मान (या एक शाब्दिक मान ) इस चर पर पारित कर सकता है और प्रश्न को छोड़ सकता है। उपयोगकर्ता के लिए सह-पायलट से बात करने का अनुभव सहज है।
इस उदाहरण में, हम दो विषयों का उपयोग करेंगे, अभिवादन और ग्राहक से बातचीत। दोनों विषयों में ग्राहक का नाम पूछा जाता है। हालाँकि, यदि ग्रीटिंग विषय पहले चलता है, तो ग्राहक से बात विषय अपना प्रश्न छोड़ देता है। इसके बजाय, यह ग्रीटिंग विषय से पारित चर के मान का उपयोग करता है।
ग्राहक से बातचीत विषय का प्रवाह इस प्रकार है:
जैसा कि टेस्ट कोपायलट पैन में दिखाया गया है, यदि यह विषय पहले ट्रिगर होता है, तो यह उपयोगकर्ता से पूछता है, "मुझे आपको क्या कॉल करना चाहिए?" यह मान को userName
नामक स्ट्रिंग वेरिएबल में संग्रहीत करता है। userName
चर को अन्य विषयों से अपना मान प्राप्त करने के लिए भी सेट किया गया है। विषय इस संदेश के साथ समाप्त होता है, "मुझे आशा है कि आपका दिन बहुत अच्छा गुजर रहा होगा, {userName}!"
अभिवादन विषय का प्रवाह इस प्रकार है:
जैसा कि टेस्ट कोपायलट पैन में दिखाया गया है, यदि यह विषय पहले ट्रिगर होता है, तो यह उपयोगकर्ता से पूछता है, "आपका नाम क्या है?" यह मान को स्ट्रिंग वैरिएबल में संग्रहीत करता है जिसे कहा जाता है UserName
. विषय संदेश भेजता है, "आपसे मिलकर खुशी हुई, {UserName} !" इसके बाद यह टॉक टू कस्टमर विषय पर रीडायरेक्ट करता है, जो संदेश भेजता है, "मुझे आशा है कि आपका दिन शानदार रहेगा, {userName} !" तथापि, ध्यान दें कि ग्राहक से बात करें विषय ने उपयोगकर्ता का नाम दोबारा पूछना छोड़ दिया। इसके बजाय, इसने मूल्य का उपयोग किया UserName
ग्रीटिंग विषय से पारित चर.
अंत में, यहाँ फिर से दूसरी बातचीत है, इस बार ग्राहक से बात करें विषय के दृष्टिकोण से:
आइए अन्य विषयों से मान प्राप्त करने के लिए विषय को सेट अप करने के चरणों पर चलते हैं। हम अपने वर्तमान उदाहरण का उपयोग करेंगे, लेकिन जब भी विषय को किसी पुराने विषय से मान प्राप्त करने की आवश्यकता होगी, तो यही चरण काम करेंगे।
गंतव्य विषय सेट करें
गंतव्य विषय वह विषय है जिस पर पुनर्निर्देशित किया जा रहा है, जो अन्य विषयों से मान प्राप्त करेगा। हमारे उदाहरण में, यह 'ग्राहक से बात करें' है।
अपना गंतव्य विषय बनाएं या वहां जाएं.
संदेश के लिए एक प्रश्न नोड जोड़ें और Enter
What should I call you?
डालें.पहचान के अंतर्गत, पूर्वनिर्मित इकाई व्यक्ति का नाम चुनें.
चर गुण फलक खोलने के लिए चर का चयन करें. इसे
userName
नाम दें, और फिर अन्य विषयों से मान प्राप्त करें चुनें.संदेश नोड जोड़ें.
संदेश बॉक्स में
I hope you're having a wonderful day,
लिखें.चर सम्मिलित करें आइकन ({x}) का चयन करें, और फिर उपयोगकर्ता नाम का चयन करें.
वेरिएबल के बाद रिक्त स्थान का चयन करें और
!
टाइप करें.विषय को सहेजें.
स्रोत विषय सेट करें
स्रोत विषय वह विषय है जो पुनर्निर्देशन करता है, वह वह मान प्रदान करता है जो गंतव्य विषय को भेजा जाएगा। हमारे उदाहरण में, यह अभिवादन है।
स्रोत विषय पर जाएं.
एक रीडायरेक्ट नोड जोड़ें और गंतव्य विषय का चयन करें.
+ इनपुट जोड़ें का चयन करें, और फिर गंतव्य विषय से वह चर चुनें, जिस पर आप मान पास करना चाहते हैं।
> आइकन का चयन करें, और फिर उस वेरिएबल का चयन करें जिसका मान आप पास करना चाहते हैं।
रीडायरेक्ट नोड इस तरह दिखना चाहिए:
विषय को सहेजें.
मूल विषयों पर मान लौटाएँ
जब किसी विषय को पुनर्निर्देशित किया जाता है और प्रश्न पूछकर या किसी अन्य तरीके से चर प्राप्त किया जाता है, तो चर को मूल विषय में वापस लौटाया जा सकता है। यह वेरिएबल मूल विषय का हिस्सा बन जाता है और इसका उपयोग किसी अन्य वेरिएबल की तरह किया जा सकता है। इस प्रकार सह-पायलट को प्राप्त जानकारी सभी विषयों में उपलब्ध होती है, जिससे वैश्विक चरों की आवश्यकता कम हो जाती है।
आइये, पिछले अनुभाग के उदाहरण से आगे बढ़ें। हम ग्राहक से बातचीत विषय में एक नया प्रश्न पूछेंगे, और फिर अभिवादन विषय में उत्तर लौटाएंगे।
लौटाए गए चर के लिए स्रोत विषय सेट करें
जब आप किसी चर को विषय पर लौटा रहे हैं, तो स्रोत विषय वह विषय होता है, जिस पर पुनर्निर्देशित किया जा रहा है, जो वह मान प्रदान करता है, जिसे मूल विषय पर वापस भेजा जाएगा। इस उदाहरण में, यह ग्राहक से बात करें है।
स्रोत विषय पर जाएं.
एक प्रश्न नोड जोड़ें और संदेश के लिए
What city do you live in?
दर्ज करें.पहचानें के अंतर्गत, पूर्वनिर्मित इकाई शहर का चयन करें.
चर गुण फलक खोलने के लिए चर का चयन करें. इसे
userCity
नाम दें, और फिर मूल विषयों पर मान लौटाएँ चुनें.विषय को सहेजें.
लौटाए गए चर के लिए गंतव्य विषय सेट करें
जब आप किसी चर को विषय पर लौटा रहे हैं, तो गंतव्य विषय वह विषय है जो पुनर्निर्देशन कर रहा है, जो अन्य विषयों से मान प्राप्त करेगा। हमारे उदाहरण में, यह अभिवादन है।
गंतव्य विषय पर जाएं.
स्रोत विषय में आपके द्वारा चयनित वेरिएबल रीडायरेक्ट नोड में आउटपुट वेरिएबल के रूप में दिखाई देना चाहिए।
विषय को सहेजें.