Χρήση μεταβλητών

Σημαντικό

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

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

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

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

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

Εφαρμογή Web

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

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

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

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

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

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

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

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

Οντότητες

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   

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

   

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Ονομασία	Type	Κρυφός	Ορισμός
Activity.Channel	επιλογή	ορατή	Το αναγνωριστικό καναλιού της τρέχουσας συνομιλίας
Activity.ChannelData	οποιαδήποτε	κρυφό	Ένα αντικείμενο που περιέχει περιεχόμενο που αφορά συγκεκριμένα κανάλια
Activity.ChannelId	string	κρυφό	Το αναγνωριστικό καναλιού της τρέχουσας συνομιλίας, όπως μια συμβολοσειρά
Activity.From.Id	string	κρυφό	Το μοναδικό αναγνωριστικό ειδικά για το κανάλι του αποστολέα
Activity.From.Name	string	κρυφό	Το φιλικό για το χρήστη όνομα αποστολέα για συγκεκριμένο κανάλι
Activity.Name	string	ορατή	Το όνομα του συμβάντος
Activity.Text	string	ορατή	Το πιο πρόσφατο μήνυμα που στάλθηκε από τον χρήστη
Activity.Type	επιλογή	ορατή	Τύπος δραστηριότητας
Activity.TypeId	string	κρυφό	Τύπος δραστηριότητας, όπως μια συμβολοσειρά
Activity.Value	οποιαδήποτε	κρυφό	Αόριστη τιμή
Bot.Name	string	ορατή	Το όνομα του copilot
Channel.DisplayName	string	κρυφό	Το εμφανιζόμενο όνομα του καναλιού
Conversation.Id	string	ορατή	Το μοναδικό αναγνωριστικό της τρέχουσας συνομιλίας
LastActivity.Id	string	ορατή	Το αναγνωριστικό της δραστηριότητας που στάλθηκε προηγουμένως
LastMessage.Id	string	ορατή	Το αναγνωριστικό του προηγούμενου μηνύματος που στάλθηκε από τον χρήστη
LastMessage.Text	string	ορατή	Το προηγούμενο μήνυμα που στάλθηκε από τον χρήστη
Recognizer.TriggerMessage.Id	string	ορατή	Το αναγνωριστικό του μηνύματος χρήστη που ενεργοποίησε το τρέχον θέμα
Recognizer.TriggerMessage.Text	string	ορατή	Το μήνυμα χρήστη που ενεργοποίησε το τρέχον θέμα
User.DisplayName	string	ορατή	Το εμφανιζόμενο όνομα του συνδεδεμένου χρήστη

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

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

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

Όταν ένα θέμα καθορίζει μια μεταβλητή (για παράδειγμα, σε έναν κόμβο ερώτησης), το 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. Για καθεμία από τις μεταβλητές στο θέμα, επιλέξτε εάν θέλετε οι τιμές να μεταβιβάζονται, να λαμβάνονται ή και τα δύο μεταξύ των θεμάτων.

   

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

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

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

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