Ρύθμιση παραμέτρων μεταβλητών περιβάλλοντος για bot

Άρθρο
07/03/2024

Σημαντικό

Οι δυνατότητες του Power Virtual Agents αποτελούν τώρα μέρος του Microsoft Copilot Studio μετά από σημαντικές επενδύσεις σε παραγωγική τεχνητή νοημοσύνη και βελτιωμένες ενσωματώσεις στο Microsoft Copilot.

Ορισμένα άρθρα και στιγμιότυπα οθόνης ενδέχεται να αναφέρονται στο Power Virtual Agents ενώ ενημερώνουμε την τεκμηρίωση και το εκπαιδευτικό περιεχόμενο.

Σημείωμα

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

Κέντρο επικοινωνίας του Dynamics 365 - ενσωματωμένο	Κέντρο επικοινωνίας του Dynamics 365 - μεμονωμένο	Dynamics 365 Customer Service
όχι	Όχι	Όχι

Αυτό το άρθρο απαριθμεί τις μεταβλητές περιβάλλοντος για τα bot Azure και Copilot Studio και πώς μπορείτε να τις ρυθμίσετε στο Πανκαναλικό για Customer Service. Για να κατανοήσετε τον τρόπο δημιουργίας μεταβλητών περιβάλλοντος, ανατρέξτε στο θέμα Διαχείριση μεταβλητών περιβάλλοντος.

Μεταβλητές περιβάλλοντος για bot Azure

Ο ακόλουθος πίνακας περιέχει τη λίστα μεταβλητών περιβάλλοντος στο Πανκαναλικό για Customer Service που μπορείτε να χρησιμοποιήσετε για τη ρύθμιση παραμέτρων των bot του Azure.

Τύπος μεταβλητής περιβάλλοντος	Όνομα μεταβλητής περιβάλλοντος	Description	Τρόπος αντιστοίχισης στο Azure
Έρευνα πριν από τη συνομιλία	Χρησιμοποιήστε το όνομα ερώτησης έρευνας πριν από τη συνομιλία που δημιουργείτε στο Πανκαναλικό για Customer Service.	Το σύστημα αποθηκεύει τις αποκρίσεις από την έρευνα πριν τη συνομιλία ως μεταβλητές περιβάλλοντος.	Χρησιμοποιήστε τις παρακάτω πληροφορίες για να αντιστοιχίσετε το όνομα ερώτησης στο Πανκαναλικό για Customer Service με τον τύπο μεταβλητής στο Azure: Μία γραμμή: Συμβολοσειρά Πολλές γραμμές: Συμβολοσειρά Σύνολο επιλογών: Συμβολοσειρά Συγκατάθεση χρήστη: Δυαδική τιμή
Προσαρμοσμένο περιβάλλον	Χρησιμοποιήστε το όνομα της μεταβλητής που δημιουργείτε στο Πανκαναλικό για Customer Service διαβιβάστε χρησιμοποιώντας το setContextProvider API.	Πρόκειται για προσαρμοσμένες μεταβλητές περιβάλλοντος που μπορούν να δημιουργηθούν και να περάσουν μέσω του SDK ζωντανής συνομιλίας.	Αντιστοιχστε την απόκριση του χρήστη ως JSON για να χρησιμοποιήσετε μια προσαρμοσμένη μεταβλητή περιβάλλοντος στο Πανκαναλικό για Customer Service.
Συζήτηση	msdyn_ConversationId	Χρησιμοποιήστε τη μεταβλητή περιβάλλοντος που περιέχει το αναγνωριστικό συνομιλίας για τη συνεχιζόμενη συνομιλία και για λειτουργίες δυνατότητας λήψη και εκτέλεσης στην εγγραφή στο Microsoft Dataverse.	Συμβολοσειρά: Συμβολοσειρά
Επαφή	msdyn_contact_msdyn_ocliveworkitem_Customer	Χρησιμοποιήστε αυτήν τη μεταβλητή περιβάλλοντος που περιέχει το αναγνωριστικό καρτέλας για την καρτέλα πελάτη (επαφής) που συνδέεται με τη συνομιλία.	Ανάλυση JSON για εξαγωγή αναγνωριστικού καρτέλας
Λογαριασμ.	msdyn_account_msdyn_ocliveworkitem_Customer	Χρησιμοποιήστε αυτήν τη μεταβλητή περιβάλλοντος που περιέχει το αναγνωριστικό καρτέλας για την καρτέλα λογαριασμού που συνδέεται με τη συνομιλία.	Ανάλυση JSON για εξαγωγή αναγνωριστικού καρτέλας
Υπόθεση	msdyn_incident_msdyn_ocliveworkitem	Χρησιμοποιήστε αυτήν τη μεταβλητή περιβάλλοντος που περιέχει το αναγνωριστικό καρτέλας για την καρτέλα υπόθεσης που συνδέεται με τη συνομιλία.	Ανάλυση JSON για εξαγωγή αναγνωριστικού καρτέλας

Σημείωμα

Χρησιμοποιήστε τα ονόματα μεταβλητής περιβάλλοντος όπως ορίζονται και μην τα αλλάζετε όταν ο συντάκτης σας τρέχει με bot του Azure ή του Copilot Studio. Επίσης, χρησιμοποιήστε την ακριβή αντιστοίχιση για να μεταβιβάσετε την τιμή στη μεταβλητή περιβάλλοντος, επειδή κάνει διάκριση πεζών-κεφαλαίων. Εάν υπάρχει αναντιστοιχία, η καρτέλα δεν θα αναγνωριστεί αυτόματα. Περισσότερες πληροφορίες: Αυτόματη αναγνώριση καρτελών

Μεταβλητές περιβάλλοντος για bot Copilot Studio

Ο παρακάτω πίνακας περιέχει τη λίστα των μεταβλητών περιβάλλοντος που είναι διαθέσιμες στο Omnichannel για την εξυπηρέτηση πελατών, τις οποίες μπορείτε να χρησιμοποιήσετε για τη διαμόρφωση Copilot Studio bot.

Σημαντικό

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

Τύπος μεταβλητής περιβάλλοντος	Όνομα μεταβλητής περιβάλλοντος	Description	Τρόπος αντιστοίχισης στο Copilot Studio
Έρευνα πριν από τη συνομιλία	Χρησιμοποιήστε το όνομα ερώτησης έρευνας πριν από τη συνομιλία που δημιουργείτε στο Πανκαναλικό για Customer Service.	Το σύστημα αποθηκεύει τις αποκρίσεις από την έρευνα πριν τη συνομιλία ως μεταβλητές περιβάλλοντος.	Χρησιμοποιήστε τις παρακάτω πληροφορίες για να αντιστοιχίσετε το όνομα της ερώτησης στο Πανκαναλικό για Customer Service με τον τύπο μεταβλητής στο Copilot Studio: Μία γραμμή: Ολόκληρη η απόκριση του χρήστη Πολλές γραμμές: Ολόκληρη η απόκριση του χρήστη Σύνολο επιλογών: Ολόκληρη η απόκριση του χρήστη Συγκατάθεση χρήστη: Δυαδική τιμή
Προσαρμοσμένο περιβάλλον	Χρησιμοποιήστε το όνομα της μεταβλητής που δημιουργείτε στο Πανκαναλικό για Customer Service διαβιβάστε χρησιμοποιώντας το setContextProvider API.	Πρόκειται για προσαρμοσμένες μεταβλητές περιβάλλοντος που μπορούν να δημιουργηθούν και να περάσουν μέσω του SDK ζωντανής συνομιλίας.	Χρησιμοποιήστε τις παρακάτω πληροφορίες για να αντιστοιχίσετε τη μεταβλητή προσαρμοσμένου περιβάλλοντος στο Πανκαναλικό για Customer Service με τον τύπο μεταβλητής στο Copilot Studio: Συμβολοσειρά: Ολόκληρη η απόκριση του χρήστη Δυαδική τιμή: Δυαδική τιμή Αριθμός, Αριθμός κινητής υποδιαστολής: Αριθμός
Συζήτηση	msdyn_ConversationId	Χρησιμοποιήστε τη μεταβλητή περιβάλλοντος που περιέχει το αναγνωριστικό συνομιλίας για τη συνεχιζόμενη συνομιλία και για λειτουργίες δυνατότητας λήψη και εκτέλεσης στην εγγραφή στο 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	Χρησιμοποιήστε αυτό το παράθυρο διαλόγου για να μεταφέρετε τον χρήστη που αυτή τη στιγμή μιλάει στο bot σε ένα άλλο bot που μπορεί να μιλήσει σε διαφορετική γλώσσα.	Ορίστε τον κώδικα επιλέγοντας τη μεταβλητή εισόδου και χρησιμοποιώντας τον σωστό κωδικό τοπικών ρυθμίσεων.

Ρύθμιση παραμέτρων μεταβλητών περιβάλλοντος για bot Copilot Studio

Για να διαβάσει το Copilot Studio bot τις μεταβλητές περιβάλλοντος από το Πανκαναλικό, ακολουθήστε τα παρακάτω βήματα:

Στη σελίδα Θέματα επιλέξτε Προσθήκη θέματος και από το κενό.
Πληκτρολογήστε ένα όνομα για το θέμα σας (για παράδειγμα, "Ορισμός μεταβλητών περιβάλλοντος") και αποθηκεύστε το.
Προσθέστε έναν νέο κόμβο στο θέμα και επιλέξτε Διαχείριση μεταβλητής > Ορίστε μια μεταβλητή τιμή
Στον νέο κόμβο, κάτω από τον Ορισμό μεταβλητής, επιλέξτε Δημιουργία νέας μεταβλητής.
Ανοίξτε το τμήμα παραθύρου Ιδιότητες μεταβλητής κάνοντας κλικ στο νέο όνομα μεταβλητής. Στο τμήμα παραθύρου ορίστε το Όνομα μεταβλητής ώστε να ταιριάζει ακριβώς με το όνομα της μεταβλητής περιβάλλοντος Πανκαναλικού (κάνει διάκριση πεζών-κεφαλαίων).
Στην ενότητα Αναφορά, επιλέξτε τα αποσιωπητικά (...) και επιλέξτε Λήψη τιμής από αυτόν τον κόμβο σε περίπτωση που είναι κενό. Το Copilot Studio bot ανακτά τη μεταβλητή τιμή από αυτόν τον κόμβο κατά τον χρόνο εκτέλεσης.
Στην ενότητα Χρήση, επιλέξτε Καθολική (οποιοδήποτε θέμα μπορεί να έχει πρόσβαση) και Εξωτερικές πηγές μπορούν να ορίσουν τιμές. Το Copilot Studio αποδέχεται δεδομένα από το Πανκαναλικό. Κλείστε το τμήμα παραθύρου Ιδιότητες μεταβλητής.
Στον κόμβο σας, εισαγάγετε μια τιμή στο πεδίο Προς τιμή που ταιριάζει με τον τύπο δεδομένων που αναμένει το bot σας. Για παράδειγμα, εάν το bot αναμένει τη συμβολοσειρά, ορίστε την τιμή "Κείμενο"(""). Το Copilot Studio επιστρέφει στην τιμή που ορίζετε εδώ, εάν τα δεδομένα δεν φθάσουν στη συνομιλία.
Αποθηκεύστε και δημοσιεύστε τις αλλαγές.

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

Το bot μπορεί επίσης να ορίσει μεταβλητές περιβάλλοντος Πανκαναλικού κατά τη διάρκεια μιας συνομιλίας. Για να ορίσετε μια μεταβλητή Πανκαναλικού από τη λογική Copilot Studio, βεβαιωθείτε ότι το bot σας χρησιμοποιεί το σωστό όνομα μεταβλητής και ορίστε την τιμή στην ιδιότητα "Προς τιμή" στον κόμβο διαχείρισης μεταβλητής. Το 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 bot
Ενσωμάτωση ενός bot Azure
Ρύθμιση παραμέτρων bot για κλιμάκωση και τερματισμό συνομιλιών
Αναφορά SDK ζωντανής συνομιλίας

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