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

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

  • आलेख

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

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

एजेंट से वार्तालाप प्रारंभ करने पर यह आपके विश्लेषण में दिखाई देता है और आपकी सत्र संख्या में वृद्धि करता है।

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

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

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

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

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

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

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

टोकन एंडपॉइंट प्राप्त करें

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

  1. नेविगेशन मेनू में सेटिंग्स के अंतर्गत, चैनल का चयन करें.

  2. मोबाइल ऐप चुनें.

    मोबाइल ऐप चैनल टाइल का स्क्रीनशॉट.

  3. टोकन एंडपॉइंट के आगे, कॉपी करें चुनें.

    एंडपॉइंट टोकन आईडी का स्क्रीनशॉट.

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

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

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

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

  2. यहां दिखाए गए 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>

  3. आपके द्वारा बनाई गई index.html फ़ाइल में, var theURL = "<YOUR TOKEN ENDPOINT>"; पंक्ति पर अपना टोकन एंडपॉइंट दर्ज करें।

  4. कस्टम कैनवास में एजेंट को खोलने के लिए एक आधुनिक ब्राउज़र (उदाहरण के लिए, ) का उपयोग करके index.html Microsoft Edge खोलें।

  5. यह सुनिश्चित करने के लिए कि आपको अपने एजेंट से प्रतिक्रियाएं मिल रही हैं और एजेंट सही ढंग से काम कर रहा है, एजेंट का परीक्षण करें।

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

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

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

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

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

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

  1. नेविगेशन मेनू में, विषय का चयन करें, फिर अभिवादन विषय पंक्ति का चयन करें।

    विषय पृष्ठ का स्क्रीनशॉट, जिसमें अभिवादन विषय हाइलाइट किया गया है।

  2. संदेश नोड्स के अंदर पाठ संपादित करें. आप अतिरिक्त नोड्स भी जोड़ या हटा सकते हैं.

  3. सहेजें चुनें.

  4. अपना एजेंट प्रकाशित करें.

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

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

चेतावनी

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

  1. नेविगेशन मेनू में, विषय चुनें.

  2. नया विषय चुनें, और इसे एक नाम दें।

  3. संदेश नोड के अंदर पाठ जोड़ें.

  4. जब आप संदेश का संपादन समाप्त कर लें तो सहेजें का चयन करें.

  5. नेविगेशन मेनू में, विषय का चयन करें, फिर अभिवादन विषय पंक्ति का चयन करें।

  6. ग्र ीटिंग विषय पर संदेश नोड्स को हटाएं।

  7. एजेंट को स्वचालित रूप से उपयोगकर्ता विषय पर भेजने के लिए, नोड जोड़ने के लिए नोड जोड़ें (+) का चयन करें, और फिर अन्य विषय पर जाएँ का चयन करें।

  8. फ़्लाईआउट मेन्यू में, आपके द्वारा ऊपर बनाया गया उपयोगकर्ता विषय चुनें.

  9. जब आप संदेश का संपादन समाप्त कर लें तो सहेजें का चयन करें।

  10. अपना एजेंट प्रकाशित करें.

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