चर का अवलोकन

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

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

क्लासिक

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

परिवेश चर

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

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

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

Copilot Studio में पर्यावरण चर प्रकार Power Apps डेटा प्रकारों से इस प्रकार मैप होते हैं:

टाइप करें Copilot Studio	टाइप करें Power Apps
दशमलव संख्या	नंबर
JSON	मान से प्रकार का पता लगाएं. यदि नहीं तो JSON => अनिर्दिष्ट (सत्यापन त्रुटि)
टेक्स्ट	String
हां/नहीं	Boolean
डेटा स्रोत	String
सीक्रेट	String

नोट

पर्यावरण चर त्रुटियाँ परीक्षण चैट में और प्रकाशन के समय दिखाई देती हैं। हालाँकि, ये त्रुटियाँ विषय सूची में नहीं दिखाई जाती हैं क्योंकि वे विषय चर नहीं हैं।

सिस्टम चर

प्रत्येक एजेंट अंतर्निहित सिस्टम वेरिएबल्स के साथ आता है जो वार्तालाप के बारे में अतिरिक्त जानकारी प्रदान करते हैं।

नोट

वॉयस-सक्षम एजेंट वैरिएबल के बारे में अधिक जानकारी के लिए, वॉयस वैरिएबल का उपयोग करें देखें.

सभी सिस्टम वेरिएबल सूची में नहीं दिखाए गए हैं. आपको इन छुपे हुए सिस्टम चरों तक Power Fx सूत्र के साथ पहुंचना होगा।

किसी सूत्र में सिस्टम चरों का उपयोग करने के लिए, आपको चर नाम से पहले जोड़ना होगा। Power Fx System. उदाहरण के लिए, सिस्टम चर User.DisplayName को सूत्र में शामिल करने के लिए, इसे System.User.DisplayName के रूप में संदर्भित करें।

नाम	Type	परिभाषा
गतिविधि.संलग्नक	तालिका	उपयोगकर्ता द्वारा प्रदान की गई फ़ाइल अनुलग्नक
गतिविधि.चैनल	विकल्प	वर्तमान वार्तालाप की चैनल आईडी
गतिविधि.चैनलडेटा	कोई भी	एक ऑब्जेक्ट जिसमें चैनल-विशिष्ट सामग्री शामिल है
गतिविधि.चैनलआईडी	string	वर्तमान वार्तालाप की चैनल आईडी, एक स्ट्रिंग के रूप में
Activity.From.Id	string	प्रेषक की चैनल-विशिष्ट अद्वितीय आईडी
Activity.From.Name	string	प्रेषक का चैनल-विशिष्ट उपयोगकर्ता-अनुकूल नाम
Activity.Name	string	कार्यक्रम का नाम
Activity.Recipient.Id	string	आने वाली गतिविधि का प्रकार गुण.
Activity.Recipient.Name	string	चैनल के भीतर एजेंट के लिए प्रदर्शन नाम का प्रतिनिधित्व करता है. टेलीफोनी चैनल संदर्भ में, इस चर का मान वह फ़ोन नंबर है जिससे एजेंट जुड़ा हुआ है।
गतिविधि.पाठ	string	उपयोगकर्ता द्वारा भेजा गया सबसे हाल का संदेश
गतिविधि.प्रकार	विकल्प	गतिविधि का प्रकार
गतिविधि.प्रकारआईडी	string	गतिविधि का प्रकार, एक स्ट्रिंग के रूप में
गतिविधि.मूल्य	कोई भी	खुले अंत वाला मूल्य
Bot.पर्यावरणआईडी	string	एजेंट की परिवेश आईडी
Bot.Id	string	एजेंट की आईडी
Bot.Name	string	आपके एजेंट का नाम
Bot.स्कीमानाम	string	एजेंट का स्कीमा नाम
Bot.टेनेंटआईडी	string	एजेंट की किरायेदार आईडी
क्लाइंटप्लगइनक्रियाएँ	विकल्प	जनरेटिव ऑर्केस्ट्रेशन के लिए विचार करने हेतु डायनामिक क्लाइंट प्लगइन क्रियाओं का संग्रह
Conversation.Id	string	वर्तमान वार्तालाप की विशिष्ट आईडी
वार्तालाप.इनटेस्टमोड	Boolean	बूलियन ध्वज जो दर्शाता है कि वार्तालाप परीक्षण कैनवास में हो रहा है या नहीं
वार्तालाप.स्थानीयसमयक्षेत्र	string	IANA समय क्षेत्र डेटाबेस प्रारूप में उपयोगकर्ता द्वारा उपयोग किए जाने वाले समय क्षेत्र का नाम
वार्तालाप.स्थानीयसमयक्षेत्रऑफ़सेट	datetime	वर्तमान स्थानीय समय क्षेत्र के लिए UTC से समय ऑफसेट
त्रुटि कोड	string	वर्तमान त्रुटि के लिए त्रुटि कोड. वर्तमान त्रुटि के लिए त्रुटि संदेश.
त्रुटि संदेश	string	वर्तमान त्रुटि के लिए त्रुटि संदेश. नोट: यह चर केवल तभी समर्थित है जब ट्रिगर On Error हो।
फ़ॉलबैककाउंट	संख्या	यह वेरिएबल उन समयों की गणना करता है जब कोई विषय उपयोगकर्ता इनपुट से मेल नहीं खा पाता। नोट: यह चर केवल तभी समर्थित है जब ट्रिगर On Unknown Intent हो।
निष्क्रियता टाइमर.जारी रखें	Boolean	बूलियन ध्वज जो यह दर्शाता है कि टाइमर को जारी रखने की आवश्यकता है या नहीं। नोट: यह चर केवल तभी समर्थित है जब ट्रिगर Inactivity हो।
निष्क्रियता टाइमर.गणना	संख्या	कॉन्फ़िगर किए गए समय के बाद उपयोगकर्ता की निष्क्रियता के कारण OnInactivity टाइमर के सक्रिय होने की संख्या। नोट: यह चर केवल तभी समर्थित है जब ट्रिगर Inactivity हो।
LastMessage.Id	string	उपयोगकर्ता द्वारा भेजे गए पिछले संदेश की आईडी
अंतिमसंदेश.पाठ	string	उपयोगकर्ता द्वारा भेजा गया पिछला संदेश
पहचानकर्ता.ExtractedEntities	विकल्प	ट्रिगरिंग संदेश से निकाले गए निकायों का प्रतिनिधित्व करता है। नोट: यह चर केवल तभी समर्थित है जब ट्रिगर On Select Intent हो।
पहचानकर्ता.आशयविकल्प	विकल्प	जब पहचानकर्ता अस्पष्ट परिणाम लौटाता है तो आशय विकल्पों का प्रतिनिधित्व करता है। नोट: यह चर केवल तभी समर्थित है जब ट्रिगर On Select Intent हो।
पहचानकर्ता.चयनित आशय	विकल्प	पहचानकर्ता से चयनित आशय का प्रतिनिधित्व करता है। नोट: यह चर केवल तभी समर्थित है जब ट्रिगर On Select Intent हो।
Recognizer.TriggeringMessage.Id	string	वर्तमान विषय को ट्रिगर करने वाले उपयोगकर्ता संदेश की आईडी
पहचानकर्ता.ट्रिगरिंगसंदेश.पाठ	string	वह उपयोगकर्ता संदेश जिसने वर्तमान विषय को ट्रिगर किया
पहचानकर्ता.एकाधिकविषयमिलानकारण	string	इसका उपयोग यह निर्धारित करने के लिए किया जाता है कि एकाधिक विषयों का मिलान क्यों किया गया। नोट: यह चर केवल तभी समर्थित है जब ट्रिगर On Select Intent हो।
SignInReason	विकल्प	विषय को ट्रिगर करते समय किस साइन-इन विकल्प की आवश्यकता है, यह निर्धारित करने के लिए उपयोग किया जाता है। नोट: यह चर केवल तभी समर्थित है जब ट्रिगर On Sign In हो।
उपयोगकर्ता.भाषा	विकल्प	इस चर का उपयोग प्रति वार्तालाप उपयोगकर्ता की भाषा का स्थान निर्धारित करने के लिए किया जाता है।

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

Microsoft के साथ प्रमाणीकरण के लिए कॉन्फ़िगर किए गए एजेंटों के लिए निम्नलिखित चर उपलब्ध हैं. यह कॉन्फ़िगरेशन ID प्रमाणीकरण का उपयोग करता है और नए एजेंटों के लिए डिफ़ॉल्ट है. Microsoft Entra

अधिक जानकारी के लिए, प्रमाणीकरण चर देखें.

नाम	Type	परिभाषा
उपयोगकर्ता.प्रदर्शननाम	string	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता का प्रदर्शन नाम.
उपयोगकर्ता.ईमेल	string	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता का ईमेल पता.
उपयोगकर्ता.प्रथमनाम	string	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता का पहला नाम.
User.Id	string	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता की विशिष्ट आईडी.
उपयोगकर्ता.लॉगइनहै	Boolean	बूलियन ध्वज जो यह दर्शाता है कि वर्तमान में एजेंट से बात कर रहा उपयोगकर्ता प्रमाणीकृत है या नहीं।
उपयोगकर्ता.अंतिमनाम	string	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता का पारिवारिक नाम.
उपयोगकर्ता.प्रधाननाम	string	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता का उपयोगकर्ता प्रमुख नाम.

जेनेरिक OAuth 2 के साथ मैन्युअल प्रमाणीकरण के लिए चर

जेनेरिक OAuth 2 सेवा प्रदाता का उपयोग करने के लिए कॉन्फ़िगर किए गए एजेंटों के लिए निम्नलिखित चर उपलब्ध हैं।

नाम	प्रकार	परिभाषा
उपयोगकर्ता.एक्सेसटोकन	string	एजेंट के साथ प्रमाणीकरण करने वाले उपयोगकर्ता के लिए एक्सेस टोकन.
उपयोगकर्ता.प्रदर्शननाम	string	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता का प्रदर्शन नाम.
User.Id	string	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता की विशिष्ट आईडी.
उपयोगकर्ता.लॉगइनहै	Boolean	बूलियन ध्वज जो यह दर्शाता है कि वर्तमान में एजेंट से बात कर रहा उपयोगकर्ता प्रमाणीकृत है या नहीं।

Microsoft Entra आईडी के साथ मैन्युअल प्रमाणीकरण के लिए चर

Microsoft Entra ID (पूर्व में Azure Active Directory) सेवा प्रदाताओं का उपयोग करने के लिए कॉन्फ़िगर किए गए एजेंटों के लिए निम्नलिखित चर उपलब्ध हैं।

नाम	प्रकार	परिभाषा
उपयोगकर्ता.एक्सेसटोकन	string	एजेंट के साथ प्रमाणीकरण करने वाले उपयोगकर्ता के लिए एक्सेस टोकन.
उपयोगकर्ता.प्रदर्शननाम	string	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता का प्रदर्शन नाम.
उपयोगकर्ता.ईमेल	string	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता का ईमेल पता.
उपयोगकर्ता.प्रथमनाम	string	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता का पहला नाम.
User.Id	string	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता की विशिष्ट आईडी.
उपयोगकर्ता.लॉगइनहै	Boolean	बूलियन ध्वज जो यह दर्शाता है कि वर्तमान में एजेंट से बात कर रहा उपयोगकर्ता प्रमाणीकृत है या नहीं।
उपयोगकर्ता.अंतिमनाम	string	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता का पारिवारिक नाम.
उपयोगकर्ता.प्रधाननाम	string	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता का मुख्य नाम.

वॉयस-सक्षम एजेंटों के लिए चर

निम्नलिखित चर केवल ध्वनि-सक्षम एजेंटों के लिए उपलब्ध हैं।

नोट

वॉयस-सक्षम एजेंट वैरिएबल के बारे में अधिक जानकारी के लिए, वॉयस वैरिएबल का उपयोग करें देखें.

नाम	Type	परिभाषा
गतिविधि.इनपुटDTMFकुंजियाँ	string	टेलीफ़ोनी से प्राप्त कच्चा DTMF कुंजी मान.
गतिविधि.भाषण पहचान.आत्मविश्वास	संख्या	Azure साइट पुनर्प्राप्ति परिकल्पना के संपूर्ण परिणाम के लिए विश्वास स्कोर, 0 से 1.
गतिविधि.भाषण पहचान.न्यूनतम स्वरूपित पाठ	string	Azure साइट पुनर्प्राप्ति परिकल्पना परिणाम का थोड़ा स्वरूपित पाठ. उदाहरण के लिए, "पाँच सौ डॉलर"। शब्दों की वर्तनी तो स्पष्ट है, लेकिन बुनियादी बड़े अक्षर और विराम चिह्न भी शामिल हैं।
गतिविधि.उपयोगकर्ताइनपुटप्रकार	विकल्प	उपयोगकर्ता के सबसे हाल के इनपुट का इनपुट प्रकार. मान परीक्षण, भाषण या डीटीएमएफ हो सकता है।
वार्तालाप.OnlyAllowDTMF	Boolean	बूलियन ध्वज जो यह दर्शाता है कि क्या IVR को रनटाइम पर DTMF-only मोड पर सेट किया जाना चाहिए।
वार्तालाप.SipUuiHeaderValue	string	कॉल प्रारंभ होने पर संदर्भ को IVR में भेजने के लिए प्रयुक्त UUI हेडर स्ट्रिंग।