Εργασία με μεταβλητές

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

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

Οι μεταβλητές μπορούν επίσης να μεταβιβαστούν και να επιστραφούν από άλλα θέματα και ροές του Power Automate.

Εφαρμογή ιστού

Οι μεταβλητές μπορούν να υπάρχουν σε τέσσερα επίπεδα ή πεδία:

• θέμα Οι μεταβλητές μπορούν να χρησιμοποιηθούν μόνο στα θέματα στα οποία δημιουργούνται. Αυτό το πεδίο είναι το προεπιλεγμένο πεδίο για τις μεταβλητές που δημιουργείτε.
• Οι καθολικές μεταβλητές μπορούν να χρησιμοποιηθούν σε όλα τα θέματα. Μπορείτε να αλλάξετε το πεδίο μιας μεταβλητής θέματος ώστε να την κάνετε μια καθολική μεταβλητή.
• Οι μεταβλητές συστήματος δημιουργούνται αυτόματα με τον συγκυβερνήτη σας. Παρέχουν πληροφορίες βάσει περιβάλλοντος σχετικά με τη συνομιλία ή τον χρήστη. Είναι διαθέσιμες σε όλα τα θέματα.
• Οι μεταβλητές περιβάλλοντος δημιουργούνται και Power Platform είναι μόνο Copilot Studio για ανάγνωση. Αποθηκεύουν τα κλειδιά και τις τιμές των παραμέτρων, τα οποία στη συνέχεια χρησιμεύουν ως δεδομένα εισόδου σε διάφορα άλλα αντικείμενα εφαρμογής, όπως το Copilot Studio. Ο διαχωρισμός των παραμέτρων από τα αντικείμενα που καταναλώνουν σάς επιτρέπει να αλλάζετε τις τιμές στο ίδιο περιβάλλον ή όταν κάνετε μετεγκατάσταση λύσεων σε άλλα περιβάλλοντα. Η εναλλακτική λύση είναι να αφήσετε τις τιμές των παραμέτρων που καθορίζονται από τον προγραμματισμό στα στοιχεία που τις χρησιμοποιούν.

Τύποι μεταβλητών

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

Type	Description
Συμβλοσειρά	Μια ακολουθία χαρακτήρων που χρησιμοποιείται για την αναπαράσταση κειμένου
Boolean	Μια λογική τιμή που μπορεί να είναι μόνο true ή false
Αριθμός	Κάθε πραγματικός αριθμός
Table	Μια λίστα τιμών, αλλά όλες οι τιμές πρέπει να είναι του ίδιου τύπου
Εγγραφή	Μια συλλογή ζευγών ονόματος-τιμής, όπου οι τιμές μπορεί να είναι οποιοσδήποτε τύπος
Ημερομηνία/ώρα	Μια ημερομηνία, ώρα, ημέρα της εβδομάδας ή μήνας που σχετίζεται με ένα χρονικό σημείο
Επιλογή	Μια λίστα τιμών συμβολοσειράς με συσχετισμένα συνώνυμα
Κενό	Ένας χαρακτήρας κράτησης θέσης για "καμία τιμή" ή "άγνωστη τιμή", για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Κενά στο Power Fx

Ο τύπος μιας μεταβλητής ορίζεται κατά την πρώτη αντιστοίχιση μιας τιμής. Μετά από αυτό, ο τύπος αυτής της μεταβλητής είναι σταθερός και δεν είναι δυνατό να αντιστοιχιστεί σε τιμές οποιουδήποτε άλλου τύπου. Για παράδειγμα, μια μεταβλητή που έχει τιμή έναρξης 1έχει τύπο Αριθμός. Η προσπάθεια αντιστοίχισης σε μια τιμή συμβολοσειράς του "apples" οδηγεί σε σφάλμα.

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

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

Όταν δημιουργείτε κλάδους με κόμβους συνθήκης , οι διακλαδώσεις διατάσσονται από αριστερά προς τα δεξιά. Οι κόμβοι στον αριστερό κλάδο εξετάζονται πριν από τους κόμβους στον δεξιό κλάδο.

Οντότητες

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

Entity	Τύπος βάσης μεταβλητής
Επιλογές πολλαπλής επιλογής	Επιλογή
Ολόκληρη η απόκριση του χρήστη	Συμβλοσειρά
Ηλικία	Αριθμός
Boolean	Boolean
City	Συμβολοσειρά
Χρώμα	Συμβλοσειρά
Ήπειρος	Συμβλοσειρά
Χώρα ή περιοχή	Συμβλοσειρά
Ημερομηνία και ώρα	Ημερομηνία/ώρα
Διεύθυνση ηλεκτρονικού ταχυδρομείου	Συμβλοσειρά
Συμβάν	Συμβλοσειρά
Integer	Integer
Γλώσσα	Συμβλοσειρά
Money	Αριθμός
Αριθμός	Αριθμός
Τακτικός	Αριθμός
Εταιρεία	Συμβλοσειρά
Ποσοστό	Αριθμός
Όνομα ατόμου	Συμβλοσειρά
Αριθμός τηλεφώνου	Συμβολοσειρά
Σημείο ενδιαφέροντος	Συμβολοσειρά
Ταχύτητα	Αριθμός
Πολιτεία	Συμβολοσειρά
Διεύθυνση	Συμβολοσειρά
Θερμοκρασία	Αριθμός
URL	Συμβλοσειρά
Βάρος	Αριθμός
Ταχυδρομικός κώδικας	Συμβλοσειρά
Προσαρμοσμένη οντότητα	Επιλογή

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

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

Φιλοδώρημα

Μετονομάστε τους κόμβους ώστε να είναι πιο εύκολος ο προσδιορισμός τους. Επιλέξτε το πεδίο ονόματος του κόμβου για να ενημερώσετε απευθείας το όνομα ή επιλέξτε το εικονίδιο Περισσότερα (...) του κόμβου και επιλέξτε Μετονομασία από το μενού. Μπορείτε επίσης να μετονομάσετε κόμβους στο πρόγραμμα επεξεργασίας κώδικα.

Δεν είναι δυνατή η μετονομασία κόμβων ενεργοποίησης και η μετάβαση σε βήμα κόμβους.

Τα ονόματα κόμβων μπορούν να έχουν μήκος έως 500 χαρακτήρες.

Πρέπει να επιλέξετε μια οντότητα

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

Μετονομασία μεταβλητής

Στις μεταβλητές ανατίθεται αυτόματα ένα όνομα όταν τις δημιουργείτε. Η βέλτιστη πρακτική είναι να δώσετε στις μεταβλητές σας ονόματα με νόημα, ώστε να κάνουν σαφές το σκοπό τους σε οποιονδήποτε άλλο πρέπει να συντηρεί το copilot σας.

1. Επιλέξτε τη μεταβλητή για να την ανοίξετε στο τμήμα παραθύρου ιδιοτήτων μεταβλητών.

2. Στο όνομα μεταβλητής, πληκτρολογήστε ένα νέο όνομα για τη μεταβλητή σας.

Ορισμός μεταβλητής

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

1. Επιλέξτε Προσθήκη κόμβου (+) για να προσθέσετε έναν κόμβο και, στη συνέχεια, επιλέξτε Διαχείριση μεταβλητής>Ορίστε μια μεταβλητή τιμή.

2. Επιλέξτε το πλαίσιο στο Ορισμός μεταβλητής, και έπειτα επιλέξτε Δημιουργία νέας μεταβλητής.

   

   Δημιουργείται μια νέα μεταβλητή. Ο τύπος της είναι άγνωστη έως ότου της αναθέσετε μια τιμή.

   

3. Για το στοιχείο Σε τιμή, αναθέστε μια τιμή χρησιμοποιώντας μία από τις ακόλουθες επιλογές:

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

Σημείωμα

Κατά τη ρύθμιση μιας μεταβλητής τύπου συμβολοσειράς, εάν αντιμετωπίσετε ασυμφωνία μεταξύ της τιμής Ορισμός μεταβλητής και της τιμής Προς, εμφανίζεται ένα μήνυμα σφάλματος και το κουμπί Ασυμφωνία τύπων διόρθωσης. Επιλέξτε το κουμπί ώστε να δημιουργείται Copilot Studio αυτόματα ένας Power Fx τύπος που επιλύει την ασυμφωνία.

Χρήση τιμών λεκτικής σταθεράς

Αντί να επιλέξετε μια τιμή μεταβλητής, μπορείτε να πληκτρολογήσετε μια τιμή λεκτικής σταθεράς σε οποιαδήποτε μεταβλητή.

Ο κόμβος επιχειρεί να ερμηνεύσει τιμές συμβολοσειράς, αριθμού ή δυαδικής τιμής. Για παράδειγμα, το 123 ερμηνεύεται ως αριθμός. Εάν αντίθετα θέλετε να ερμηνεύεται ως τιμή συμβολοσειράς, μπορείτε να συσκευάσετε την τιμή σε διπλά εισαγωγικά, όπως έτσι: "123".

Για ορισμένα σενάρια ή όπου χρησιμοποιείτε πιο σύνθετους τύπους, χρησιμοποιήστε έναν τύπο Power Fx για να ορίσετε έναν συγκεκριμένο τύπο.

Τμήμα παραθύρου μεταβλητών

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

Για να ανοίξετε το τμήμα παραθύρου μεταβλητών, στη γραμμή του μενού θέματος, επιλέξτε Μεταβλητές.

Τμήμα παραθύρου ιδιοτήτων μεταβλητών

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

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

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

Οι μεταβλητές περιβάλλοντος είναι μια Power Platform έννοια. Οι μεταβλητές περιβάλλοντος ενεργοποιούν το βασικό σενάριο διαχείρισης κύκλου ζωής εφαρμογών (ALM) για τη μετακίνηση μιας εφαρμογής μεταξύ περιβαλλόντων του Power Platform. Σε αυτό το σενάριο, η εφαρμογή παραμένει ακριβώς η ίδια εκτός από μερικές βασικές εξωτερικές αναφορές που διαφέρουν μεταξύ του περιβάλλοντος προέλευσης και του περιβάλλοντος προορισμού.

Χρησιμοποιήστε τις μεταβλητές περιβάλλοντος με τον ίδιο τρόπο όπως τις μεταβλητές Θέμα, Καθολικό και Σύστημα. Μια σημαντική διαφορά είναι ότι μπορείτε να χρησιμοποιήσετε μόνο μεταβλητές περιβάλλοντος σε λειτουργία μόνο για ανάγνωση. Οι συντάκτες του Copilot δεν μπορούν να τροποποιήσουν τη μεταβλητή περιβάλλοντος στο Copilot Studio. Ωστόσο, οι διαχειριστές μπορούν να αλλάξουν την τιμή των μεταβλητών περιβάλλοντος στην πύλη PowerApps.

Οι τύποι μεταβλητών περιβάλλοντος στον χάρτη του Copilot Studio στους τύπους δεδομένων του PowerApps έχουν ως εξής:

Τύπος στο Copilot Studio	Τύπος στο PowerApps
Δεκαδικός αριθμός	Αριθμός
JSON	Εντοπίστε τον τύπο από την τιμή. Αν όχι Json => Μη καθορισμένο (σφάλμα επικύρωσης)
Μήνυμα κειμένου	string
Ναι/Όχι	Boolean
Data source	string
Μυστικό	Συμβλοσειρά

Σημείωμα

Τα σφάλματα μεταβλητής περιβάλλοντος είναι ορατά στη δοκιμαστική συνομιλία και κατά τη δημοσίευση. Ωστόσο, αυτά τα σφάλματα δεν εμφανίζονται στη λίστα Θέμα, επειδή δεν είναι μεταβλητές του θέματος.

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

Χρήση μεταβλητών περιβάλλοντος για μυστικούς κωδικούς Azure Key Vault

Μια μεταβλητή περιβάλλοντος μπορεί να έχει αναφορές σε ένα μυστικό κωδικό στο Key Vault. Πρόκειται για μια ειδική περίπτωση μεταβλητών περιβάλλοντος με μοναδικές εκτιμήσεις.

Για να δημιουργήσετε μια μυστική μεταβλητή περιβάλλοντος στην πύλη PowerApps, πρέπει να ρυθμίσετε τις παραμέτρους του Key Vault.

Εκτός από τις παραπάνω ρυθμίσεις παραμέτρων, πρέπει να εκτελέσετε τις παρακάτω ενέργειες για να εξουσιοδοτήσετε το Copilot Studio να διαβάσει αυτό το Key Vault:

1. Εκχωρήστε τον ρόλο Key Vault Secrets User στην εφαρμογή Microsoft Virtual Agents Service.

2. Για να εξουσιοδοτήσετε όλους τους copilot από το περιβάλλον να έχουν πρόσβαση στο μυστικό κωδικό, δημιουργήστε μια ετικέτα AllowedEnvironments στο μυστικό κωδικό και προσθέστε τα αναγνωριστικά επιτρεπόμενων περιβαλλόντων χωρισμένα με κόμμα.

3. Για να εξουσιοδοτήσετε μόνο συγκεκριμένους copilot από το περιβάλλον να χρησιμοποιούν αυτό το Key Vault, δημιουργήστε μια ετικέτα AllowedCopilots και βάλτε το αναγνωριστικό του copilot στη μορφή {envId}/{schemaName}. Για πολλαπλές τιμές, διαχωρίστε τις τιμές με κόμματα.

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

Η μυστική τιμή αποθηκεύεται στην προσωρινή μνήμη του χρόνο εκτέλεσης του παραθύρου διαλόγου για πέντε λεπτά. Οι αποτυχημένες αναγνώσεις αποθηκεύονται στην προσωρινή μνήμη για 30 δευτερόλεπτα.

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

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

Μεταβλητές συστήματος

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

Σημείωμα

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

Δεν εμφανίζονται όλες οι μεταβλητές συστήματος στη λίστα. Θα πρέπει να έχετε πρόσβαση σε αυτές τις κρυφές μεταβλητές συστήματος με τύπο Power Fx.

Για να χρησιμοποιήσετε μεταβλητές συστήματος σε έναν τύπο Power Fx, πρέπει να προσθέσετε το System. πριν από το όνομα της μεταβλητής. Για παράδειγμα, για να συμπεριλάβετε τη μεταβλητή συστήματος User.DisplayName σε έναν τύπο, δείτε την ως System.User.DisplayName.

Ονομασία	Type	Ορισμός
Activity.Attachments	πίνακας	Τα συνημμένα αρχείων που παρέχονται από το χρήστη
Activity.Channel	επιλογή	Το αναγνωριστικό καναλιού της τρέχουσας συνομιλίας
Activity.ChannelData	οποιαδήποτε	Ένα αντικείμενο που περιέχει περιεχόμενο που αφορά συγκεκριμένα κανάλια
Activity.ChannelId	string	Το αναγνωριστικό καναλιού της τρέχουσας συνομιλίας, όπως μια συμβολοσειρά
Activity.From.Id	string	Το μοναδικό αναγνωριστικό ειδικά για το κανάλι του αποστολέα
Activity.From.Name	string	Το φιλικό για το χρήστη όνομα αποστολέα για συγκεκριμένο κανάλι
Activity.Name	string	Το όνομα του συμβάντος
Activity.Recipient.Id	string	Η ιδιότητα Τύπος της εισερχόμενης δραστηριότητας.
Activity.Recipient.Name	string	Αντιπροσωπεύει το εμφανιζόμενο όνομα για το copilot μέσα στο κανάλι. Στο περιβάλλον του καναλιού τηλεφωνίας, η τιμή αυτής της μεταβλητής θα είναι ο αριθμός τηλεφώνου στον οποίο επισυνάπτεται copilot χρήστη.
Activity.Text	string	Το πιο πρόσφατο μήνυμα που στάλθηκε από τον χρήστη
Activity.Type	επιλογή	Τύπος δραστηριότητας
Activity.TypeId	string	Τύπος δραστηριότητας, όπως μια συμβολοσειρά
Activity.Value	οποιαδήποτε	Αόριστη τιμή
Bot.EnvironmentId	string	Το αναγνωριστικό περιβάλλοντος του copilot
Bot.Id	string	Το αναγνωριστικό του copilot
Bot.Name	string	Το όνομα του copilot
Bot.SchemaName	string	Το όνομα του σχήματος του copilot
Bot.TenantId	string	Το αναγνωριστικό μισθωτή του copilot
ClientPluginActions	επιλογή	Συλλογή των ενεργειών προσθήκης δυναμικού προγράμματος-πελάτη που θα πρέπει να εξετάσετε για παραγωγικές ενέργειες
Conversation.Id	string	Το μοναδικό αναγνωριστικό της τρέχουσας συνομιλίας
Conversation.InTestMode	boolean	Δυαδική τιμή που αντιπροσωπεύει αν η συνομιλία συμβαίνει σε δοκιμαστικό καμβά
Conversation.LocalTimeZone	string	Το όνομα της ζώνης ώρας που θα χρησιμοποιηθεί από το χρήστη σε μορφή βάσης δεδομένων ζώνης ώρας IANA
Conversation.LocalTimeZoneOffset	datetime	Η μετατόπιση ώρας από UTC για την τρέχουσα τοπική ζώνη ώρας
Error.Code	string	Ο κωδικός σφάλματος για το τρέχον σφάλμα. Σημείωση: Αυτή η μεταβλητή υποστηρίζεται μόνο εάν το έναυσμα είναι On Error.
Error.Message	string	Το μήνυμα σφάλματος για το τρέχον σφάλμα. Σημείωση: Αυτή η μεταβλητή υποστηρίζεται μόνο εάν το έναυσμα είναι On Error.
FallbackCount	Αριθμός	Αυτή η μεταβλητή μετρά τις φορές που ένα θέμα δεν μπόρεσε να αντιστοιχιστεί με την εισαγωγή του χρήστη. Σημείωση: Αυτή η μεταβλητή υποστηρίζεται μόνο εάν το έναυσμα είναι On Unknown Intent.
InactivityTimer.Continue	boolean	Δυαδική τιμή που αντιπροσωπεύει εάν ο χρονοδιακόπτης πρέπει να συνεχιστεί. Σημείωση: Αυτή η μεταβλητή υποστηρίζεται μόνο εάν το έναυσμα είναι Inactivity.
InactivityTimer.Count	Αριθμός	Αριθμός φορών που ενεργοποιήθηκε ο χρονοδιακόπτης OnInactivity λόγω αδράνειας του χρήστη μετά τον καθορισμένο χρόνο. Σημείωση: Αυτή η μεταβλητή υποστηρίζεται μόνο εάν το έναυσμα είναι Inactivity.
LastMessage.Id	string	Το αναγνωριστικό του προηγούμενου μηνύματος που στάλθηκε από τον χρήστη
LastMessage.Text	string	Το προηγούμενο μήνυμα που στάλθηκε από τον χρήστη
Recognizer.ExtractedEntities	επιλογή	Αντιπροσωπεύει τις οντότητες που έχουν εξαχθεί από το μήνυμα ενεργοποίησης. Σημείωση: Αυτή η μεταβλητή υποστηρίζεται μόνο εάν το έναυσμα είναι On Select Intent.
Recognizer.IntentOptions	επιλογή	Αντιπροσωπεύει τις επιλογές πρόθεσης όταν η αναγνώριση επιστρέφει πολύ σαφή αποτελέσματα. Σημείωση: Αυτή η μεταβλητή υποστηρίζεται μόνο εάν το έναυσμα είναι On Select Intent.
Recognizer.SelectedIntent	επιλογή	Αντιπροσωπεύει την πρόθεση που επιλέχθηκε από την αναγνώριση. Σημείωση: Αυτή η μεταβλητή υποστηρίζεται μόνο εάν το έναυσμα είναι On Select Intent.
Recognizer.TriggeringMessage.Id	string	Το αναγνωριστικό του μηνύματος χρήστη που ενεργοποίησε το τρέχον θέμα
Recognizer.TriggeringMessage.Text	string	Το μήνυμα χρήστη που ενεργοποίησε το τρέχον θέμα
Recognizer.MultipleTopicsMatchedReason	string	Χρησιμοποιείται για να προσδιοριστεί η αντιστοιχία πολλών θεμάτων που αντιστοιχήθηκαν. Σημείωση: Αυτή η μεταβλητή υποστηρίζεται μόνο εάν το έναυσμα είναι On Select Intent.
User.Language	επιλογή	Αυτή η μεταβλητή χρησιμοποιείται για τον καθορισμό των τοπικών ρυθμίσεων στη γλώσσα χρήστη ανά συνομιλία.
SignInReason	επιλογή	Χρησιμοποιείται για να προσδιορίσει την επιλογή είσοδου που απαιτείται κατά την ενεργοποίηση του θέματος. Σημείωση: Αυτή η μεταβλητή υποστηρίζεται μόνο εάν το έναυσμα είναι On Sign In.

Μεταβλητές για ενσωματωμένο έλεγχο ταυτότητας (προεπιλογή)

Οι παρακάτω μεταβλητές είναι διαθέσιμες όταν έχετε ρυθμίσει τις παραμέτρους του copilot σας για έλεγχο ταυτότητας με τη Microsoft. Αυτό θα χρησιμοποιήσει τον έλεγχο ταυτότητας Entra ID και θα επιτρέψει μόνο τα κανάλια Teams και PowerApps. Αυτή είναι η προεπιλογή για νέα copilot.

Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Μεταβλητές ελέγχου ταυτότητας.

Ονομασία	Type	Ορισμός
User.DisplayName	string	Το εμφανιζόμενο όνομα του χρήστη που μιλάει τη δεδομένη στιγμή στο copilot.
User.Email	string	Η διεύθυνση email του χρήστη που μιλάει τη δεδομένη στιγμή στο copilot.
User.FirstName	string	Το όνομα του χρήστη που μιλάει τη δεδομένη στιγμή στο copilot.
User.Id	string	Το μοναδικό αναγνωριστικό του χρήστη που μιλάει τη δεδομένη στιγμή στο copilot.
User.IsLoggedIn	boolean	Δυαδική τιμή που δηλώνει εάν ο χρήστης που μιλάει στο copilot έχει υποβληθεί σε έλεγχο ταυτότητας ή όχι.
User.LastName	string	Το επώνυμο του χρήστη που μιλάει τη δεδομένη στιγμή στο copilot.
User.PrincipalName	string	Το κύριο όνομα του χρήστη που μιλάει τη δεδομένη στιγμή στο copilot.

Μεταβλητές για μη αυτόματο έλεγχο ταυτότητας με Generic OAuth 2

Οι ακόλουθες μεταβλητές είναι διαθέσιμες όταν έχετε ρυθμίσει τις παραμέτρους του συγκυβερνήτη σας ώστε να χρησιμοποιεί τον πάροχο υπηρεσιών Generic OAuth 2.

Ονομασία	Type	Ορισμός
User.AccessToken	string	Το διακριτικό πρόσβασης για τον έλεγχο ταυτότητας του χρήστη με το copilot.
User.DisplayName	string	Το εμφανιζόμενο όνομα του χρήστη που μιλάει τη δεδομένη στιγμή στο copilot.
User.Id	string	Το μοναδικό αναγνωριστικό του χρήστη που μιλάει τη δεδομένη στιγμή στο copilot.
User.IsLoggedIn	boolean	Δυαδική τιμή που δηλώνει εάν ο χρήστης που μιλάει στο copilot έχει υποβληθεί σε έλεγχο ταυτότητας ή όχι.

Μεταβλητές για μη αυτόματο έλεγχο ταυτότητας με Microsoft Entra ID

Οι ακόλουθες μεταβλητές είναι διαθέσιμες όταν έχετε ρυθμίσει τον copilot σας να χρησιμοποιεί τους παρόχους υπηρεσιών Microsoft Entra ID (προηγουμένως Azure Active Directory).

Ονομασία	Type	Ορισμός
User.AccessToken	string	Το διακριτικό πρόσβασης για τον έλεγχο ταυτότητας του χρήστη με το copilot.
User.DisplayName	string	Το εμφανιζόμενο όνομα του χρήστη που μιλάει τη δεδομένη στιγμή στο copilot.
User.Email	string	Η διεύθυνση email του χρήστη που μιλάει τη δεδομένη στιγμή στο copilot.
User.FirstName	string	Το όνομα του χρήστη που μιλάει τη δεδομένη στιγμή στο copilot.
User.Id	string	Το μοναδικό αναγνωριστικό του χρήστη που μιλάει τη δεδομένη στιγμή στο copilot.
User.IsLoggedIn	boolean	Δυαδική τιμή που δηλώνει εάν ο χρήστης που μιλάει στο copilot έχει υποβληθεί σε έλεγχο ταυτότητας ή όχι.
User.LastName	string	Το επώνυμο του χρήστη που μιλάει τη δεδομένη στιγμή στο copilot.
User.PrincipalName	string	Το κύριο όνομα του χρήστη που μιλάει τη δεδομένη στιγμή στο copilot.

Μεταβλητές για copilot με δυνατότητα φωνητικής επικοινωνίας

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

Σημείωμα

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

Ονομασία	Type	Ορισμός
Activity.InputDTMFKeys	string	Η μη επεξεργασμένη τιμή κλειδιού DTMF που λήφθηκε από την τηλεφωνία.
Activity.SpeechRecognition.Confidence	Αριθμός	Η βαθμολογία εμπιστοσύνης για ολόκληρο το αποτέλεσμα της υπόθεσης ASR, από 0 έως 1.
Activity.SpeechRecognition.MinimallyFormattedText	string	Ελαφρώς μορφοποιημένο κείμενο του αποτελέσματος της υπόθεσης ASR. Για παράδειγμα, πεντακόσια δολάρια. Γράφεται με λέξεις, αλλά περιλαμβάνονται βασικές κεφαλαιοποιήσεις και σημεία στίξης.
Activity.UserInputType	επιλογή	Ο τύπος εισόδου από τα πιο πρόσφατα δεδομένα εισόδου του τελικού χρήστη. Η τιμή μπορεί να είναι δοκιμή, ομιλία ή DTMF.
Conversation.OnlyAllowDTMF	boolean	Δυαδική τιμή επιλογής που αντιπροσωπεύει εάν το IVR πρέπει να οριστεί σε λειτουργία μόνο DTMF κατά το περιβάλλον εκτέλεσης.
Conversation.SipUuiHeaderValue	string	Η συμβολοσειρά κεφαλίδας UUI που χρησιμοποιείται για τη διαβιβάση του περιβάλλοντος στο IVR κατά την έναρξη κλήσης.

Μεταβιβάστε μεταβλητές μεταξύ θεμάτων

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

Λήψη τιμών από άλλα θέματα

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

Σε αυτό το παράδειγμα, θα χρησιμοποιήσουμε δύο θέματα, το Χαιρετισμός και το Μιλήστε στον πελάτη. Και τα δύο θέματα ζητούν το όνομα του πελάτη. Ωστόσο, εάν εκτελείται πρώτα η θέμα Χαιρετισμός, το θέμα Μιλήστε στον πελάτη παραλείπει την ερώτησή του. Αντ' αυτού, χρησιμοποιεί την τιμή της μεταβλητής που μεταβιβάζεται από το θέμα Χαιρετισμός.

Ακολουθεί η ροή του θέματος Μιλήστε στον πελάτη:

Όπως φαίνεται στο τμήμα παραθύρου Δοκιμή copilot, εάν αυτό το θέμα ενεργοποιηθεί πρώτα, ρωτά το χρήστη, "Πώς να σας απευθύνομαι;" Αποθηκεύει την τιμή σε μια μεταβλητή συμβολοσειράς που καλείται userName. Η μεταβλητή userName έχει ρυθμιστεί επίσης να πάρει την τιμή της από άλλα θέματα. Το θέμα καταλήγει με το μήνυμα "Ελπίζουμε να περνάτε καλά, {userName}!"

Ακολουθεί η ροή του θέματος Χαιρετισμός:

Όπως φαίνεται στο τμήμα παραθύρου Δοκιμή copilot, εάν αυτό το θέμα ενεργοποιηθεί πρώτα, ρωτά το χρήστη, "Πώς ονομάζεστε;" Αποθηκεύει την τιμή σε μια μεταβλητή συμβολοσειράς που καλείται UserName. Το θέμα στέλνει το μήνυμα, Χάρηκα για τη γνωριμία, {UserName}!" Στη συνέχεια, γίνεται ανακατεύθυνση στο θέμα Μιλήστε με τον πελάτη, το οποίο στέλνει το μήνυμα "Ελπίζω να περνάτε καλά, {userName}!" Σημειώστε, ωστόσο, ότι το θέμα Μιλήστε στον πελάτη παραλείφθηκε ζητώντας ξανά το όνομα του χρήστη. Αντ' αυτού, χρησιμοποίησε την τιμή της μεταβλητής UserName που μεταβιβάζεται από το θέμα Χαιρετισμός.

Τέλος, θα δείτε ξανά τη δεύτερη συνομιλία, αυτήν τη φορά από την οπτική γωνία του θέματος Μιλήστε στον πελάτη:

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

Ρύθμιση του θέματος προορισμού

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

1. Δημιουργήστε ή μεταβείτε στο θέμα προορισμού.

2. Προσθέστε έναν κόμβο Ερώτηση και πληκτρολογήστε What should I call you? για το μήνυμα.

3. Στην περιοχή Προσδιορισμός, επιλέξτε την προκατασκευασμένη οντότητα Όνομα προσώπου.

4. Επιλέξτε τη μεταβλητή για να ανοίξετε το τμήμα παραθύρου Ιδιότητες μεταβλητών. Ονομάστε το userName και, στη συνέχεια, επιλέξτεΛήψη τιμών από άλλα θέματα.

   

5. Προσθέστε έναν κόμβο μηνύματος.

6. Στο πλαίσιο μηνύματος πληκτρολογήστε I hope you're having a wonderful day,.

7. Επιλέξτε το εικονίδιο Εισαγωγή μεταβλητής ({x}), και έπειτα επιλέξτε userName.

8. Επιλέξτε το διάστημα μετά από τη μεταβλητή και πληκτρολογήστε !.

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

Ρυθμίστε το θέμα προέλευσης

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

1. Μεταβείτε στο θέμα προέλευσης.

2. Προσθέστε έναν κόμβο ανακατεύθυνσης και επιλέξτε την θέμα προορισμού.

3. Επιλέξτε + Προσθήκη εισόδου, και έπειτα επιλέξτε τη μεταβλητή από το θέμα προορισμού στο οποίο θέλετε να μεταβιβάσετε μια τιμή.

   

4. Επιλέξτε το εικονίδιο > και, στη συνέχεια, επιλέξτε τη μεταβλητή της οποίας την τιμή θέλετε να διαβιβάσετε.

   

   Ο κόμβος Ανακατεύθυνση θα πρέπει να έχει την εξής εμφάνιση:

   

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

Επιστροφή τιμών στα αρχικά θέματα

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

Ας συνεχίσουμε με το παράδειγμα από την προηγούμενη ενότητα. Θα κάνουμε μια νέα ερώτηση στο θέμα Μιλήστε στον πελάτη και, στη συνέχεια, θα επιστρέψουμε την απάντηση στο θέμα Χαιρετισμός.

Ρύθμιση του θέματος προέλευσης για μια μεταβλητή που επιστρέφεται

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

1. Μεταβείτε στο θέμα προέλευσης.

2. Προσθέστε έναν κόμβο Ερώτηση και πληκτρολογήστε What city do you live in? για το μήνυμα.

3. Στην περιοχή Προσδιορισμός, επιλέξτε την προκατασκευασμένη οντότητα Πόλη.

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

   

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

Ρύθμιση του θέματος προορισμού για μια μεταβλητή που επιστρέφεται

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

1. Μεταβείτε στο θέμα προορισμού.

2. Η μεταβλητή που επιλέξατε στο θέμα προέλευσης πρέπει να εμφανίζεται στον κόμβο ανακατεύθυνσης ως μεταβλητή εξόδου.

   

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

Κλασικός

Τύπος οντότητας και μεταβλητής

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

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

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

Οντότητα	Τύπος βάσης μεταβλητής
Επιλογές πολλαπλής επιλογής	Συμβολοσειρά
Ολόκληρη η απόκριση του χρήστη	Συμβολοσειρά
Ηλικία	Αριθμός
Δυαδική τιμή	Δυαδική τιμή
Πόλη	Συμβολοσειρά
Χρώμα	Συμβολοσειρά
Ήπειρος	Συμβολοσειρά
Χώρα ή περιοχή	Συμβολοσειρά
Ημερομηνία και ώρα	Συμβολοσειρά
Διάρκεια	Συμβολοσειρά
Διεύθυνση ηλεκτρονικού ταχυδρομείου	Συμβολοσειρά
Συμβάν	Συμβολοσειρά
Γλώσσα	Συμβολοσειρά
Χρήματα	Συμβολοσειρά
Αριθμός	Συμβολοσειρά
Τακτικός	Συμβολοσειρά
Οργανισμός	Συμβολοσειρά
Ποσοστό	Αριθμός
Όνομα ατόμου	Συμβολοσειρά
Αριθμός τηλεφώνου	Συμβολοσειρά
Σημείο ενδιαφέροντος	Συμβολοσειρά
Ταχύτητα	Αριθμός
Πολιτεία	Συμβολοσειρά
Διεύθυνση	Συμβολοσειρά
Θερμοκρασία	Αριθμός
URL	Συμβολοσειρά
Βάρος	Αριθμός
Ταχυδρομικός κώδικας	Συμβολοσειρά
Προσαρμοσμένη οντότητα	Συμβολοσειρά

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

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

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

2. Επιλέξτε Προσθήκη κόμβου (+), και μετά επιλέξτε Κάντε μια ερώτηση.

   

   Δημιουργείται αυτόματα μια μεταβλητή που περιέχει την απόκριση του χρήστη.

   

Πρέπει να επιλέξετε μια οντότητα

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

Μετονομασία μεταβλητής

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

Χρήση μεταβλητών σε κόμβους ενεργειών

Όταν χρησιμοποιείτε μια μεταβλητή σε έναν κόμβο ενέργειας, εάν ο βασικός τύπος της ταιριάζει με έναν τύπο παραμέτρου που καθορίζεται για μια ροή ή δεξιότητα Bot Framework, μπορείτε να παρέχετε αυτήν την παράμετρο. Η έξοδος από κόμβους ενεργειών δημιουργεί νέες μεταβλητές.

Χρήση τιμών λεκτικής σταθεράς σε κόμβους ενεργειών

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

Κόμβος ανάλυσης τιμής

Ο κόμβος ανάλυσης τιμής σας επιτρέπει να μετατρέψετε μια τιμή ενός τύπου σε τιμή άλλου τύπου. Όταν προσθέτετε έναν κόμβο σε ένα θέμα, επιλέξτε Προσθήκη κόμβου (+), στη συνέχεια, Διαχείριση μεταβλητής και Ανάλυση τιμής.

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

Η διαδικασία ξεκινά όταν καλείται ένα Flow, το οποίο με τη σειρά του καλεί ένα API. Το API τότε επιστρέφει ένα αποτέλεσμα. Τυπικά, θα πρέπει να αναλύσετε αυτή την απόκριση και να επιστρέψετε μία ή περισσότερες πρωτόγονες μεταβλητές στο Copilot Studio. Με τον κόμβο ανάλυσης τιμής, μπορείτε να στείλετε ολόκληρο το αποτέλεσμα του API ως συμβολοσειρά:

{
    "Name": "Gary",
    "Position": "PM",
    "Company": "Microsoft",
    "FormerPositions": [{
            "Position": "Engineer"
        }
    ]
}

Η μεταβλητή συμβολοσειράς που έχετε τώρα μπορεί να μετατραπεί σε μεταβλητή καρτέλας, με υποστήριξη πλήρους πληροφόρησης σε Power Fx, χρησιμοποιώντας αυτόν τον νέο κόμβο. Ένα παράδειγμα χρήσης δειγμάτων δεδομένων θα βοηθήσει στην απεικόνιση αυτής της διεργασίας.

Παράδειγμα χρήσης του κόμβου ανάλυσης τιμής

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

   

2. Επιλέξτε τον τύπο δεδομένων. Σε αυτήν την περίπτωση, επιλέξτε "Από δείγμα δεδομένων".

   

3. Τώρα μπορείτε να παρέχετε JSON κάνοντας κλικ στην επιλογή "Λήψη σχήματος από δείγμα JSON". Αν κάνετε κλικ σε αυτό το στοιχείο, θα ανοίξει ένα πρόγραμμα επεξεργασίας, όπου μπορείτε να επικολλήσετε το παράδειγμα.

   

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

   

   Σημειώστε ότι η μεταβλητή εξόδου είναι πλέον του σωστού τύπου – Καρτέλα.

   

Τώρα μπορείτε να χρησιμοποιήσετε τη νέα μεταβλητή σας. Εδώ στο πρόγραμμα επεξεργασίας Power Fx, μπορείτε να δείτε ότι έχετε πλήρη πληροφορίες για τις διάφορες ιδιότητες.

Εκτός από την ανάλυση συμβολοσειρών JSON, μια βασική χρήση του κόμβου ανάλυσης τιμής θα είναι η ανάλυση UntypedObjects κατά τον χρόνο εκτέλεσης. Οι πιο κοινές από αυτές θα είναι όταν λάβετε ένα συμβάν και πρέπει να αναλύσετε την τιμή συμβάντος. Ή μπορεί να θέλετε να αναλύσετε την ιδιότητα System.Activity.ChannelData, η οποία μεταβάλλεται κατά το χρόνο εκτέλεσης ανά κανάλι.

Στο παρακάτω παράδειγμα, εάν το συμβάν προερχόταν από το Teams, θα έπρεπε να χρησιμοποιήσετε την τεκμηρίωση προγραμματιστή Teams για να βρείτε ένα παράδειγμα για την εμφάνιση του εισερχόμενου συμβάντος και, στη συνέχεια, να χρησιμοποιήσετε από δείγμα δεδομένων, όπως περιγράφεται σε αυτήν την ενότητα.

Ανάλυση μεταβλητές μεταξύ θεμάτων

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

Σημείωμα

Μεταβλητές τύπου Custom Entity, Date and Time, Duration και Multiple-choice δεν είναι δυνατό να μεταβιβαστούν μεταξύ των θεμάτων.

Λήψη τιμών από άλλα θέματα

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

Για να λάβετε τιμές από άλλα θέματα, ορίστε την ιδιότητα της μεταβλητής:

1. Στον κόμβο Ερώτηση, επιλέξτε τη μεταβλητή που θέλετε να λαμβάνετε τιμές από άλλα θέματα.

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

   

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

4. Μεταβείτε σε ένα θέμα στο οποίο θέλετε να ανακατευθύνετε. Ακολουθήστε τα βήματα στην Ανακατεύθυνση σε άλλο θέμα για να ανακατευθύνετε στο σωστό θέμα.

5. Επιλέξτε + Προσθήκη καταχώρισης για θέμα προορισμού.

   

6. Επιλέξτε μια μεταβλητή στο θέμα που έχει ανακατευθυνθεί στο οποίο θέλετε να μεταβιβάσετε τη μεταβλητή.

   

7. Στο στοιχείο Καταχώριση ή επιλογή μιας τιμής, επιλέξτε τη μεταβλητή στο τρέχον θέμα που θέλετε να διαβιβάσετε στο θέμα που έχει ανακατευθυνθεί.

   

   Η μεταβλητή εμφανίζεται στον κόμβο που έχει ανακατευθυνθεί.

   

Επιστροφή τιμών στα αρχικά θέματα

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

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

Για να επιστρέψετε μια μεταβλητή στο αρχικό θέμα, ορίστε την ιδιότητα της μεταβλητής:

1. Στον κόμβο Ερώτηση, επιλέξτε τη μεταβλητή που θέλετε να λαμβάνετε τιμές από άλλα θέματα.

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

   

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

4. Μεταβείτε σε ένα θέμα στο οποίο θέλετε να ανακατευθύνετε. Ακολουθήστε τα βήματα στην Ανακατεύθυνση σε άλλο θέμα για να ανακατευθύνετε στο σωστό θέμα.

   Η μεταβλητή που επιστρέφεται στο θέμα εμφανίζεται στο θέμα που έχει ανακατευθυνθεί. Χρησιμοποιήστε τη μεταβλητή που επιστρέφεται στο θέμα σας.

   

Χρήση του τμήματος παραθύρου «Μεταβλητές»

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

1. Στη γραμμή μενού θέματος, επιλέξτε Μεταβλητές.

   

2. Για καθεμία από τις μεταβλητές στο θέμα, επιλέξτε εάν θέλετε οι τιμές να μεταβιβάζονται, να λαμβάνονται ή και τα δύο μεταξύ των θεμάτων.

   

Χρήση τιμών λεκτικής σταθεράς σε εισόδους μεταβλητής

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

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

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