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

Χρήση μεταβλητών για μεταφορά περιεχομένου σε διάφορα θέματα

  • Άρθρο

Οι μεταβλητές αποθηκεύουν τις απαντήσεις των πελατών σας σε ερωτήσεις του copilot σας. Για παράδειγμα, μπορείτε να αποθηκεύσετε το όνομα ενός πελάτη σε μια μεταβλητή που ονομάζεται UserName. Στη συνέχεια, το copilot μπορεί να διαχειρίζεται τους πελάτες κατά όνομα καθώς συνεχίζεται η συνομιλία.

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

Ένας τρόπος για να χρησιμοποιήσετε ξανά μια μεταβλητή είναι να μεταβιβάσετε τη μεταβλητή μεταξύ των θεμάτων. Ο άλλος τρόπος είναι να κάνετε τη μεταβλητή καθολικού πεδίου και αυτό καλύπτει αυτό το άρθρο. Οι καθολικές μεταβλητές ονομάζονται έτσι, επειδή είναι διαθέσιμες σε όλα τα θέματα σε ολόκληρο το copilot.

Οι μεταβλητές Copilot εφαρμόζονται κατά τη διάρκεια μιας περιόδου λειτουργίας ενός χρήστη. Καθορίζετε ποιες μεταβλητές θα πρέπει να αντιμετωπιστούν ως μεταβλητές copilot για να διακριθούν από τις μεταβλητές επιπέδου θέματος.

Δημιουργία καθολικής μεταβλητής

Δημιουργείτε μια καθολική μεταβλητή αλλάζοντας το πεδίο μιας μεταβλητής θέματος.

  1. Δημιουργήστε μια μεταβλητή ή χρησιμοποιήστε το τμήμα παραθύρου Μεταβλητές για να ανοίξετε μια υπάρχουσα μεταβλητή.

  2. Στο τμήμα παραθύρου Ιδιότητες μεταβλητής, επιλέξτε Καθολική (οποιοδήποτε θέμα μπορεί να προσπελαστεί).

    Στο όνομα της μεταβλητής δίνεται το πρόθεμα Global., ώστε να γίνει διαφοροποίηση από τις μεταβλητές επιπέδου θέματος. Για παράδειγμα, η μεταβλητή UserName εμφανίζεται τώρα ως Global.UserName.

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

  3. Αποθηκεύστε το θέμα.

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

Χρήση καθολικών μεταβλητών

Όταν γράφετε ένα μήνυμα copilot σε έναν κόμβο μηνύματος ή έναν κόμβο ερώτησης, επιλέξτε το εικονίδιο {x} για να προβάλετε τις μεταβλητές που είναι διαθέσιμες στο θέμα. Οι καθολικές μεταβλητές εμφανίζονται στην καρτέλα Προσαρμογή μαζί με τυχόν μεταβλητές θέματος. Οι μεταβλητές παρατίθενται με αλφαβητική σειρά.

Στιγμιότυπο οθόνης που δείχνει την επιλογή μιας καθολικής μεταβλητής.

Εύρεση όλων των θεμάτων με τη χρήση καθολικής μεταβλητής

Μπορείτε να βρείτε πού ορίζεται μια καθολική μεταβλητή και ποια άλλα θέματα τη χρησιμοποιούν. Αυτό μπορεί να είναι χρήσιμο εάν εργάζεστε σε ένα νέο copilot ή αν έχετε πολλές μεταβλητές και πολύπλοκη διακλάδωση θεμάτων.

  1. Επιλέξτε μια καθολική μεταβλητή στον καμβά σύνταξης ή ανοίξτε το τμήμα παραθύρου Μεταβλητές και επιλέξτε μια καθολική μεταβλητή.

  2. Στο τμήμα παραθύρου Ιδιότητες μεταβλητής, στην ενότητα Αναφορά, επιλέξτε οποιοδήποτε από τα θέματα όπου χρησιμοποιείται η μεταβλητή για να μεταβείτε απευθείας σε αυτό το θέμα και στον κόμβο.

    Στιγμιότυπο οθόνης που εμφανίζει τη λίστα των θεμάτων που χρησιμοποιούνται από μια μεταβλητή στο τμήμα παραθύρου ιδιοτήτων μεταβλητής.

Κύκλος ζωής καθολικών μεταβλητών

Από προεπιλογή, η τιμή μιας καθολικής μεταβλητής διατηρείται μέχρι να λήξει η περίοδος λειτουργίας. Ο κόμβος Εκκαθάριση τιμών μεταβλητών επαναρυθμίζει τις τιμές των καθολικών μεταβλητών και χρησιμοποιείται στο θέμα συστήματος Επαναφορά συνομιλίας. Αυτό το θέμα μπορεί να ενεργοποιηθεί μέσω ανακατεύθυνσης ή όταν ο χρήστης πληκτρολογήσει μια φράση ενεργοποίησης, όπως "Έναρξη από την αρχή". Σε αυτή την περίπτωση, ρυθμίζεται η επαναφορά όλων των καθολικών μεταβλητών.

Ορισμός της τιμής μιας καθολικής μεταβλητής από εξωτερικές πηγές

Εάν θέλετε να βεβαιωθείτε ότι το copilot ξεκινά μια συνομιλία με κάποιο περιβάλλον, μπορείτε να προετοιμάσετε μια καθολική μεταβλητή με μια εξωτερική προέλευση. Ας πούμε ότι η τοποθεσία σας απαιτεί από τους χρήστες να συνδεθούν. Εφόσον το copilot σας γνωρίζει ήδη το όνομα ενός χρήστη, μπορεί να καλωσορίσει τους πελάτες κατά όνομα πριν αρχίσουν να πληκτρολογούν την πρώτη τους ερώτηση.

  1. Επιλέξτε μια καθολική μεταβλητή.

  2. Στο τμήμα παραθύρου Ιδιότητες μεταβλητής , επιλέξτε Οι εξωτερικές προελεύσεις μπορούν να ορίσουν τιμές.

Καθορισμός καθολικών μεταβλητών σε ενσωματωμένο copilot

Εάν ενσωματώσετε το copilot σας σε μια απλή ιστοσελίδα, μπορείτε να προσαρτήσετε μεταβλητές και τους ορισμούς τους στη διεύθυνση URL του copilot. Εναλλακτικά, αν θέλετε λίγο περισσότερο έλεγχο, μπορείτε να χρησιμοποιήσετε ένα μπλοκ κώδικα <script> για να καλέσετε και να χρησιμοποιήσετε μεταβλητές μέσω προγραμματισμού.

Το όνομα της μεταβλητής στη συμβολοσειρά ερωτήματος της διεύθυνσης URL πρέπει να είναι ίδιο με το όνομα της καθολικής μεταβλητής, χωρίς το πρόθεμα Global.. Για παράδειγμα, μια καθολική μεταβλητή Global.UserName θα αναφέρεται ως UserName στο ερώτημα.

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

Προσαρτήστε τις μεταβλητές και τους ορισμούς τους στη διεύθυνση URL του copilot ως παραμέτρους συμβολοσειράς ερωτήματος με τη μορφή του botURL?variableName1=variableDefinition1&variableName2=variableDefinition2,

Για παράδειγμα:

Το όνομα της παραμέτρου έχει διάκριση πεζών-κεφαλαίων. Το username=Renata θα λειτουργήσει επίσης σε αυτό το παράδειγμα.

Προσθέσετε καθολικές μεταβλητές σε έναν προσαρμοσμένο καμβά

Μπορείτε επίσης να προσθέσετε τη μεταβλητή σε έναν προσαρμοσμένο καμβά.

  1. Στην ενότητα <script> στη σελίδα όπου έχετε το copilot, καθορίστε τις μεταβλητές ως εξής, αντικαθιστώντας το variableName1 για το όνομα της μεταβλητής χωρίς πρόθεμα Global. και το variableDefinition1 για τον ορισμό. Χωρίστε πολλές μεταβλητές με κόμματα (,).

       const store = WebChat.createStore({}, ({ dispatch }) => next => action => {
     if (action.type === 'DIRECT_LINE/CONNECT_FULFILLED') {
       dispatch({
          type: "WEB_CHAT/SEND_EVENT",
          payload: {
            name: "pvaSetContext",
            value: {
               "variableName1": "variableDefinition1",
               "variableName2": "variableDefinition2"
            }
          },
        });
      }
        return next(action);
    });

  2. Στην ενότητα <script>, καλέστε το store όταν ενσωματώσετε το copilot σας όπως στο παρακάτω παράδειγμα, όπου το store καλείται ακριβώς πάνω από το σημείο που καλείται το styleOptions (θα πρέπει να αντικαταστήσετε το BOT_ID με το δικό σας αναγνωριστικό copilot):

    const BOT_ID = "12345-5678";
const theURL = "https://powerva.microsoft.com/api/botmanagement/v1/directline/directlinetoken?botId=" + BOT_ID;

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

Σχετικό περιεχόμενο