Κοινή χρήση μέσω

Αυτόματη έναρξη μιας συνομιλίας παράγοντα

  • Άρθρο

Μπορείτε να ρυθμίσετε τις παραμέτρους του εκπροσώπου σας ώστε να ξεκινά μια συνομιλία με έναν χρήστη. Μπορείτε επίσης να συνδυάσετε τον προσαρμοσμένο χαιρετισμό με προσαρμογή της εμφάνισης και της αίσθησης του παράγοντα.

Σημαντικό

Ο παράγοντας θα ξεκινήσει τη συνομιλία και θα εμφανιστεί στην ανάλυση και θα αυξήσει τον αριθμό περιόδων λειτουργίας.

Αν ο χρήστης του παράγοντα σας δεν συνομιλήσει με τον παράγοντα (για παράδειγμα, φορτώνουν τη σελίδα αλλά δεν θέτουν ερωτήσεις στον παράγοντα), η περίοδος λειτουργίας θα επισημανθεί ως μη δεσμευμένη περίοδος λειτουργίας. Αυτό ενδέχεται να επηρεάσει την ανάλυση.

Από προεπιλογή, οι παράγοντες που δημιουργούνται με το Copilot Studio και δημοσιεύονται σε μια τοποθεσία web θα φορτωθούν χωρίς χαιρετισμό και θα περιμένουν παθητικά μέχρι ο χρήστης να ξεκινήσει τη συνομιλία.

Ωστόσο, μπορείτε να χρησιμοποιήσετε προσαρμοσμένο CSS και κώδικα JavaScript για να ξεκινήσει τον παράγοντα αυτόματα τη συνομιλία όταν φορτώνεται ο παράγοντας. Για παράδειγμα, θα μπορούσε ο παράγοντας να πει, "Γεια σας, είμαι ο Στέλιος, ένας ψηφιακός βοηθός" μόλις φορτώνεται τον παράγοντα.

Αρχικά, πρέπει να αναπτύξετε έναν προσαρμοσμένο καμβά που περιλαμβάνει ορίσματα που ενεργοποιούν τον χαιρετισμό. Από προεπιλογή, ο προσαρμοσμένος καμβάς καλεί το προεπιλεγμένο θέμα χαιρετισμού συστήματος. Ωστόσο, μπορείτε να δημιουργήσετε ένα νέο θέμα να χρησιμοποιηθεί ως χαιρετισμός. Πρέπει να εκτρέψετε το προεπιλεγμένο θέμα χαιρετισμού του συστήματος σε ένα νέο θέμα.

Σημαντικό

Μπορείτε να εγκαταστήσετε και να χρησιμοποιήσετε το δείγμα κώδικα που περιλαμβάνεται σε αυτήν την τεκμηρίωση μόνο για χρήση με το προϊόν Copilot Studio. Το δείγμα κώδικα διαθέτει άδεια χρήσης "ως έχει" και εξαιρείται από οποιεσδήποτε συμβάσης παροχής υπηρεσιών ή υπηρεσίες υποστήριξης. Το χρησιμοποιείτε με δική σας ευθύνη.

Η Microsoft δεν παρέχει καμία ρητή εγγύηση ή όρο και αποποιείται ρητά όλες τις σιωπηρές εγγυήσεις, συμπεριλαμβανομένης της εμπορευσιμότητας, καταλληλότητας για συγκεκριμένο σκοπό και μη παραβίασης πνευματικών δικαιωμάτων.

Ανάκτηση τελικού σημείου διακριτικού

Για να προσαρμόσετε τον καμβά σας, είτε πρόκειται για τον προεπιλεγμένο καμβά είτε για έναν προσαρμοσμένο στον οποίο συνδέεστε, πρέπει να ανακτήσετε τις λεπτομέρειες του παράγοντα σας.

  1. Στο μενού πλοήγησης, στις Ρυθμίσεις επιλέξτε Κανάλια.

  2. Επιλέξτε Εφαρμογή για κινητές συσκευές.

    Στιγμιότυπο οθόνης του πλακιδίου καναλιού εφαρμογής για κινητές συσκευές.

  3. Δίπλα στο Τελικό σημείο διακριτικού, επιλέξτε Αντιγραφή.

    Στιγμιότυπο οθόνης του αναγνωριστικού διακριτικού τελικού σημείου.

Προσαρμογή του προεπιλεγμένου καμβά (απλός)

Ρυθμίστε την εμφάνιση του καμβά συνομιλίας με ορισμένες απλές επιλογές στυλ CSS και JavaScript.

Αρχικά, θα πρέπει να ρυθμίσετε τις παραμέτρους για το σημείο ανάπτυξης του καμβά bot σας.

  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. Δημοσίευση του παράγοντά σας.

Τώρα μπορείτε να δοκιμάσετε τον παράγοντα σας στην ιστοσελίδα όπου αναπτύξτε τον προσαρμοσμένο καμβά του παράγοντα σας. Μπορείτε να δείτε τον τρόπο έναρξης της συνομιλίας bot με αυτόματη εμφάνιση του θέματος χαιρετισμού.

Δημιουργήστε ένα νέο θέμα χρήστη

Προειδοποίηση

Η χρήση ενός θέματος χρήστη για την έναρξη μιας συνομιλίας θα αυξήσει τις περιόδους χρέωσης. Η περίοδος λειτουργίας χρέωσης είναι μια αλληλεπίδραση μεταξύ ενός πελάτη και ενός παράγοντα και αντιπροσωπεύει μια μονάδα κατανάλωσης. Η περίοδος λειτουργίας χρέωσης ξεκινά όταν ενεργοποιηθεί το θέμα χρήστη. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Διαχείριση χωρητικότητας μηνυμάτων.

  1. Στο μενού πλοήγησης, επιλέξτε Θέματα.

  2. Επιλέξτε Νέο θέμα και δώστε του ένα όνομα.

  3. Προσθέστε το κείμενο εντός του κόμβου Μήνυμα.

  4. Όταν ολοκληρώσετε την επεξεργασία του μηνύματος, επιλέξτε Αποθήκευση.

  5. Στο μενού πλοήγησης, επιλέξτε Θέματα και μετά επιλέξτε τη γραμμή θέματος Χαιρετισμός.

  6. Διαγράψτε τους κόμβους μηνυμάτων στο θέμα Χαιρετισμός.

  7. Για να γίνει αυτόματα χρήση του παράγοντα σε ένα θέμα χρήστη, επιλέξτε Προσθήκη κόμβου (+) για να προσθέσετε έναν κόμβο και, στη συνέχεια, επιλέξτε Μετάβαση σε άλλο θέμα.

  8. Στο μενού αναδυόμενης επιλογής, επιλέξτε το θέμα χρήστη που δημιουργήσατε παραπάνω.

  9. Όταν ολοκληρώσετε την επεξεργασία του μηνύματος, επιλέξτε Αποθήκευση.

  10. Δημοσίευση του παράγοντά σας.

Τώρα μπορείτε να δοκιμάσετε τον παράγοντα σας στην ιστοσελίδα όπου αναπτύξτε τον προσαρμοσμένο καμβά του παράγοντα σας. Θα δείτε τον τρόπο έναρξης της συνομιλίας παράγοντα με αυτόματη εμφάνιση του νέου θέματος.