Κοινοποίηση μέσω


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

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

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

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

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

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

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

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

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

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

Οντότητες

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

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

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

Οι μεταβλητές περιβάλλοντος είναι μια έννοια του 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 = Ακαθόριστο > (σφάλμα επικύρωσης)
Μήνυμα κειμένου Συμβολοσειρά
Ναι/Όχι Boolean
Data source Συμβολοσειρά
Μυστικό Συμβολοσειρά

Σημείωμα

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

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

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

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

Σημείωμα

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

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

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

Πλήρες όνομα Τύπος Ορισμός
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 και είναι η προεπιλογή για νέους παράγοντες.

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

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

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

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

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

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

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

Πλήρες όνομα Τύπος Ορισμός
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 Το κύριο όνομα του χρήστη που μιλάει αυτήν τη στιγμή στον εκπρόσωπο.

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

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

Σημείωμα

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

Πλήρες όνομα Τύπος Ορισμός
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 κατά την έναρξη κλήσης.