बॉट के लिए संदर्भ वैरिएबल कॉन्फ़िगर करें

महत्त्वपूर्ण

Power Virtual Agents जनरेटिव एआई और उन्नत एकीकरण में महत्वपूर्ण निवेश के बाद अब इसकी क्षमताएं और विशेषताएं इसका हिस्सा बन गई हैं। Microsoft Copilot Studio Microsoft Copilot

कुछ लेख और स्क्रीनशॉट इस बात का संदर्भ दे सकते हैं कि Power Virtual Agents जब हम दस्तावेज़ और प्रशिक्षण सामग्री को अपडेट करते हैं।

यह आलेख Azure और Copilot Studio बॉट के लिए संदर्भ चरों को सूचीबद्ध करता है, और बताता है कि आप उन्हें Customer Service के लिए ओमनीचैनल में कैसे कॉन्फ़िगर कर सकते हैं. संदर्भ चर बनाने के तरीके को समझने के लिए, संदर्भ चर प्रबंधित करें देखें।

Azure बॉट के लिए संदर्भ वैरिएबल

निम्न तालिका में ग्राहक सेवा के लिए ओमनीचैनल में संदर्भ चरों की सूची है जिसका उपयोग आप Azure बॉट कॉन्फ़िगर करने के लिए कर सकते हैं।

संदर्भ चर प्रकार	संदर्भ चर का नाम	विवरण	Azure में मैप कैसे करें
पूर्व-वार्तालाप सर्वेक्षण	Customer Service के लिए ओमनीचैनल में आपके द्वारा बनाए गए पूर्व-वार्तालाप सर्वेक्षण प्रश्न नाम का उपयोग करें।	यह प्रणाली पूर्व-वार्तालाप सर्वेक्षण से प्राप्त प्रतिक्रियाओं को संदर्भ चर के रूप में संग्रहीत करती है।	Customer Service के लिए ओमनीचैनल में प्रश्न नाम को Azure में चर प्रकार के साथ मैप करने के लिए निम्न जानकारी का उपयोग करें: एकल पंक्ति: स्ट्रिंग एकाधिक लाइनें: स्ट्रिंग विकल्प सेट: स्ट्रिंग उपयोगकर्ता सहमति: बूलियन
कस्टम संदर्भ	Customer Service के लिए ओमनीचैनल में आपके द्वारा बनाए गए चर नाम को उपयोग करें या setContextProvider API का उपयोग करके पास करें.	आपके द्वारा बनाए गए कस्टम संदर्भ वैरिएबल को लाइव चैट SDK के माध्यम से पास किया जा सकता है।	Customer Service के लिए ओमनीचैनल में कस्टम संदर्भ चर का उपयोग करने के लिए उपयोगकर्ता के प्रत्युत्तर को JSON के रूप में मैप करें।
वार्तालाप	msdyn_ConversationId	उस संदर्भ चर का उपयोग करें जिसमें चल रहे वार्तालाप के लिए वार्तालाप ID है और Microsoft Dataverse में रिकॉर्ड प्राप्त और कार्य कर सकता है.	स्ट्रिंग: स्ट्रिंग
संपर्क	msdyn_contact_msdyn_ocliveworkitem_Customer	इस संदर्भ चर का उपयोग करें जिसमें उस ग्राहक के लिए रिकॉर्ड ID (संपर्क) रिकॉर्ड है जो वार्तालाप से जुड़ा है.	रिकॉर्ड ID निकालने के लिए JSON को पार्स करें
खाता	msdyn_account_msdyn_ocliveworkitem_Customer	इस संदर्भ चर का उपयोग करें जिसमें वार्तालाप से जुड़े खाता रिकॉर्ड के लिए रिकॉर्ड ID है.	रिकॉर्ड ID निकालने के लिए JSON को पार्स करें
मामला	msdyn_incident_msdyn_ocliveworkitem	इस संदर्भ चर का उपयोग करें जिसमें वार्तालाप से जुड़े केस रिकॉर्ड के लिए रिकॉर्ड ID है.	रिकॉर्ड ID निकालने के लिए JSON को पार्स करें

नोट

संदर्भ चर नामों का उपयोग परिभाषित अनुसार करें और जब आप Azure या बॉट में प्रवाह लिखते हैं तो उन्हें न बदलें. Copilot Studio साथ ही, संदर्भ चर के मान को पास करने के लिए सटीक मिलान का उपयोग करना सुनिश्चित करें क्योंकि यह केस-संवेदी है। अगर कोई मेल नहीं खाता है, तो रिकॉर्ड स्वचालित रूप से पहचाना नहीं जाएगा। और अधिक जानकारी: रिकॉर्ड को स्वचालित रूप से पहचानें

Copilot Studio बॉट्स के लिए संदर्भ चर

निम्न तालिका में Customer Service के लिए ओमनीचैनल में उपलब्ध संदर्भ चरों की सूची है, जिसका उपयोग आप बॉट्स Copilot Studio कॉन्फ़िगर करने के लिए कर सकते हैं।

महत्त्वपूर्ण

संदेश और ध्वनि चर का उपयोग करने के लिए, सुनिश्चित करें कि आपने पहले एक्सटेंशन समाधान इंस्टॉल कर लिया है।

संदर्भ चर प्रकार	संदर्भ चर का नाम	विवरण	मानचित्र कैसे बनाएं Copilot Studio
पूर्व-वार्तालाप सर्वेक्षण	Customer Service के लिए ओमनीचैनल में आपके द्वारा बनाए गए पूर्व-वार्तालाप सर्वेक्षण प्रश्न नाम का उपयोग करें।	यह प्रणाली पूर्व-वार्तालाप सर्वेक्षण से प्राप्त प्रतिक्रियाओं को संदर्भ चर के रूप में संग्रहीत करती है।	Customer Service के लिए ओमनीचैनल में प्रश्न नाम को Copilot Studio में चर प्रकार के साथ मैप करने के लिए निम्नलिखित जानकारी का उपयोग करें: एकल पंक्ति: उपयोगकर्ता की पूरी प्रतिक्रिया एकाधिक पंक्ति: उपयोगकर्ता की पूरी प्रतिक्रिया विकल्प सेट: उपयोगकर्ता की पूरी प्रतिक्रिया उपयोगकर्ता सहमति: बूलियन
कस्टम संदर्भ	उस चर नाम का उपयोग करें जिसे आप Customer Service के लिए ओमनीचैनल में बनाते हैं या setContextProvider API का उपयोग करके पास करते हैं।	आपके द्वारा बनाए गए कस्टम संदर्भ वैरिएबल को लाइव चैट SDK के माध्यम से पास किया जा सकता है।	Customer Service के लिए ओमनीचैनल में कस्टम संदर्भ चर को Copilot Studio में चर प्रकार के साथ मैप करने के लिए निम्नलिखित जानकारी का उपयोग करें: स्ट्रिंग: उपयोगकर्ता की पूरी प्रतिक्रिया बूलियन: बूलियन नंबर, फ्लोटिंग नंबर: नंबर
वार्तालाप	msdyn_ConversationId	उस संदर्भ चर का उपयोग करें जिसमें चल रहे वार्तालाप के लिए वार्तालाप ID है और Microsoft Dataverse में रिकॉर्ड प्राप्त और कार्य कर सकता है.	स्ट्रिंग: उपयोगकर्ता की पूरी प्रतिक्रिया.
संदेश और आवाज चर	msdyn_CustomerType	इस संदर्भ चर का उपयोग करें जिसमें वार्तालाप से जुड़े खाता या संपर्क रिकॉर्ड के लिए ग्राहक प्रकार शामिल है.	Customer Service के लिए ओमनीचैनल एक्सटेंशन समाधान चर चुनें.
	msdyn_CustomerName	इस संदर्भ चर का उपयोग करें जिसमें वार्तालाप से जुड़े खाते या संपर्क रिकॉर्ड के लिए ग्राहक का नाम शामिल है.	Customer Service के लिए ओमनीचैनल एक्सटेंशन समाधान चर चुनें.
	msdyn_CustomerId	इस संदर्भ चर का उपयोग करें जिसमें वार्तालाप से जुड़े खाता या संपर्क रिकॉर्ड के लिए ग्राहक आईडी शामिल है.	Customer Service के लिए ओमनीचैनल एक्सटेंशन समाधान चर चुनें.
	msdyn_CaseId	इस संदर्भ चर का उपयोग करें जिसमें वार्तालाप से जुड़े केस रिकॉर्ड की आईडी शामिल है.	Customer Service के लिए ओमनीचैनल एक्सटेंशन समाधान चर चुनें.
	msdyn_CaseTitle	इस संदर्भ चर का उपयोग करें जिसमें वार्तालाप से जुड़े केस रिकॉर्ड का शीर्षक शामिल है.	Customer Service के लिए ओमनीचैनल एक्सटेंशन समाधान चर चुनें.
केवल वॉयस चर	CustomerPhoneNumber	टेलीफ़ोनी गतिविधि में ग्राहक के फ़ोन नंबर के लिए इस संदर्भ चर का उपयोग करें.	Customer Service के लिए ओमनीचैनल एक्सटेंशन समाधान चर चुनें.
	OrganizationPhoneNumber	टेलीफ़ोनी गतिविधि में संगठन के फ़ोन नंबर के लिए इस संदर्भ चर का उपयोग करें.	Customer Service के लिए ओमनीचैनल एक्सटेंशन समाधान चर चुनें.
एक्सटेंशन तरीका का नाम	va_SurveyConsent	इस संवाद का उपयोग यह निर्धारित करने के लिए करें कि ग्राहक बातचीत के दौरान सर्वेक्षण में भाग लेने के लिए सहमत है या नहीं।	Customer Service के लिए ओमनीचैनल को वार्तालाप विवरण आगे बढ़ाने के लिए इस विधि का उपयोग करें।
	va_CustomerLocale	इस संवाद का उपयोग वर्तमान में बॉट से बात कर रहे उपयोगकर्ता को किसी अन्य बॉट में स्थानांतरित करने के लिए करें जो एक अलग भाषा में बोल सकता है।	इनपुट चर का चयन करके और सही लोकेल कोड का उपयोग करके कोड सेट करें।

Copilot Studio बॉट के लिए संदर्भ चर कॉन्फ़िगर करें

अपने Copilot Studio बॉट को ओमनीचैनल से संदर्भ चर पढ़ने के लिए, निम्नलिखित चरण करें:

1. विषय पृष्ठ पर, एक विषय जोड़ें और रिक्त से चुनें.

2. अपने विषय के लिए एक नाम दर्ज करें (उदाहरण के लिए, "संदर्भ चर सेट करें") और इसे सहेजें।

3. विषय में एक नया नोड जोड़ें, और चर प्रबंधन > चर मान सेट करें चुनें

4. अपने नए नोड में, सेट वैरिएबल के अंतर्गत एक नया वैरिएबल बनाएं का चयन करें।

5. नए चर नाम पर क्लिक करके चर गुण फलक खोलें. फलक में, चर नाम को ओमनीचैनल संदर्भ चर के नाम से सटीक रूप से मेल खाने के लिए सेट करें (यह केस संवेदनशील है)।

6. संदर्भ अनुभाग में, दीर्घवृत्त (...) का चयन करें और खाली होने पर इस नोड से मान प्राप्त करें का चयन करें. Copilot Studio बॉट रनटाइम पर इस नोड से चर मान प्राप्त करता है।

7. उपयोग अनुभाग में, वैश्विक (कोई भी विषय पहुंच सकता है) और बाहरी स्रोत मान सेट कर सकते हैं का चयन करें। Copilot Studio ओमनीचैनल से डेटा स्वीकार करता है. चर गुण फलक बंद करें.

8. अपने नोड में, To value में एक मान दर्ज करें जो आपके बॉट द्वारा अपेक्षित डेटा प्रकार से मेल खाता हो। उदाहरण के लिए, यदि आपका बॉट एक स्ट्रिंग की अपेक्षा करता है, तो Text("") सेट करें। Copilot Studio यदि डेटा वार्तालाप में नहीं आता है तो यह उस मान पर वापस आ जाता है जिसे आपने यहां सेट किया था.

   

9. परिवर्तनों को सहेजें और प्रकाशित करें.

वार्तालाप के दौरान, ओमनीचैनल संदर्भ चर से डेटा Copilot Studio चरों में सेट किया जाता है और इसका उपयोग बॉट के तर्क में किया जा सकता है।

बॉट वार्तालाप के दौरान ओमनीचैनल संदर्भ चर भी सेट कर सकता है। अपने Copilot Studio तर्क से ओमनीचैनल चर सेट करने के लिए, सुनिश्चित करें कि आपका बॉट सही चर नाम का उपयोग कर रहा है और अपने चर प्रबंधन नोड में "To value" गुण में मान सेट करें। Copilot Studio एजेंट को ट्रांसफ़र करें के दौरान चर को ओमनीचैनल को सौंप दें। इसका उपयोग अक्सर बातचीत को उस मामले से जोड़ने के लिए किया जाता है जब बॉट बातचीत को किसी एजेंट तक पहुंचाता है। इस डेटा से ओमनीचैनल में रिकॉर्ड लिंक करने के तरीके के बारे में अधिक जानकारी: ग्राहक और मामले को वार्तालाप से लिंक करें

Copilot Studio में बनाए गए वैश्विक चरों को वार्तालाप को आगे बढ़ाने पर Customer Service के लिए ओमनीचैनल में पास किया जा सकता है। पूरी सूची के लिए, हैंड-ऑफ़ होने पर प्रासंगिक वैरिएबल उपलब्ध हैं देखें.

रिकॉर्ड आईडी निकालने के लिए पार्स JSON ऑब्जेक्ट

सुनिश्चित करें कि आपके पास निम्नलिखित विवरण हैं:

• Customer Service के लिए ओमनीचैनल संदर्भ चर, जैसे msdyn_contact_msdyn_ocliveworkitem_Customer.
• स्कीमा के विवरण

नमूना स्कीमा विवरण की प्रति इस प्रकार है:

        Schema: 
        {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "RecordId": {
                        "type": "string"
                    },
                    "PrimaryDisplayValue": {
                        "type": "string"
                    }
                },
                "required": [
                    "RecordId",
                    "PrimaryDisplayValue"
                ]
            }
        }

PrimaryDisplayValue Dataverse इकाइयों में विशेषता से मान शामिल है. निकाय विशेषताओं के लिए मानचित्रण इस प्रकार है:

• मामले: मामला शीर्षक
• संपर्क: पूरा नाम
• खाता: नाम

यहाँ एक नमूना प्रसंग रिकॉर्ड दिया गया है।

{
    "msdyn_contact_msdyn_ocliveworkitem_Customer": [
        {
            "RecordId": "<GUID>",
            "PrimaryDisplayValue": "<FullName>"
        }
    ],
    "msdyn_liveworkitemid": "<GUID>"
}

भी देखें

एक एकीकृत करें Copilot Studio बॉट
Azure बोट एकीकृत करें
बातचीत को आगे बढ़ाने और समाप्त करने के लिए बॉट को कॉन्फ़िगर करें
लाइव चैट SDK संदर्भ