इसके माध्यम से साझा किया गया


वेरिएबल के साथ कार्य करें

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

आप तार्किक अभिव्यक्तियाँ बनाने के लिए चरों का भी उपयोग कर सकते हैं जो ग्राहक को गतिशील रूप से विभिन्न वार्तालाप पथों पर ले जाती हैं। उदाहरण के लिए, ग्राहक का नाम 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 अक्षरों तक हो सकती है.

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

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

प्रश्न नोड का स्क्रीनशॉट जिसमें 'पहचानने के लिए जानकारी चुनें' मेनू खुला है और 'व्यक्ति का नाम' इकाई हाइलाइट की गई है।

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

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

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

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

एक चर सेट करें

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

  1. नोड जोड़ने के लिए नोड जोड़ें (+) का चयन करें, और फिर चर प्रबंधन>चर मान सेट करें का चयन करें.

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

    नया वेरिएबल बनाएं बटन का स्क्रीनशॉट.

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

    अज्ञात प्रकार के नए चर के साथ सेट वैरिएबल वैल्यू नोड का स्क्रीनशॉट।

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

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

शाब्दिक मानों का उपयोग करें

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

productName नामक चर के लिए शाब्दिक मान के उपयोग को दर्शाने वाला स्क्रीनशॉट।

रीडायरेक्ट नोड में एक चर के लिए इनपुट के रूप में शाब्दिक मान दिखाने वाला स्क्रीनशॉट।

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

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

चर फलक

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

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

 Copilot Studio लेखन कैनवास में वेरिएबल्स फलक का स्क्रीनशॉट, जिसमें वेरिएबल्स बटन हाइलाइट किया गया है।

चर गुण फलक

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

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

चर गुण फलक का स्क्रीनशॉट.

परिवेश चर

पर्यावरण चर एक अवधारणा है। Power Platform पर्यावरण चर, किसी अनुप्रयोग को विभिन्न वातावरणों के बीच ले जाने के लिए मूल अनुप्रयोग जीवनचक्र प्रबंधन (ALM) परिदृश्य को सक्षम करते हैं। Power Platform इस परिदृश्य में, अनुप्रयोग बिल्कुल वैसा ही रहता है, सिवाय कुछ प्रमुख बाह्य संदर्भों के, जो स्रोत परिवेश और गंतव्य परिवेश के बीच भिन्न होते हैं।

पर्यावरण चरों का उपयोग उसी तरह करें जैसे विषय, वैश्विक, और प्रणाली चरों का उपयोग करें। एक उल्लेखनीय अंतर यह है कि आप पर्यावरण चरों का उपयोग केवल केवल पढ़ने योग्य मोड में ही कर सकते हैं। सह-पायलट लेखक Copilot Studio में पर्यावरण चर को संशोधित नहीं कर सकते। हालाँकि, व्यवस्थापक पोर्टल में पर्यावरण चर का मान बदल सकते हैं. Power Apps

विषय पृष्ठ का स्क्रीनशॉट जिसमें var मान को वातावरण चर पर सेट किया गया है।

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

  1. अनुप्रयोग को भूमिका असाइन करें. Key Vault Secrets User Microsoft Virtual Agents Service

  2. परिवेश से सभी सह-पायलटों को गुप्त जानकारी तक पहुंचने के लिए अधिकृत करने के लिए, गुप्त जानकारी पर एक टैग बनाएं और अल्पविराम से अलग करके अनुमत परिवेश आईडी जोड़ें। AllowedEnvironments

  3. इस कुंजी वॉल्ट का उपयोग करने के लिए पर्यावरण से केवल विशिष्ट सह-पायलटों को अधिकृत करने के लिए, एक टैग 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

वर्तमान त्रुटि के लिए त्रुटि कोड.

नोट: यह चर केवल तभी समर्थित है जब ट्रिगर है On Error.

Error.Message string

वर्तमान त्रुटि के लिए त्रुटि संदेश.

नोट: यह चर केवल तभी समर्थित है जब ट्रिगर है On Error.

FallbackCount संख्या

यह चर उन समयों की गणना करता है जब विषय का उपयोगकर्ता इनपुट से मिलान नहीं हो पाता।

नोट: यह चर केवल तभी समर्थित है जब ट्रिगर है। On Unknown Intent

InactivityTimer.Continue Boolean

बूलियन ध्वज जो यह दर्शाता है कि टाइमर को जारी रखने की आवश्यकता है या नहीं।

नोट: यह चर केवल तभी समर्थित है जब ट्रिगर है। Inactivity

InactivityTimer.Count संख्या

कॉन्फ़िगर किए गए समय के बाद उपयोगकर्ता की निष्क्रियता के कारण OnInactivity टाइमर के सक्रिय होने की संख्या.

नोट: यह चर केवल तभी समर्थित है जब ट्रिगर है। Inactivity

LastMessage.Id string उपयोगकर्ता द्वारा भेजे गए पिछले संदेश की आईडी
LastMessage.Text string उपयोगकर्ता द्वारा भेजा गया पिछला संदेश
Recognizer.ExtractedEntities विकल्प

ट्रिगरिंग संदेश से निकाले गए निकायों का प्रतिनिधित्व करता है।

नोट: यह चर केवल तभी समर्थित है जब ट्रिगर On Select Intent हो।

Recognizer.IntentOptions विकल्प

जब पहचानकर्ता अस्पष्ट परिणाम लौटाता है तो आशय विकल्पों का प्रतिनिधित्व करता है।

नोट: यह चर केवल तभी समर्थित है जब ट्रिगर On Select Intent हो।

Recognizer.SelectedIntent विकल्प

पहचानकर्ता से चयनित आशय का प्रतिनिधित्व करता है।

नोट: यह चर केवल तभी समर्थित है जब ट्रिगर On Select Intent हो।

Recognizer.TriggeringMessage.Id string वर्तमान विषय को ट्रिगर करने वाले उपयोगकर्ता संदेश की आईडी
Recognizer.TriggeringMessage.Text string वह उपयोगकर्ता संदेश जिसने वर्तमान विषय को ट्रिगर किया
Recognizer.MultipleTopicsMatchedReason string

यह निर्धारित करने के लिए उपयोग किया जाता है कि एकाधिक विषय क्यों मेल खाते हैं।

नोट: यह चर केवल तभी समर्थित है जब ट्रिगर On Select Intent हो।

User.Language विकल्प इस चर का उपयोग प्रति वार्तालाप उपयोगकर्ता भाषा स्थान निर्धारित करने के लिए किया जाता है।
SignInReason विकल्प

विषय को ट्रिगर करते समय किस साइन-इन विकल्प की आवश्यकता है, यह निर्धारित करने के लिए उपयोग किया जाता है।

नोट: यह चर केवल तभी समर्थित है जब ट्रिगर On Sign In हो।

एकीकृत प्रमाणीकरण के लिए चर (डिफ़ॉल्ट)

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 ग्रीटिंग विषय से पारित चर.

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

ग्राहक से बात करें विषय वार्तालाप प्रवाह का स्क्रीनशॉट जब अभिवादन विषय पहले ट्रिगर किया जाता है।

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

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

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

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

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

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

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

    ग्राहक से बात करें विषय का स्क्रीनशॉट जिसमें userName चर और उसके गुण हाइलाइट किए गए हैं।

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

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

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

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

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

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

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

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

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

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

    रीडायरेक्ट नोड में इनपुट के रूप में जोड़े गए userName चर के साथ अभिवादन विषय का स्क्रीनशॉट।

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

    उपयोगकर्ता नाम चर मान चयनित के साथ अभिवादन विषय का स्क्रीनशॉट।

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

    पूर्ण रीडायरेक्ट नोड के साथ ग्रीटिंग विषय का स्क्रीनशॉट।

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

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

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

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

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

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

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

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

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

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

    ग्राहक से बात करें विषय का स्क्रीनशॉट जिसमें userCity चर और उसके गुण हाइलाइट किए गए हैं।

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

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

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

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

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

    रीडायरेक्ट नोड में लौटाए गए चर के साथ ग्रीटिंग विषय वार्तालाप प्रवाह का स्क्रीनशॉट।

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