Επισκόπηση μεταβλητών

Σημείωμα

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

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

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

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

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

Τύπος Περιγραφή
String Μια ακολουθία χαρακτήρων που χρησιμοποιείται για την αναπαράσταση κειμένου
Boolean Μια λογική τιμή που μπορεί να είναι μόνο true ή false
Αριθμός Κάθε πραγματικός αριθμός
Πίνακας Μια λίστα τιμών, αλλά όλες οι τιμές πρέπει να είναι του ίδιου τύπου
Καταγραφή Μια συλλογή ζευγών ονόματος-τιμής, όπου οι τιμές μπορεί να είναι οποιοσδήποτε τύπος
DateTime Μια ημερομηνία, ώρα, ημέρα της εβδομάδας ή μήνας που σχετίζεται με ένα χρονικό σημείο
Επιλογή Μια λίστα τιμών συμβολοσειράς με συσχετισμένα συνώνυμα
Κενό Ένα δεσμευτικό θέσης για "καμία τιμή" ή "άγνωστη τιμή"; Μάθετε περισσότερα στο Blank στην τεκμηρίωση του Power Fx

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

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

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

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

Οντότητες

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

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

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

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

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

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

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

Πληκτρολογήστε στο Copilot Studio Πληκτρολογήστε στο Power Apps
Δεκαδικός αριθμός Αριθμός
JSON Εντοπίστε τον τύπο από την τιμή. Αν όχι JSON = Ακαθόριστο > (σφάλμα επικύρωσης)
Κείμενο String
Ναι/Όχι Boolean
Προέλευση δεδομένων String
Μυστικό String

Σημείωμα

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

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

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

Στιγμιότυπο οθόνης μεταβλητών συστήματος σε ένα θέμα.

Το Copilot Studio δεν εμφανίζει όλες τις μεταβλητές συστήματος. Για να αποκτήσετε πρόσβαση σε κρυφές μεταβλητές συστήματος, χρησιμοποιήστε έναν τύπο Power Fx.

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

Όνομα Τύπος Ορισμός
Δραστηριότητα.Συνημμένα πίνακας Τα συνημμένα αρχεία που παρέχει ο χρήστης.
Δραστηριότητα.Κανάλι επιλογή Το αναγνωριστικό καναλιού της τρέχουσας συνομιλίας.
Activity.ChannelData οποιαδήποτε Ένα αντικείμενο που περιέχει περιεχόμενο που αφορά συγκεκριμένα κανάλια.
Activity.ChannelId string Το αναγνωριστικό καναλιού της τρέχουσας συνομιλίας, όπως μια συμβολοσειρά.
Activity.From.Id string Το μοναδικό αναγνωριστικό ειδικά για το κανάλι του αποστολέα.
Δραστηριότητα.Προέλευση.Όνομα string Το φιλικό για το χρήστη όνομα αποστολέα για συγκεκριμένο κανάλι.
Activity.Name string Το όνομα του συμβάντος.
Activity.Recipient.Id string Η ιδιότητα Τύπος της εισερχόμενης δραστηριότητας.
Δραστηριότητα.Λήπτης.Όνομα string Αντιπροσωπεύει το εμφανιζόμενο όνομα για το παράγοντα μέσα στο κανάλι. Στο περιβάλλον του καναλιού τηλεφωνίας, η τιμή αυτής της μεταβλητής είναι ο αριθμός τηλεφώνου στον οποίο επισυνάπτεται ο παράγοντας.
Activity.Text string Το πιο πρόσφατο μήνυμα που στάλθηκε από τον χρήστη.
Activity.Type (Τύπος Δραστηριότητας) επιλογή Τύπος δραστηριότητας.
Activity.TypeId string Τύπος δραστηριότητας, όπως μια συμβολοσειρά.
Activity.Value οποιαδήποτε Αόριστη τιμή.
Bot.EnvironmentId string Το ID περιβάλλοντος του παράγοντα.
Bot.Id string Το αναγνωριστικό του πράκτορα.
Bot.Name string Το όνομα του αντιπροσώπου σας.
Bot.ΌνομαΣχήματος string Το όνομα του σχήματος του παράγοντα.
Bot.TenantId string Το αναγνωριστικό μισθωτή του πράκτορα.
ClientPluginActions επιλογή Συλλογή ενεργειών προσθηκών δυναμικού προγράμματος-πελάτη που πρέπει να λάβετε υπόψη για παραγωγική ενορχήστρωση.
Conversation.Id string Το μοναδικό αναγνωριστικό της τρέχουσας συνομιλίας.
Conversation.InTestMode Boolean Δυαδική τιμή που αντιπροσωπεύει αν η συνομιλία συμβαίνει σε δοκιμαστικό καμβά.
Conversation.LocalTimeZone string Το όνομα της ζώνης ώρας που θα χρησιμοποιηθεί από το χρήστη σε μορφή βάσης δεδομένων ζώνης ώρας IANA.
Conversation.LocalTimeZoneOffset ημερομηνία και ώρα Η μετατόπιση ώρας από UTC για την τρέχουσα τοπική ζώνη ώρας.
Κωδικός σφάλματος string Ο κωδικός σφάλματος για το τρέχον σφάλμα.
Το μήνυμα σφάλματος για το τρέχον σφάλμα.
Μήνυμα λάθους string Το μήνυμα σφάλματος για το τρέχον σφάλμα.
Σημείωση: Αυτή η μεταβλητή υποστηρίζεται μόνο εάν η ενεργοποίηση είναι On Error.
FallbackCount Αριθμός Αυτή η μεταβλητή μετρά τις φορές που ένα θέμα δεν μπόρεσε να αντιστοιχιστεί με την εισαγωγή του χρήστη.
Σημείωση: Αυτή η μεταβλητή υποστηρίζεται μόνο εάν η ενεργοποίηση είναι On Unknown Intent.
InactivityTimer.Continue Boolean Boolean σημαία που αντιπροσωπεύει εάν ο χρονοδιακόπτης πρέπει να συνεχίσει.
Σημείωση: Αυτή η μεταβλητή υποστηρίζεται μόνο εάν η ενεργοποίηση είναι Inactivity.
InactivityTimer.ΜετρητήςInActivity Αριθμός Πόσες φορές ενεργοποιήθηκε ο χρονοδιακόπτης OnInactivity λόγω αδράνειας του χρήστη μετά τη ρυθμισμένη ώρα.
Σημείωση: Αυτή η μεταβλητή υποστηρίζεται μόνο εάν η ενεργοποίηση είναι Inactivity. Μάθετε περισσότερα στο έναυσμα αδράνειας.
LastMessage.Id string Το αναγνωριστικό του προηγούμενου μηνύματος που στάλθηκε από τον χρήστη.
LastMessage.Text string Το προηγούμενο μήνυμα που στάλθηκε από τον χρήστη.
Αναγνωριστής.ΕξαγόμενεςΟντότητες επιλογή Αντιπροσωπεύει τις οντότητες που έχουν εξαχθεί από το μήνυμα ενεργοποίησης.
Σημείωση: Αυτή η μεταβλητή υποστηρίζεται μόνο εάν η ενεργοποίηση είναι On Select Intent.
Recognizer.IntentOptions επιλογή Αντιπροσωπεύει τις επιλογές πρόθεσης όταν η αναγνώριση επιστρέφει διφορούμενα αποτελέσματα.
Σημείωση: Αυτή η μεταβλητή υποστηρίζεται μόνο εάν η ενεργοποίηση είναι On Select Intent.
Αναγνώριση.ΕπιλεγμένηΠρόθεση επιλογή Αντιπροσωπεύει την πρόθεση που επιλέχθηκε από την αναγνώριση.
Σημείωση: Αυτή η μεταβλητή υποστηρίζεται μόνο εάν η ενεργοποίηση είναι On Select Intent.
Recognizer.TriggeringMessage.Id string Το αναγνωριστικό του μηνύματος χρήστη που ενεργοποίησε το τρέχον θέμα.
Recognizer.TriggeringMessage.Text (Μήνυμα Έναρξης Αναγνώρισης) string Το μήνυμα χρήστη που ενεργοποίησε το τρέχον θέμα.
Αναγνωριστής.ΠολλαπλάΘέματαΤαυτίστηκανΛόγος string Χρησιμοποιείται για να προσδιορίσει γιατί αντιστοιχίστηκαν πολλά θέματα.
Σημείωση: Αυτή η μεταβλητή υποστηρίζεται μόνο εάν η ενεργοποίηση είναι On Select Intent.
SignInReason επιλογή Χρησιμοποιείται για να προσδιορίσει την επιλογή εισόδου που απαιτείται κατά την ενεργοποίηση του θέματος.
Σημείωση: Αυτή η μεταβλητή υποστηρίζεται μόνο εάν η ενεργοποίηση είναι On Sign In.
Χρήστης.Γλώσσα επιλογή Αυτή η μεταβλητή χρησιμοποιείται για τον καθορισμό των τοπικών ρυθμίσεων στη γλώσσα χρήστη ανά συνομιλία.

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

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

Όνομα Τύπος Ορισμός
Δραστηριότητα.ΕίσοδοςΠλήκτρωνDTMF string Η ακατέργαστη τιμή κλειδιού DTMF από την τηλεφωνία.
Activity.SpeechRecognition.Confidence Αριθμός Η βαθμολογία εμπιστοσύνης για την υπόθεση αυτόματης αναγνώρισης ομιλίας ολόκληρο το αποτέλεσμα, 0 έως 1.
δραστηριότητα.αναγνώρισηΟμιλίας.ελάχισταΔιαμορφωμένοΚείμενο string Ελαφρώς μορφοποιημένο κείμενο του αποτελέσματος της υπόθεσης αυτόματης αναγνώρισης ομιλίας. Για παράδειγμα, "Πεντακόσια δολάρια". Οι λέξεις διευκρινίζονται, αλλά περιλαμβάνονται βασική χρήση κεφαλαίων και σημεία στίξης.
Activity.UserInputType επιλογή Ο τύπος της πιο πρόσφατης καταχώρησης από τον χρήστη πράκτορα. Η τιμή μπορεί να είναι δοκιμή, ομιλία ή DTMF.
Συνομιλία.Επιτρέπονται Μόνο DTMF Boolean Δυαδική τιμή επιλογής που αντιπροσωπεύει εάν το IVR πρέπει να οριστεί σε λειτουργία μόνο DTMF κατά το περιβάλλον εκτέλεσης.
Conversation.SipUuiHeaderValue string Η συμβολοσειρά κεφαλίδας UUI που χρησιμοποιείται για τη διαβίβαση του περιβάλλοντος στο IVR κατά την έναρξη κλήσης.

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

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

Όνομα Τύπος Ορισμός
Χρήστης.ΕμφανιζόμενοΌνομα string Το εμφανιζόμενο όνομα του χρήστη που μιλάει τη δεδομένη στιγμή στο παράγοντα.
User.Email string Η διεύθυνση email του χρήστη που μιλάει τη δεδομένη στιγμή στον αντιπρόσωπο.
Χρήστης.Όνομα string Το πρώτο όνομα του χρήστη που μιλάει αυτή τη στιγμή στον πράκτορα.
User.Id string Το μοναδικό αναγνωριστικό του χρήστη που μιλάει τη δεδομένη στιγμή στον αντιπρόσωπο.
User.IsLoggedIn Boolean Δυαδική τιμή που δηλώνει εάν ο χρήστης που μιλάει στο παράγοντα έχει υποβληθεί σε έλεγχο ταυτότητας ή όχι.
User.LastName string Το όνομα της οικογένειας του χρήστη που μιλάει αυτή τη στιγμή στον εκπρόσωπο.
User.PrincipalName (Όνομα Κύριου Χρήστη) string Το κύριο όνομα χρήστη του χρήστη που μιλάει αυτή τη στιγμή στον παράγοντα.

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

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

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

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

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

Όνομα Τύπος Ορισμός
User.AccessToken string Το διακριτικό πρόσβασης για τον έλεγχο ταυτότητας του χρήστη με τον λογισμικό πράκτορα.
Χρήστης.ΕμφανιζόμενοΌνομα string Το εμφανιζόμενο όνομα του χρήστη που μιλάει τη δεδομένη στιγμή στο παράγοντα.
User.Email string Η διεύθυνση email του χρήστη που μιλάει τη δεδομένη στιγμή στον αντιπρόσωπο.
Χρήστης.Όνομα string Το πρώτο όνομα του χρήστη που μιλάει αυτή τη στιγμή στον πράκτορα.
User.Id string Το μοναδικό αναγνωριστικό του χρήστη που μιλάει τη δεδομένη στιγμή στον αντιπρόσωπο.
User.IsLoggedIn Boolean Δυαδική τιμή που δηλώνει εάν ο χρήστης που μιλάει στο παράγοντα έχει υποβληθεί σε έλεγχο ταυτότητας ή όχι.
User.LastName string Το όνομα της οικογένειας του χρήστη που μιλάει αυτή τη στιγμή στον εκπρόσωπο.
User.PrincipalName (Όνομα Κύριου Χρήστη) string Το κύριο όνομα του χρήστη που μιλάει αυτήν τη στιγμή στον εκπρόσωπο.
  • Last updated on