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

Χρήση κλασικού bot συνομιλίας ως δεξιότητα σε ένα bot Bot Framework

  • Άρθρο

Σημείωμα

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

Όταν χρησιμοποιείτε ένα κλασικό chatbot ως a δυνατότητα with a bot, το Bot Framework bot καθορίζει αν κάτι που λέει ο χρήστης ταιριάζει με τις φράσεις ενεργοποίησης Bot Framework του κλασικού chatbot. Εάν υπάρχει αντιστοιχία, Bot Framework το bot περνά τη συνομιλία στο κλασικό chatbot. Το κλασικό chatbot εξάγει οποιεσδήποτε οντότητες και ενεργοποιεί την αντίστοιχη θέμα.

Μπορείτε επίσης να περάσετε μια μεταβλητή στο a Copilot Studio δυνατότητα θέμα ως είσοδο από Bot Framework το Composer και να χρησιμοποιήσετε τις εξόδους που επιστρέφει.

Σημαντικό

Πρέπει να έχετε δοκιμαστική ή πλήρη Copilot Studio άδεια χρήσης για να χρησιμοποιήσετε κλασικά chatbots ως δεξιότητες. Αυτή η δυνατότητα δεν είναι διαθέσιμη με την άδεια χρήσης του Copilot Studio Teams.

Για να ρυθμίσετε το κλασικό bot συνομιλίας ως δυνατότητα:

  1. Προσθέστε το bot Bot Framework στη λίστα επιτρεπόμενων για το κλασικό chatbot.

  2. Κατεβάστε το δυνατότητα μανιφέστο για το κλασικό chatbot.

  3. Χρησιμοποιήστε το ληφθέν δυνατότητα δηλωτικό στο Bot Framework Composer για να δημιουργήσετε μια σύνδεση μεταξύ των bots.

  4. Χρησιμοποιήστε τον Bot Framework εξομοιωτή για να επιβεβαιώσετε ότι το bot λειτουργεί ως δυνατότητα.

Προϋποθέσεις

Προσθέστε το bot Bot Framework σας στη λίστα επιτρεπόμενων για το κλασικό bot συνομιλίας σας

Προσθέστε το αναγνωριστικό εφαρμογής bot Bot Framework στη λίστα επιτρεπόμενων για το κλασικό bot συνομιλίας που θέλετε να χρησιμοποιήσετε ως δυνατότητα. Τα bot πρέπει να είναι στον ίδιο μισθωτή.

  1. Στο Bot Framework Composer ανοίξτε το bot που θα χρησιμοποιήσει τις δεξιότητες. Επιλέξτε Ρύθμιση παραμέτρων και, στη συνέχεια, επιλέξτε Πόροι ανάπτυξης. Αντιγράψτε το αναγνωριστικό στο Αναγνωριστικό εφαρμογής της Microsoft.

  2. Στο Copilot Studio, ανοίξτε το κλασικό chatbot που θέλετε να χρησιμοποιήσετε ως δυνατότητα.

  3. Στο μενού πλοήγησης, μεταβείτε στις Ρυθμίσεις και επιλέξτε Ασφάλεια. Έπειτα, επιλέξτε Λίστα επιτρεπομένων.

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

  5. Επικολλήστε το αναγνωριστικό εφαρμογής του bot Bot Framework και επιλέξτε Επόμενο.

    Προσοχή

    Ένα κλασικό chatbot δεν μπορεί να λειτουργήσει ως δυνατότητα για άλλα κλασικά chatbots. Εάν επιχειρήσετε να προσθέσετε ένα αναγνωριστικό εφαρμογής που ανήκει σε ένα bot Power Virtual Agent στη λίστα επιτρεπόμενων, θα εμφανιστεί ένα σφάλμα. Μπορείτε να προσθέσετε μόνο ένα αναγνωριστικό εφαρμογής για ένα bot Bot Framework.

    Copilot Studio Επικυρώνει το αναγνωριστικό εφαρμογής του bot Bot Framework και επιβεβαιώνει ότι ανήκει σε μια bot στον ίδιο μισθωτή.

  6. (Προαιρετικό) Προσθέστε ένα Εμφανιζόμενο όνομα για το bot που έχετε προσθέσει στη λίστα επιτρεπόμενων.

  7. Επιλέξτε Αποθήκευση.

Το bot Bot Framework υποδεικνύεται από το εμφανιζόμενο όνομα εάν καταχωρήσατε μια καταχώρηση ή από το αναγνωριστικό εφαρμογής του εάν δεν πληκτρολογήσατε ένα εμφανιζόμενο όνομα. Για να το διαγράψετε ή να το επεξεργαστείτε οποιαδήποτε στιγμή, επιλέξτε το εικονίδιο στα δεξιά του αναγνωριστικού εφαρμογής ή του εμφανιζόμενου ονόματος του bot.

Σημείωμα

Τα bot Bot Framework που έχουν προστεθεί στη λίστα επιτρεπόμενων δεν εξάγονται ως μέρος του περιεχομένου του bot.

Κατεβάστε το κλασικό chatbot δυνατότητα μανιφέστο για το κλασικό chatbot σας

Bot Framework Τα bots μπορούν να χρησιμοποιήσουν το A Copilot Studio δυνατότητα Manifest για να διαμορφώσουν μια σύνδεση με το κλασικό chatbot που παρήγαγε το μανιφέστο.

Όλα τα κλασικά chatbots έχουν δυνατότητα δηλωτικά. Αυτά είναι αρχεία JSON που περιλαμβάνουν το όνομα, το περιβάλλον εργασίας και τις φράσεις ενεργοποίησης μιας δεξιότητας.

A Bot Framework bot μπορεί να χρησιμοποιήσει ένα μανιφέστο δυνατότητα για να γνωρίζει πότε να ενεργοποιήσει το κλασικό chatbot (για παράδειγμα, σε απάντηση κάτι που του λέει ένας χρήστης).

Copilot Studio δυνατότητα οι διακηρύξεις ακολουθούν την έκδοση 2.2 του σχήματος Bot Framework διακήρυξης δυνατότητα και αποτελούνται από αρχεία intents.lu και manifest.json .

Α Bot Framework bot μπορεί να αποφασίσει στο κλασικό chatbot θα πρέπει να χειριστεί το αίτημα του χρήστη, με βάση τα δηλωτικά δεδομένα. Περνάει στο κλασικό chatbot όλα όσα είπε ο χρήστης. Στη συνέχεια, το κλασικό chatbot ταιριάζει με αυτό που είπε ο χρήστης στο a Copilot Studio θέμα, εξάγει τυχόν οντότητες που απαιτούνται για τη συμπλήρωση υποδοχής και ενεργοποιεί το Copilot Studio θέμα.

Copilot Studio δυνατότητα τα δηλωτικά δημιουργούνται και ενημερώνονται αυτόματα. Ένα κλασικό chatbot έχει δύο δυνατότητα δηλωτικά:

  • Διακήρυξη δοκιμής: Επιτρέπει Bot Framework στους bot να συνδεθούν στη δοκιμαστική έκδοση του κλασικού bot συνομιλίας. Χρησιμοποιήστε το δοκιμαστικό δηλωτικό για να επικυρώσετε αλλαγές στη δεξιότητά σας πριν τη δημοσίευση.

    • Το δοκιμαστικό μανιφέστο είναι άμεσα διαθέσιμο για κάθε νεοσύστατο κλασικό chatbot.
    • Ενημερώνεται αυτόματα ώστε να αντικατοπτρίζει τις αλλαγές κάθε φορά που αποθηκεύετε το κλασικό bot συνομιλίας.

  • Δημοσιευμένο μανιφέστο: Επιτρέπει στους Bot Framework bot να συνδεθούν στη δημοσιευμένη έκδοση του κλασικού bot συνομιλίας.

    • Το δημοσιευμένο μανιφέστο είναι διαθέσιμο μόνο για κλασικά chatbots που έχουν δημοσιευτεί τουλάχιστον μία φορά.
    • Ενημερώνεται αυτόματα ώστε να αντικατοπτρίζει τις αλλαγές κάθε φορά που δημοσιεύετε το εκπρόσωπος σας.

Σημείωμα

Το Δημοσιευμένο μανιφέστο δεν είναι διαθέσιμο για κλασικά bot συνομιλίας που δεν έχουν δημοσιευτεί ποτέ.

Για να δημιουργήσετε το Δημοσιευμένο μανιφέστο του bot σας, δημοσιεύστε το κλασικό chatbot σας.

Τα δύο δηλωτικά δεξιοτήτων εμφανίζονται στον πίνακα Διαχείριση λίστας επιτρεπόμενων.

Τα δηλωτικά δεξιοτήτων εμφανίζονται επίσης και στη σελίδα "Λεπτομέρειες" του copilot. Στο μενού πλοήγησης, επιλέξτε Ρυθμίσεις και μετά Λεπτομέρειες. Η σελίδα "Λεπτομέρειες" εμφανίζει άλλα μετα-δεδομένα, όπως το Αναγνωριστικό περιβάλλοντος, το Αναγνωριστικό μισθωτή και το Αναγνωριστικό εφαρμογής bot.

Για να κάνετε λήψη ενός δηλωτικού, επιλέξτε το. Μεταφορτώνεται ως αρχείο .zip με την ετικέτα _<bot διακήρυξη ονόματος> για τη δημοσιευμένη διακήρυξη ή < bot όνομα test__manifest> για τη διακήρυξη δοκιμής.

Σημείωμα

Το μανιφέστο δυνατότητα δεν περιλαμβάνει θέματα συστήματος και διαλόγους συνθέτη που προστίθενται σε ένα κλασικό bot συνομιλίας. Περιλαμβάνονται μόνο τα θέματα που δημιουργήθηκαν από τους συντάκτες του copilot και τις ενεργοποιήσεις του Composer που προσθέτουν οι συντάκτες στο bot.

Σύνδεση με δυνατότητα Copilot Studio στο Composer

Χρήση Copilot Studio δυνατότητα διακηρύξεις για να δημιουργήσετε μια σύνδεση δυνατότητα στο bot σας Bot Framework στο Composer.

  1. Σε ένα έργο Bot Framework Composer, επιλέξτε Προσθήκη και, στη συνέχεια, επιλέξτε Σύνδεση με μια δεξιότητα.

  2. Αναζητήστε και επιλέξτε μια Copilot Studio διακήρυξη .zip αρχειοθέτηση και, στη συνέχεια, επιλέξτε Επόμενο.

  3. Επιλέξτε τα θέματα ή τους στόχους στο κλασικό bot συνομιλίας που θέλετε να προσθέσετε στο bot Bot Framework σας και, στη συνέχεια, επιλέξτε Επόμενο.

  4. Ελέγξτε και επεξεργαστείτε τις φράσεις ενεργοποίησης για το κλασικό bot συνομιλίας και, στη συνέχεια, επιλέξτε Επόμενο.

  5. Βεβαιωθείτε ότι είναι επιλεγμένο το στοιχείο Χρήση Orchestrator για έργα πολλών bot και, στη συνέχεια, επιλέξτε Συνέχεια.

  6. Βεβαιωθείτε ότι το δυνατότητα Copilot Studio έχει προστεθεί σωστά στο bot σας Bot Framework και ότι εμφανίζεται ένα νέο έναυσμα με το όνομα του κλασικού bot συνομιλίας στο έργο στο Composer.

Εντοπίστε το θέμα στο δηλωτικό δεξιοτήτων

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

  1. Επιλέξτε την ενέργεια Σύνδεση σε δεξιότητα.

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

  3. Βρείτε δραστηριότητες στο δηλωτικό. Αυτή η ιδιότητα περιέχει ένθετες ιδιότητες που αντιπροσωπεύουν τα θέματα που είναι διαθέσιμα στο κλασικό bot συνομιλίας.

  4. Βρείτε το θέμα θέλετε να καλέσετε και αναζητήστε την ιδιότητα ονόματος. Όταν το Copilot Studio δυνατότητα λαμβάνει ένα συμβάν με αυτό το όνομα, ενεργοποιεί το θέμα.

    Σε αυτό το παράδειγμα, το όνομα της δραστηριότητας συμβάντος είναι dispatchTo_new_topic_87609dabd86049f7bc6507c6f7263aba_33d.

Καλέστε α Copilot Studio δυνατότητα θέμα

Αντί να βασίζεστε σε αυτό που λέει ένας χρήστης για να ενεργοποιήσει το a Copilot Studio δυνατότητα θέμα, μπορείτε να το καλέσετε απευθείας. Μπορείτε να καλέσετε Copilot Studio μόνο απευθείας θέματα που παρατίθενται στη διακήρυξη δυνατότητα.

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

  2. Στη λίστα Όνομα διαλόγου δυνατότητα , επιλέξτε το κλασικό bot συνομιλίας.

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

  4. Επιλέξτε Κλείσιμο.

  5. Στην ενότητα Δραστηριότητα, επιλέξτε Εμφάνιση κώδικα.

  6. Πληκτρολογήστε ή επικολλήστε τον παρακάτω κώδικα. Αντικαταστήστε το TOPIC_ACTIVITY_NAME με το όνομα της δραστηριότητας συμβάντος του θέματος. Βεβαιωθείτε ότι δεν υπάρχουν εισαγωγικά στην ιδιότητα όνομα.

    [Activity
    type = event
    name = TOPIC_ACTIVITY_NAME
]

Περάστε μια μεταβλητή εισόδου σε ένα Copilot Studio δυνατότητα θέμα

Bot Framework Ο συνθέτης μπορεί να περάσει μια μεταβλητή στο a Copilot Studio δυνατότητα θέμα ως είσοδο. Για να μάθετε πώς μπορείτε να δημιουργήσετε Copilot Studio θέματα που δέχονται μεταβλητές εισόδου, ανατρέξτε στο θέμα Εργασία με μεταβλητές.

Εάν ένα Copilot Studio θέμα που μπορεί να λάβει μια μεταβλητή εισόδου παρατίθεται στη διακήρυξη δυνατότητα σας, μπορείτε να μεταβιβάσετε μια μεταβλητή Composer σε αυτήν.

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

  2. Στη λίστα Όνομα διαλόγου δυνατότητα , επιλέξτε το κλασικό bot συνομιλίας.

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

  4. Βρείτε την ιδιότητα τιμή του θέματος. Η ιδιότητα τιμή περιέχει μια ιδιότητα $ref. Αντιγράψτε αυτήν την τιμή και αποθηκεύστε την για να την χρησιμοποιήσετε στο επόμενο βήμα.

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

    Εάν το a Copilot Studio θέμα δεν έχει εισόδους, δεν θα έχει ιδιότητα value .

  5. Βρείτε την ιδιότητα ορισμοί και, στη συνέχεια αναζητήστε μια ένθετη ιδιότητα που να ταιριάζει με την τιμή $ref που βρήκατε στο προηγούμενο βήμα. Σημειώστε τα ονόματα και τους τύπους των εισόδων του Copilot Studio θέμα. Θα τα χρησιμοποιήσετε στα επόμενα βήματα.

  6. Επιλέξτε Κλείσιμο.

  7. Στην ενότητα Δραστηριότητα, επιλέξτε Εμφάνιση κώδικα.

  8. Πληκτρολογήστε ή επικολλήστε τον παρακάτω κώδικα. Αντικαταστήστε αυτές τις τιμές:

    1. Αντικαταστήστε το TOPIC_ACTIVITY_NAME με το όνομα της δραστηριότητας συμβάντος του θέματος.
    2. Αντικαταστήστε το PVA_INPUT_VARIABLE με μια μεταβλητή εισόδου από το θέμα σας.
    3. Αντικαταστήστε το COMPOSER_INPUT_VARIABLE με μια μεταβλητή Composer που θα παρέχει μια τιμή.
    [Activity
    Type = event
    Name = TOPIC_ACTIVITY_NAME
    Value = ${addProperty(json("{}"), 'PVA_INPUT_VARIABLE', COMPOSER_INPUT_VARIABLE)}
]

    Σε αυτό το παράδειγμα, η μεταβλητή dialog.storeLocation Composer παρέχει μια τιμή στη μεταβλητή pva_StoreLocation εισόδου στο κλασικό θέμα dispatchTo_new_topic_127cdcdbbb4a480ea113c5101f309089_21a34f16 chatbot.

Λάβετε μια μεταβλητή εξόδου από ένα Copilot Studio δυνατότητα θέμα

Είναι δυνατή η λήψη εξόδων από ένα Copilot Studio δυνατότητα θέμα στο Composer. Για να μάθετε πώς μπορείτε να δημιουργήσετε Copilot Studio θέματα που επιστρέφουν αποτελέσματα, ανατρέξτε στο θέμα Εργασία με μεταβλητές.

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

  2. Στη λίστα Όνομα διαλόγου δυνατότητα , επιλέξτε το κλασικό bot συνομιλίας.

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

  4. Βρείτε την ιδιότητα resultValue του θέματος. Η ιδιότητα resultValue περιέχει μια ιδιότητα $ref. Αντιγράψτε αυτήν την τιμή και αποθηκεύστε την για να την χρησιμοποιήσετε στο επόμενο βήμα.

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

    Εάν το a Copilot Studio θέμα δεν έχει εξόδους, δεν θα έχει ιδιότητα resultValue .

  5. Βρείτε την ιδιότητα ορισμοί και, στη συνέχεια αναζητήστε μια ένθετη ιδιότητα που να ταιριάζει με την τιμή $ref που βρήκατε στο προηγούμενο βήμα. Σημειώστε τα ονόματα και τους τύπους των μεταβλητών εξόδου του θέμα Copilot Studio . Θα τα χρησιμοποιήσετε στα επόμενα βήματα.

    Σε αυτό το παράδειγμα, το Copilot Studio θέμα επιστρέφει δύο εξόδους τύπου String,pva_State και pva_Item.

  6. Επιλέξτε Κλείσιμο.

  7. Στην ενότητα Δραστηριότητα, επιλέξτε Εμφάνιση κώδικα.

  8. Πληκτρολογήστε ή επικολλήστε τον παρακάτω κώδικα. Αντικαταστήστε το TOPIC_ACTIVITY_NAME με το όνομα της δραστηριότητας συμβάντος του θέματος. Βεβαιωθείτε ότι δεν υπάρχουν εισαγωγικά στην ιδιότητα όνομα.

    [Activity
    type = event
    name = TOPIC_ACTIVITY_NAME
]

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

  10. Στον καμβά σύνταξης σύνταξης του Composer, επιλέξτε Προσθήκη και στη συνέχεια, επιλέξτε Διαχείριση ιδιοτήτων και μετά επιλέξτε Ορισμός ιδιοτήτων.

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

    Σε αυτό το παράδειγμα, οι τιμές εξόδου από dialog.skillResult.pvaState και dialog.skillResult.pvaItem εξάγονται στο παράθυρο διαλόγου νέων μεταβλητών συνθέτη . Κατάσταση και διάλογος. Στοιχείο.

Δοκιμάστε το κλασικό chatbot σας ως δυνατότητα με ένα Bot Framework bot

Χρησιμοποιήστε τον Bot Framework εξομοιωτή για να ελέγξετε ότι bot σας Bot Framework καλεί σωστά ένα κλασικό chatbot ως δυνατότητα.

Σημαντικό

Το bot Bot Framework σας πρέπει να προστεθεί στη λίστα επιτρεπόμενων του κλασικού bot συνομιλίας για να λειτουργήσει η σύνδεση δυνατότητα.

Μάθετε περισσότερα