एजेंट वार्तालाप स्वचालित रूप से प्रारंभ करें

आलेख
12/03/2024

आप अपने एजेंट को किसी उपयोगकर्ता के साथ वार्तालाप प्रारंभ करने के लिए कॉन्फ़िगर कर सकते हैं. आप एजेंट के लुक और फील के अनुसार कस्टमाइज्ड ग्रीटिंग को कस्टमाइजेशन के साथ भी जोड़ सकते हैं।

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

एजेंट द्वारा बातचीत शुरू करने से यह आपके विश्लेषण में दिखाई देता है और आपकी सत्र संख्या बढ़ जाती है।

यदि आपके एजेंट का उपयोगकर्ता एजेंट के साथ सहभागिता नहीं करता है (उदाहरण के लिए, वे पृष्ठ लोड करते हैं लेकिन एजेंट से कुछ नहीं पूछते हैं), तो सत्र को असहभागिता सत्र के रूप में चिह्नित किया जाता है। यह आपकी वैश्लेषिकी को प्रभावित कर सकता है.

वेब अप्प
टीमें

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

हालाँकि, आप कस्टम CSS और जावास्क्रिप्ट कोड का उपयोग कर सकते हैं ताकि एजेंट लोड होने पर एजेंट स्वचालित रूप से वार्तालाप शुरू कर सके। उदाहरण के लिए, आप अपने एजेंट से कह सकते हैं कि, "हाय, मैं बोटी हूं, एक वर्चुअल एजेंट" जैसे ही एजेंट लोड होता है।

सबसे पहले, आपको एक कस्टम कैनवास तैनात करना होगा जिसमें अभिवादन को ट्रिगर करने वाले तर्क शामिल हों। डिफ़ॉल्ट रूप से, कस्टम कैनवास, डिफ़ॉल्ट सिस्टम अभिवादन विषय को कॉल करता है. हालाँकि, आप अभिवादन के रूप में उपयोग करने के लिए एक नया विषय बना सकते हैं। आपको डिफ़ॉल्ट सिस्टम ग्रीटिंग विषय को एक नए विषय पर ले जाना होगा।

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

आप इस दस्तावेज़ में शामिल नमूना कोड को केवल उत्पाद के साथ उपयोग के लिए स्थापित और उपयोग कर सकते हैं। Copilot Studio नमूना कोड "जैसा है" के रूप में लाइसेंसयुक्त है तथा किसी भी सेवा स्तर अनुबंध या समर्थन सेवाओं से बाहर रखा जाता है. इसका उपयोग करने का जोखिम आपका होगा.

Microsoft कोई अभिव्यक्त वारंटी, गारंटी या शर्तें नहीं देता है तथा जिसमें व्यापारिकता, किसी विशेष उद्देश्य के लिए फिटनेस और गैर-उल्लंघन सहित सभी निहित वारंटियां सम्मिलित नहीं होती हैं.

टोकन समापन बिंदु पुनः प्राप्त करें

अपने कैनवास को अनुकूलित करने के लिए, चाहे वह डिफ़ॉल्ट कैनवास हो या आपके द्वारा कनेक्ट किया गया कस्टम कैनवास हो, आपको अपने एजेंट का विवरण प्राप्त करना होगा।

नेविगेशन मेनू में सेटिंग्स के अंतर्गत, चैनल चुनें.
मोबाइल ऐप चुनें.
टोकन एंडपॉइंट के आगे, कॉपी करें चुनें.

डिफ़ॉल्ट कैनवास (सरल) को अनुकूलित करें

कुछ सरल CSS और जावास्क्रिप्ट स्टाइलिंग विकल्पों के साथ चैट कैनवास कैसा दिखाई देगा, इसे कॉन्फ़िगर करें।

सर्वप्रथम, आपको यह कॉन्फ़िगर करने की आवश्यकता होती है कि आप अपना बॉट कैनवास कहां परिनियोजित कर रहे हैं.

एक एजेंट बनाएँ और प्रकाशित करें.

यहां दिखाए गए HTML कोड को कॉपी और पेस्ट करें और इसे index.html के रूप में सहेजें।
आप कोड को w3schools.com HTML try it editor में कॉपी और पेस्ट भी कर सकते हैं। आपको अभी भी अपना टोकन एंडपॉइंट जोड़ना होगा.

<!DOCTYPE html>
<html>
<head>
    <title>Contoso Sample Web Chat</title> 
    <!-- This styling is for the Web Chat demonstration purposes. It is recommended that style is moved to a separate file for organization in larger projects -->
    <style>
        html, body {
            height: 100%;
        }

        body {
            margin: 0;
        }

        h1 {
            font-size: 16px;
            font-family: Segoe UI;
            line-height: 20px;
            color: whitesmoke;
            display: table-cell;
            padding: 13px 0px 0px 20px;
        }

        #heading {
            background-color: black;
            height: 50px;
        }

        .main {
            margin: 18px;
            border-radius: 4px;
        }

        div[role="form"]{
            background-color: black;
        }

        #webchat {
            position: fixed;
            height: calc(100% - 50px);
            width: 100%;
            top: 50px;
            overflow: hidden;
        }

    </style>

</head>
<body>
    <div>
        <div id="heading">
            <!-- Change the h1 text to change the bot name -->    
            <h1>Contoso Bot Name</h1>
        </div>
        <div id="webchat" role="main"></div>
    </div>    

  <script src="https://cdn.botframework.com/botframework-webchat/latest/webchat.js"></script>

  <script>
        const styleOptions = {

           // Add styleOptions to customize Web Chat canvas
           hideUploadButton: true
        };

        // Add your BOT token endpoint below
        var theURL = "<BOT TOKEN ENDPOINT>";

        var environmentEndPoint = theURL.slice(0,theURL.indexOf('/powervirtualagents'));
        var apiVersion = theURL.slice(theURL.indexOf('api-version')).split('=')[1];
        var regionalChannelSettingsURL = `${environmentEndPoint}/powervirtualagents/regionalchannelsettings?api-version=${apiVersion}`; 

        var directline;
            fetch(regionalChannelSettingsURL)
                .then((response) => {
                    return response.json();
                    })
                .then((data) => {
                    directline = data.channelUrlsById.directline;
                    })
                .catch(err => console.error("An error occurred: " + err));

      fetch(theURL)
            .then(response => response.json())
            .then(conversationInfo => {
                window.WebChat.renderWebChat(
                    {
                        directLine: window.WebChat.createDirectLine({
                            domain: `${directline}v3/directline`,
                            token: conversationInfo.token,
                        }),
                        styleOptions
                    },
                    document.getElementById('webchat')
                );
            })
            .catch(err => console.error("An error occurred: " + err));

    </script>
  </body>
</html>

आपके द्वारा बनाई गई index.html फ़ाइल में, var theURL = "<YOUR TOKEN ENDPOINT>"; पंक्ति पर अपना टोकन समापन बिंदु दर्ज करें।
कस्टम कैनवास में एजेंट को खोलने के लिए आधुनिक ब्राउज़र (उदाहरण के लिए, ) का उपयोग करके index.html Microsoft Edgeखोलें.
यह सुनिश्चित करने के लिए एजेंट का परीक्षण करें कि आपको अपने एजेंट से प्रतिक्रियाएं मिल रही हैं और एजेंट सही ढंग से काम कर रहा है।

यदि आपको कोई समस्या आती है, तो सुनिश्चित करें कि आपने अपना एजेंट प्रकाशित कर दिया है, तथा आपका टोकन एंडपॉइंट सही स्थान पर डाला गया है। टोकन समापन बिंदु पंक्ति var theURL = "<YOUR TOKEN ENDPOINT>" पर बराबर चिह्न (=) के बाद होना चाहिए, तथा दोहरे उद्धरण चिह्नों (") से घिरा होना चाहिए।

एजेंट का डिफ़ॉल्ट अभिवादन बदलें

index.html फ़ाइल में कोड एजेंट लोड होने पर विषय को स्वचालित रूप से कॉल करने का कारण बनता है। डिफ़ॉल्ट रूप से, कोड सिस्टम ग्रीटिंग टॉपिक को कॉल करता है। आप एक नया विषय भी बना सकते हैं और डिफ़ॉल्ट सिस्टम अभिवादन विषय को उस नये विषय में बदल सकते हैं.

दोनों उदाहरणों में, आप उस विषय में परिवर्तन करते हैं जिसे आप कॉल करना चाहते हैं जैसा कि आप सामान्य रूप से करते हैं।

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

हम अनुशंसा करते हैं कि आप सिस्टम अभिवादन विषय को संशोधित करें ताकि आपको index.html कोड को संपादित न करना पड़े।

सिस्टम अभिवादन विषय को संशोधित करें (अनुशंसित)

नेविगेशन मेनू में, विषय का चयन करें, फिर अभिवादन विषय पंक्ति का चयन करें।
संदेश नोड्स के अंदर पाठ संपादित करें. आप अतिरिक्त नोड्स भी जोड़ या हटा सकते हैं.
सहेजें चुनें.
अपना एजेंट प्रकाशित करें.

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

एक नया उपयोगकर्ता विषय बनाएँ

चेतावनी

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

नेविगेशन मेनू में, विषय चुनें.
नया विषय चुनें, और उसे एक नाम दें।
संदेश नोड के अंदर पाठ जोड़ें.
जब आप संदेश का संपादन समाप्त कर लें तो सहेजें का चयन करें.
नेविगेशन मेनू में, विषय का चयन करें, फिर अभिवादन विषय पंक्ति का चयन करें।
अभ िवादन विषय पर संदेश नोड्स को हटाएँ.
एजेंट को स्वचालित रूप से उपयोगकर्ता विषय पर डायवर्ट करने के लिए, नोड जोड़ने के लिए नोड जोड़ें (+) का चयन करें, और फिर किसी अन्य विषय पर जाएँ का चयन करें.
फ़्लाईआउट मेन्यू में, आपके द्वारा ऊपर बनाया गया उपयोगकर्ता विषय चुनें.
जब आप संदेश का संपादन समाप्त कर लें तो सहेजें का चयन करें।
अपना एजेंट प्रकाशित करें.

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

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

एजेंट वार्तालाप स्वचालित रूप से प्रारंभ करें

टोकन समापन बिंदु पुनः प्राप्त करें

डिफ़ॉल्ट कैनवास (सरल) को अनुकूलित करें

एजेंट का डिफ़ॉल्ट अभिवादन बदलें

सिस्टम अभिवादन विषय को संशोधित करें (अनुशंसित)

एक नया उपयोगकर्ता विषय बनाएँ

एजेंट का डिफ़ॉल्ट अभिवादन बदलें

प्रतिक्रिया

अतिरिक्त संसाधन