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

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

  • Άρθρο

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

  • Οι μεταβλητές θέματος μπορούν να χρησιμοποιηθούν μόνο στα θέματα στα οποία δημιουργούνται. Αυτό το πεδίο είναι το προεπιλεγμένο πεδίο για τις μεταβλητές που δημιουργείτε.
  • Οι καθολικές μεταβλητές μπορούν να χρησιμοποιηθούν σε όλα τα θέματα. Μπορείτε να αλλάξετε το πεδίο μιας μεταβλητής θέματος ώστε να την κάνετε μια καθολική μεταβλητή.
  • Οι μεταβλητές συστήματος δημιουργούνται αυτόματα με τον παράγοντα σας. Παρέχουν πληροφορίες βάσει περιβάλλοντος σχετικά με τη συνομιλία ή τον χρήστη. Είναι διαθέσιμες σε όλα τα θέματα.
  • Οι μεταβλητές περιβάλλοντος δημιουργούνται στο 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 Συμβλοσειρά
Βάρος Αριθμός
Ταχυδρομικός κώδικας Συμβλοσειρά
Προσαρμοσμένη οντότητα Επιλογή

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

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

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

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

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

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

Σημείωμα

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

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

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

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

Σημείωμα

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

Δεν εμφανίζονται όλες οι μεταβλητές συστήματος στη λίστα. Θα πρέπει να έχετε πρόσβαση σε αυτές τις κρυφές μεταβλητές συστήματος με τύπο 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 Αντιπροσωπεύει το εμφανιζόμενο όνομα για το παράγοντα μέσα στο κανάλι. Στο περιβάλλον του καναλιού τηλεφωνίας, η τιμή αυτής της μεταβλητής είναι ο αριθμός τηλεφώνου στον οποίο επισυνάπτεται ο εκπρόσωπος.
Activity.Text string Το πιο πρόσφατο μήνυμα που στάλθηκε από τον χρήστη
Activity.Type επιλογή Τύπος δραστηριότητας
Activity.TypeId string Τύπος δραστηριότητας, όπως μια συμβολοσειρά
Activity.Value οποιαδήποτε Αόριστη τιμή
Bot.EnvironmentId string Το αναγνωριστικό περιβάλλοντος του παράγοντα
Bot.Id string Το αναγνωριστικό του παράγοντα
Bot.Name string Το όνομα παράγοντα
Bot.SchemaName string Το όνομα του σχήματος του παράγοντα
Bot.TenantId string Το αναγνωριστικό μισθωτή του παράγοντα
ClientPluginActions επιλογή Συλλογή ενεργειών προσθηκών δυναμικού προγράμματος-πελάτη που πρέπει να λάβετε υπόψη για παραγωγική ενορχήστρωση
Conversation.Id string Το μοναδικό αναγνωριστικό της τρέχουσας συνομιλίας
Conversation.InTestMode Boolean Δυαδική τιμή που αντιπροσωπεύει αν η συνομιλία συμβαίνει σε δοκιμαστικό καμβά
Conversation.LocalTimeZone string Το όνομα της ζώνης ώρας που θα χρησιμοποιηθεί από το χρήστη σε μορφή βάσης δεδομένων ζώνης ώρας IANA
Conversation.LocalTimeZoneOffset datetime Η μετατόπιση ώρας από UTC για την τρέχουσα τοπική ζώνη ώρας
Κωδικός σφάλματος string Ο κωδικός σφάλματος για το τρέχον σφάλμα.
Το μήνυμα σφάλματος για το τρέχον σφάλμα.
Μήνυμα λάθους 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.
SignInReason επιλογή Χρησιμοποιείται για να προσδιορίσει την επιλογή είσοδου που απαιτείται κατά την ενεργοποίηση του θέματος.
Σημείωση: Αυτή η μεταβλητή υποστηρίζεται μόνο εάν η ενεργοποίηση είναι On Sign In.
User.Language επιλογή Αυτή η μεταβλητή χρησιμοποιείται για τον καθορισμό των τοπικών ρυθμίσεων στη γλώσσα χρήστη ανά συνομιλία.

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

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

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

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

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

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

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

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

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

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

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

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

Σημείωμα

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

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