चर का अवलोकन

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

• विषय चर जिनका उपयोग आप केवल उन विषयों में कर सकते हैं जहां आप उन्हें बनाते हैं। यह कार्यक्षेत्र आपके द्वारा बनाए गए चर के लिए डिफ़ॉल्ट है।
• ग्लोबल चर जिनका उपयोग आप सभी विषयों में कर सकते हैं। आप किसी विषय चर को वैश्विक चर बनाने के लिए उसका कार्यक्षेत्र बदल सकते हैं।
• सिस्टम चर Copilot Studio स्वचालित रूप से एक एजेंट के लिए बनाता है। वे बातचीत या उपयोगकर्ता के बारे में अधिक प्रासंगिक जानकारी प्रदान करते हैं। वे सभी विषयों में उपलब्ध हैं।
• पर्यावरण चर जो आप Power Platform में बनाते हैं। वे Copilot Studio में केवल-पढ़ने के लिए हैं। वे पैरामीटर कुंजियों और मानों को स्टोर करते हैं, जो बाद में Copilot Studio सहित विभिन्न अन्य एप्लिकेशन ऑब्जेक्ट्स के लिए इनपुट के रूप में कार्य करते हैं। खपत वाली वस्तुओं से पैरामीटर को अलग करना आपको उसी परिवेश में या जब आप अन्य परिवेशों के समाधानों को स्थानांतरित करते हैं, तो मानों को बदलने देता है. विकल्प उन कंपोनेंट में हार्ड-कोडेड पैरामीटर मान छोड़ना है जो उनका उपयोग करते हैं.

चर के प्रकार

प्रत्येक चर का एक आधार प्रकार होता है। प्रकार यह निर्धारित करता है कि चर किन मानों को धारण कर सकता है और ऑपरेटरों का उपयोग आप कर सकते हैं जब आप इसके साथ एक तार्किक अभिव्यक्ति बनाते हैं।

प्रकार	विवरण
स्ट्रिंग	पाठ का प्रतिनिधित्व करने के लिए उपयोग किए जाने वाले वर्णों का एक क्रम
बूलियन	एक तार्किक मान जो केवल true या false हो सकता है
नंबर	कोई भी वास्तविक संख्या
तालिका	मानों की एक सूची, लेकिन सभी मान एक ही प्रकार के होने चाहिए
रिकॉर्ड	नाम-मान युग्मों का एक संग्रह जहां मान किसी भी प्रकार के हो सकते हैं
तिथिसमय	समय में एक बिंदु के सापेक्ष एक दिनांक, समय, सप्ताह का दिन, या महीना
विकल्प	संबद्ध समानार्थक शब्दों के साथ स्ट्रिंग मानों की एक सूची
रिक्त	"कोई मूल्य नहीं" या "अज्ञात मूल्य" के लिए एक प्लेसहोल्डर; अधिक जानकारी के लिए, Power Fx दस्तावेज़ों में रिक्त स्थान देखें

जब आप पहली बार किसी चर को कोई मान असाइन करते हैं तो आप उसका प्रकार सेट करते हैं। उसके बाद, प्रकार तय हो जाता है और आप किसी अन्य प्रकार के मान असाइन नहीं कर सकते। उदाहरण के लिए, यदि आप किसी चर को प्रारंभिक मान 1 असाइन करते हैं, तो आप इसके प्रकार को नंबर पर सेट करते हैं। यदि आप फिर स्ट्रिंग मान असाइन करने का प्रयास करते हैं, जैसे , "apples"आपको एक त्रुटि मिलती है।

जब आप किसी एजेंट का परीक्षण करते हैं, तो एक चर अस्थायी रूप से अज्ञात प्रकार के साथ दिखाई दे सकता है। किसी अज्ञात चर का अभी तक कोई मान नहीं है।

चर का क्रम संलेखन कैनवास के ऊपर से नीचे तक निर्धारित किया जाता है। संलेखन कैनवास के शीर्ष पर नोड्स को नीचे नोड्स से पहले माना जाता है।

जब आप कंडीशन नोड्स के साथ शाखाएं बनाते हैं, तो शाखाएं बाएं से दाएं क्रम में होती हैं। सबसे बाईं शाखा में नोड्स को सबसे दाहिनी शाखा में नोड्स से पहले माना जाता है।

निकाय

वेब ऐप

Copilot Studio किसी उपयोगकर्ता की प्रतिक्रियाओं से एक विशेष जानकारी को समझने एवं पहचानने के लिए निकायों का उपयोग करते हैं। पहचानी गई जानकारी को उस प्रकार के चर में सहेजा जाता है जो जानकारी के लिए उपयुक्त है। निम्न तालिका पूर्वनिर्मित निकायों से संबद्ध चर आधार प्रकार को सूचीबद्ध करती है।

निकाय	चर आधार प्रकार
बहुविकल्पी विकल्प	विकल्प
उपयोगकर्ता की पूरी प्रतिक्रिया	स्ट्रिंग
आयु	नंबर
बूलियन	बूलियन
शहर	स्ट्रिंग
रंग	स्ट्रिंग
महाद्वीप	स्ट्रिंग
देश या क्षेत्र	स्ट्रिंग
तिथि और समय	तिथिसमय
ईमेल	स्ट्रिंग
ईवेंट	स्ट्रिंग
पूर्णांक	पूर्णांक
भाषा	स्ट्रिंग
धनराशि	नंबर
नंबर	नंबर
क्रमवाचक	नंबर
संगठन	स्ट्रिंग
प्रतिशत	नंबर
व्यक्ति का नाम	स्ट्रिंग
फ़ोन नंबर	स्ट्रिंग
रुचिकर बिंदु	स्ट्रिंग
गति	नंबर
स्टेट	स्ट्रिंग
गली का पता	स्ट्रिंग
तापमान	नंबर
URL	स्ट्रिंग
वज़न	नंबर
ज़िप कोड	स्ट्रिंग
कस्टम निकाय	विकल्प

क्लासिक

Copilot Studio किसी उपयोगकर्ता की प्रतिक्रियाओं से एक विशेष जानकारी को समझने एवं पहचानने के लिए निकायों का उपयोग करते हैं। पहचानी गई जानकारी को उस प्रकार के चर में सहेजा जाता है जो जानकारी के लिए उपयुक्त है।

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

उदाहरण के लिए, एक ऑपरेटर के लिए एक बूलियन आधार प्रकार का नक्शा "बराबर है" जिसमें संभावित मान सही या गलत हैं। एक संख्या आधार प्रकार आपको संख्यात्मक ऑपरेटर देता है जैसे कि "बराबर है," "से बड़ा है," या "से अधिक या बराबर है," और इसी तरह।

निकाय	चर आधार प्रकार
एकाधिक विकल्प	स्ट्रिंग
उपयोगकर्ता की पूरी प्रतिक्रिया	स्ट्रिंग
आयु	नंबर
बूलियन	बूलियन
शहर	स्ट्रिंग
रंग	स्ट्रिंग
महाद्वीप	स्ट्रिंग
देश या क्षेत्र	स्ट्रिंग
तिथि और समय	स्ट्रिंग
अवधि	स्ट्रिंग
ईमेल	स्ट्रिंग
ईवेंट	स्ट्रिंग
भाषा	स्ट्रिंग
धनराशि	स्ट्रिंग
नंबर	स्ट्रिंग
क्रमवाचक	स्ट्रिंग
संगठन	स्ट्रिंग
प्रतिशत	नंबर
व्यक्ति का नाम	स्ट्रिंग
फ़ोन नंबर	स्ट्रिंग
रुचिकर बिंदु	स्ट्रिंग
गति	नंबर
स्टेट	स्ट्रिंग
गली का पता	स्ट्रिंग
तापमान	नंबर
URL	स्ट्रिंग
वज़न	नंबर
ज़िप कोड	स्ट्रिंग
कस्टम निकाय	स्ट्रिंग

परिवेश चर

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

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

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

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

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

नोट

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

सिस्टम चर

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

नोट

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

Copilot Studio सभी सिस्टम चर नहीं दिखाता है। छुपे हुए सिस्टम चर तक पहुँचने के लिए, Power Fx सूत्र का उपयोग करें।

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

नाम	प्रकार	परिभाषा
गतिविधि.अनुलग्नक	टेबल	उपयोगकर्ता द्वारा प्रदान किए जाने वाले फ़ाइल अनुलग्नक।
Activity.Channel	विकल्प	मौजूदा वार्तालाप का चैनल आईडी।
Activity.ChannelData	कोई भी	एक ऑब्जेक्ट जिसमें चैनल-विशिष्ट सामग्री है।
Activity.ChannelId	डोरी	वर्तमान वार्तालाप की चैनल आईडी, एक स्ट्रिंग के रूप में।
Activity.From.Id	डोरी	भेजने वाले की चैनल-विशिष्ट यूनीक आईडी।
Activity.From.नाम	डोरी	भेजने वाले का चैनल-विशिष्ट उपयोगकर्ता-अनुकूल नाम।
Activity.नाम	डोरी	ईवेंट का नाम
Activity.Recipient.Id	डोरी	आवक गतिविधि का प्रकार गुण।
Activity.Recipient.नाम	डोरी	चैनल के भीतर एजेंट के प्रदर्शन नाम का प्रतिनिधित्व करता है। टेलीफोनी चैनल संदर्भ में, इस चर का मान वह फ़ोन नंबर है जिससे एजेंट जुड़ा हुआ है।
Activity.Text	डोरी	उपयोगकर्ता द्वारा भेजा गया सबसे हालिया संदेश।
Activity.Type	विकल्प	गतिविधि का प्रकार।
Activity.TypeId	डोरी	गतिविधि का प्रकार, एक स्ट्रिंग के रूप में।
Activity.Value	कोई भी	ओपन-एंडेड वैल्यू।
Bot.EnvironmentId	डोरी	एजेंट की पर्यावरण आईडी।
Bot.Id	डोरी	एजेंट की आईडी
Bot.नाम	डोरी	एजेंट का नाम।
Bot.Schemaनाम	डोरी	एजेंट का स्कीमा नाम।
Bot.TenantId	डोरी	एजेंट की टैनेंट आईडी.
ClientPluginActions	विकल्प	गतिशील क्लाइंट प्लग-इन एक्शन का संग्रह जनरेटिव ऑर्केस्ट्रेशन के लिए विचार करने के लिए।
Conversation.Id	डोरी	मौजूदा वार्तालाप का यूनिक आईडी।
Conversation.InTestMode	बूलियन	बूलियन ध्वज जो दर्शाता है कि क्या वार्तालाप परीक्षण कैनवास में हो रहा है।
Conversation.LocalTimeZone	डोरी	IANA समय क्षेत्र डेटाबेस स्वरूप में उपयोगकर्ता द्वारा उपयोग किया जा करने के लिए समय क्षेत्र का नाम।
Conversation.LocalTimeZoneOffset	datetime	वर्तमान स्थानीय समय क्षेत्र के लिए UTC से ऑफ़सेट समय।
Error.Code	डोरी	वर्तमान त्रुटि के लिए त्रुटि कोड। वर्तमान त्रुटि के लिए त्रुटि संदेश।
Error.Message	डोरी	वर्तमान त्रुटि के लिए त्रुटि संदेश। नोट: यह चर केवल तभी समर्थित होता है जब ट्रिगर हो On Error।
FallbackCount	संख्या	यह चर उस समय की गणना करता है जब किसी विषय का उपयोगकर्ता इनपुट से मिलान नहीं किया जा सका। नोट: यह चर केवल तभी समर्थित होता है जब ट्रिगर हो On Unknown Intent।
InactivityTimer.Continue	बूलियन	बूलियन ध्वज जो दर्शाता है कि टाइमर को जारी रखने की आवश्यकता है या नहीं। नोट: यह चर केवल तभी समर्थित होता है जब ट्रिगर हो Inactivity।
InactivityTimer.Count	संख्या	कॉन्फ़िगर किए गए समय के बाद उपयोगकर्ता की निष्क्रियता के कारण OnInactivity टाइमर को निकाल दिए जाने की संख्या। नोट: यह चर केवल तभी समर्थित होता है जब ट्रिगर हो Inactivity।
LastMessage.Id	डोरी	उस उपयोगकर्ता द्वारा भेजे गए पिछले संदेश की आईडी।
LastMessage.Text	डोरी	उस उपयोगकर्ता द्वारा भेजे गए पिछले संदेश की ID।
Recognizer.ExtractedEntities	विकल्प	ट्रिगर संदेश से निकाली गई संस्थाओं का प्रतिनिधित्व करता है। नोट: यह चर केवल तभी समर्थित होता है जब ट्रिगर हो On Select Intent।
Recognizer.IntentOptions	विकल्प	कार्यवाही विकल्पों का प्रतिनिधित्व करता है जब पहचानकर्ता अस्पष्ट परिणाम देता है। नोट: यह चर केवल तभी समर्थित होता है जब ट्रिगर हो On Select Intent।
Recognizer.SelectedIntent	विकल्प	पहचानकर्ता से चुने गई कार्यवाही का प्रतिनिधित्व करता है। नोट: यह चर केवल तभी समर्थित होता है जब ट्रिगर हो On Select Intent।
Recognizer.TriggeringMessage.Id	डोरी	उपयोगकर्ता संदेश की ID जिसने वर्तमान विषय को ट्रिगर किया है।
Recognizer.TriggeringMessage.Text	डोरी	उपयोगकर्ता संदेश जिसने वर्तमान विषय को ट्रिगर किया है।
Recognizer.MultipleTopicsMatchedReason	डोरी	यह निर्धारित करने के लिए उपयोग किया जाता है कि कई विषयों का मिलान क्यों किया गया था। नोट: यह चर केवल तभी समर्थित होता है जब ट्रिगर हो On Select Intent।
SignInReason	विकल्प	यह निर्धारित करने के लिए उपयोग किया जाता है कि विषय को ट्रिगर करते समय किस साइन-इन विकल्प की आवश्यकता है। नोट: यह चर केवल तभी समर्थित होता है जब ट्रिगर हो On Sign In।
User.Language	विकल्प	इस चर का उपयोग प्रति वार्तालाप उपयोगकर्ता भाषा लोकेल सेट करने के लिए किया जाता है।

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

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

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

नाम	प्रकार	परिभाषा
User.DisplayName	डोरी	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता का डिस्प्ले नाम।
User.Email	डोरी	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता का ईमेल एड्रेस।
User.Firstनाम	डोरी	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता का प्रथम नाम।
User.Id	डोरी	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता की यूनिक ID।
User.IsLoggedIn	बूलियन	बूलियन ध्वज जो दर्शाता है कि वर्तमान में एजेंट से बात कर रहा उपयोगकर्ता प्रमाणित है या नहीं।
User.LastName	डोरी	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता का फैमिली नाम।
User.PrincipalName	डोरी	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता का यूज़र प्रिंसिपल नाम।

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

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

नाम	प्रकार	परिभाषा
User.AccessToken	डोरी	एजेंट के साथ प्रमाणित करने वाले उपयोगकर्ता के लिए एक्सेस टोकन।
User.DisplayName	डोरी	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता का डिस्प्ले नाम।
User.Id	डोरी	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता की यूनिक ID।
User.IsLoggedIn	बूलियन	बूलियन ध्वज जो दर्शाता है कि वर्तमान में एजेंट से बात कर रहा उपयोगकर्ता प्रमाणित है या नहीं।

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

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

नाम	प्रकार	परिभाषा
User.AccessToken	डोरी	एजेंट के साथ प्रमाणित करने वाले उपयोगकर्ता के लिए एक्सेस टोकन।
User.DisplayName	डोरी	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता का डिस्प्ले नाम।
User.Email	डोरी	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता का ईमेल एड्रेस।
User.Firstनाम	डोरी	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता का प्रथम नाम।
User.Id	डोरी	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता की यूनिक ID।
User.IsLoggedIn	बूलियन	बूलियन ध्वज जो दर्शाता है कि वर्तमान में एजेंट से बात कर रहा उपयोगकर्ता प्रमाणित है या नहीं।
User.LastName	डोरी	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता का फैमिली नाम।
User.PrincipalName	डोरी	वर्तमान में एजेंट से बात कर रहे उपयोगकर्ता का यूज़र प्रिंसिपल नाम।

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

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

नोट

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

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