Ρυθμίστε τις παραμέτρους καθολικής σύνδεσης με το Microsoft Entra ID

To Copilot Studio υποστηρίζει καθολική σύνδεση (SSO). Το SSO επιτρέπει στους copilot στον ιστότοπό σας να συνδέουν τους πελάτες εάν έχουν ήδη συνδεθεί στη σελίδα ή την εφαρμογή όπου αναπτύσσεται ο copilot.

Για παράδειγμα, το copilot φιλοξενείται στο εταιρικό intranet ή σε μια εφαρμογή στην οποία ο χρήστης είναι ήδη συνδεδεμένος.

Υπάρχουν τέσσερα κύρια βήματα για τη ρύθμιση των παραμέτρων του SSO για το Copilot Studio:

1. Δημιουργήστε μια καταχώρηση εφαρμογής στο Microsoft Entra ID για τον προσαρμοσμένο καμβά σας.

2. Ορίστε ένα προσαρμοσμένο πεδίο για το copilot σας.

3. Ρυθμίστε τις παραμέτρους ελέγχου ταυτότητας στο Copilot Studio για την ενεργοποίηση SSO.

4. Ρυθμίστε τις παραμέτρους του κώδικα HTML προσαρμοσμένου καμβά για να ενεργοποιήσετε SSO

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

• Ενεργοποίηση ελέγχου ταυτότητας τελικού χρήστη με Microsoft Entra αναγνωριστικό
• Προσθήκη θέμα ελέγχου ταυτότητας στον συγκυβερνήτη σας
• Χρήση προσαρμοσμένου καμβά

Σημείωμα

Για να ρυθμίσετε τις παραμέτρους SSO χρησιμοποιώντας άλλες OAuth υπηρεσίες παροχής 2.0, ανατρέξτε στο θέμα Ρύθμιση παραμέτρων καθολικής σύνδεσης με υπηρεσίες παροχής OAuth γενικής χρήσης.

Υποστηριζόμενα κανάλια

Ο παρακάτω πίνακας περιλαμβάνει λεπτομέρειες για τα κανάλια που υποστηρίζουν αυτήν τη στιγμή SSO. Μπορείτε να προτείνετε υποστήριξη για επιπλέον κανάλια στο στο φόρουμ ιδεών στο Microsoft Copilot Studio.

Κανάλι	Υποστηρίζεται
Κανάλια υπηρεσίας Azure bot	Δεν υποστηρίζεται
Προσαρμοσμένος ιστότοπος	Υποστηρίζεται
Ιστοσελίδα επίδειξης	Δεν υποστηρίζεται
Facebook	Δεν υποστηρίζεται
Microsoft Teams1	Υποστηρίζεται
Εφαρμογή για κινητά	Δεν υποστηρίζεται
Πανκαναλικό για Customer Service 2	Υποστηρίζεται

1 Εάν έχετε επίσης ενεργοποιημένο το κανάλι Teams, πρέπει να ακολουθήσετε τις οδηγίες ρύθμισης παραμέτρων στην τεκμηρίωση Ρύθμιση παραμέτρων καθολικής σύνδεσης με Microsoft Entra αναγνωριστικό για συγκυβερνήτες Microsoft Teams . Εάν δεν ρυθμίσετε τις παραμέτρους της SSO του Teams σύμφωνα με τις οδηγίες σε αυτήν τη σελίδα, οι χρήστες αποτυγχάνουν πάντα στον έλεγχο ταυτότητας κατά τη χρήση του καναλιού Teams.

2 Υποστηρίζεται μόνο το κανάλι ζωντανής συνομιλίας. Για περισσότερες πληροφορίες, δείτεΡύθμιση παραμέτρων παράδοσης στο Dynamics 365 Customer Service.

Σημαντικό

Το SSO δεν υποστηρίζεται επί του παρόντος όταν ένας copilot είναι είτε:

• Δημοσιευμένο σε μία Power Apps πύλη.
• Δημοσιεύτηκε σε μια τοποθεσία Web SharePoint ως iframe.

Ωστόσο, το SSO υποστηρίζεται για ένα copilot που έχει δημοσιευτεί σε μια τοποθεσία Web SharePoint ως στοιχείο SPFx.

Εφαρμογή ιστού

Δημιουργήστε καταχωρήσεις εφαρμογής για την προσαρμοσμένη τοποθεσία web σας

Για να ενεργοποιήσετε το SSO, πρέπει να χρησιμοποιήσετε δύο ξεχωριστές εγγραφές εφαρμογών:

• Μια εγγραφή εφαρμογής ελέγχου ταυτότητας, η οποία επιτρέπει στο Microsoft Entra ID να κάνει έλεγχο ταυτότητας χρήστη για το copilot σας
• Μια καταχώρηση εφαρμογής καμβά που ενεργοποιεί το SSO για την προσαρμοσμένη ιστοσελίδα σας

Δεν συνιστούμε την επαναχρησιμοποίηση της ίδιας καταχώρισης εφαρμογής τόσο για τον copilot σας όσο και για τον προσαρμοσμένο ιστότοπό σας για λόγους ασφαλείας.

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

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

3. Προσθέστε το αναγνωριστικό καταχώρισης της εφαρμογής καμβά στην καταχώριση της εφαρμογής ελέγχου ταυτότητας.

Προσθήκη διεύθυνσης URL ανταλλαγής διακριτικού

Για να ενημερώσετε τις ρυθμίσεις ελέγχου ταυτότητας Microsoft Entra ID στο Copilot Studio, πρέπει να προσθέσετε τη διεύθυνση URL ανταλλαγής token για να επιτρέψετε στην εφαρμογή σας και το Copilot Studio να μοιράζονται πληροφορίες.

1. Στην πύλη Azure στη λεπίδα καταχώρισης της εφαρμογής ελέγχου ταυτότητας, μεταβείτε στην επιλογή Έκθεση ενός API.

2. Στην περιοχή Εμβέλεια, επιλέξτε το εικονίδιο Αντιγραφή στο πρόχειρο.

3. Στο Copilot Studio, στο μενού πλοήγησης, στην περιοχή Ρυθμίσεις, επιλέξτε Ασφάλεια και, στη συνέχεια, επιλέξτε το πλακίδιο Έλεγχος ταυτότητας.

4. Για τη διεύθυνση URL ανταλλαγής διακριτικού (απαιτείται για το SSO),επικολλήστε το πεδίο που αντιγράψατε νωρίτερα.

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

Ρύθμιση παραμέτρων της καταχώρησης εφαρμογής καμβά

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

2. Στην περιοχή Ρυθμίσεις παραμέτρων πλατφόρμας επιλέξτε Προσθήκη πλατφόρμας και, στη συνέχεια, επιλέξτε Web.

3. Στην περιοχή Ανακατεύθυνση URI, καταχωρήστε τη διεύθυνση URL για την ιστοσελίδα σας, για παράδειγμα http://contoso.com/index.html.

   

4. Στην ενότητα Εκχώρηση έμμεσων και υβριδικές ροέςενεργοποιήστε τα Διακριτικά πρόσβασης (χρησιμοποιούνται για έμμεσες ροές) και Διακριτικά αναγνωριστικού (χρησιμοποιούνται για έμμεσες και υβριδικές ροές).

5. Επιλέξτε Ρύθμιση παραμέτρων.

Βρείτε τη διεύθυνση URL διακριτικού του τελικού σημείου copilot

1. Στο Copilot Studio, ανοίξτε το copilot, στη συνέχεια, επιλέξτε Κανάλια.

2. Επιλέξτε Εφαρμογή για κινητές συσκευές.

3. Στο Τελικό σημείο διακριτικού, επιλέξτε Αντιγραφή.

   

Ρύθμιση παραμέτρων SSO στην ιστοσελίδα σας

Χρησιμοποιήστε τον κώδικα που παρέχεται στοαποθετήριο GitHub του Copilot Studio για να δημιουργήσετε μια ιστοσελίδα για τη διεύθυνση URL ανακατεύθυνσης. Αντιγράψτε τον κώδικα από το αποθετήριο GitHub και τροποποιήστε τον χρησιμοποιώντας τις ακόλουθες οδηγίες.

Σημείωμα

Ο κώδικας στο αποθετήριο του GitHub απαιτεί από τον χρήστη να επιλέξει ένα κουμπί σύνδεσης ή να συνδεθεί από διαφορετικό ιστότοπο. Για να ενεργοποιήσετε την αυτόματη σύνδεση, προσθέστε τον ακόλουθο κώδικα στην αρχή aysnc function main():

    (async function main() {
        if (clientApplication.getAccount() == null) {
           await clientApplication.loginPopup(requestObj).then(onSignin).catch(function (error) {console.log(error) });
        }
        // Add your BOT ID below 
        var theURL =

1. Μεταβείτε στη σελίδα Επισκόπηση στην πύλη Azure και αντιγράψτε το Αναγνωριστικό εφαρμογής (προγράμματος-πελάτη) και το Αναγνωριστικό καταλόγου (μισθωτής) από την καταχώρηση της εφαρμογής καμβά.

   

2. Για να ρυθμίσετε τις παραμέτρους της Βιβλιοθήκης ελέγχου ταυτότητας της Microsoft (MSAL):

   • Ανάθεση το clientId στο αναγνωριστικό εφαρμογής (προγράμαμτος-πελάτη).
   • Αναθέστε το authority στο https://login.microsoftonline.com/ και προσθέστε το αναγνωριστικό καταλόγου (μισθωτή) στο τέλος.

   Για παράδειγμα:

   var clientApplication;
       (function (){
       var msalConfig = {
           auth: {
               clientId: '692e92c7-xxxx-4060-76d3-b381798f4d9c',
               authority: 'https://login.microsoftonline.com/7ef988bf-xxxx-51af-01ab-2d7fd011db47'     
           },
   

3. Ορίστε τη μεταβλητή theURL στη διεύθυνση URL του τελικού σημείου διακριτικού που αντιγράψατε νωρίτερα. Για παράδειγμα:

   (async function main() {
   
       var theURL = "https://1c0.0.environment.api.powerplatform.com/powervirtualagents/bots/5a099fd/directline/token?api-version=2022-03-01-preview"
   

4. Επεξεργαστείτε την τιμή του userId ώστε να περιλαμβάνει ένα προσαρμοσμένο πρόθεμα. Για παράδειγμα:

   var userId = clientApplication.account?.accountIdentifier != null ? 
           ("My-custom-prefix" + clientApplication.account.accountIdentifier).substr(0, 64) 
           : (Math.random().toString() + Date.now().toString()).substr(0,64);
   

5. Αποθηκεύστε τις αλλαγές σας.

Δοκιμάστε τον copilot σας χρησιμοποιώντας την ιστοσελίδα σας

1. Ανοίξτε την ιστοσελίδα σας στο πρόγραμμα περιήγησης.

2. Επιλέξτε Σύνδεση.

   

   Σημείωμα

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

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

3. Μεταβείτε στη νέα καρτέλα και αντιγράψτε τον κωδικό επικύρωσης.

4. Μεταβείτε ξανά στην καρτέλα με τον copilot σας και επικολλήστε τον κωδικό επικύρωσης στη συνομιλία copilot σας.

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

• Εγγραφή εφαρμογής Azure

Κλασικός

Τεχνική επισκόπηση

Η εικόνα που ακολουθεί δείχνει πώς ένας χρήστης είναι συνδεδεμένος χωρίς να βλέπει μια προτροπή σύνδεσης (SSO) στο Copilot Studio:

1. Ο χρήστης copilot εισαγάγει μια φράση που ενεργοποιεί ένα θέμα σύνδεσης. Η θέμα εισόδου έχει σχεδιαστεί για να συνδέει τον χρήστη και να χρησιμοποιεί το διακριτικό ελέγχου ταυτότητας χρήστη (User.AccessToken μεταβλητή).

2. Το Copilot Studio στέλνει μια ειδοποίηση σύνδεσης για να μπορεί ο χρήστης να συνδεθεί με την υπηρεσία παροχής ταυτότητας που έχει ρυθμίσει.

3. Ο προσαρμοσμένος καμβάς του copilot διακόπτει την ειδοποίηση για σύνδεση και ζητά ένα διακριτικό εκ μέρους (OBO) από το Microsoft Entra ID. Ο καμβάς στέλνει το διακριτικό στο copilot.

4. Μετά τη λήψη του διακριτικού OBO, το copilot ανταλλάσει το διακριτικό OBO για ένα διακριτικό πρόσβασης και συμπληρώνει τη μεταβλητή AuthToken χρησιμοποιώντας την τιμή του διακριτικού πρόσβασης. Η μεταβλητή IsLoggedIn ορίζεται επίσης αυτήν τη στιγμή.

Δημιουργήστε μια καταχώρηση εφαρμογής στο Microsoft Entra ID για τον προσαρμοσμένο καμβά σας

Για να ενεργοποιήσετε το SSO, χρειάζεστε δύο ξεχωριστές εγγραφές εφαρμογών:

• Ένα για τον συγκυβερνήτη σας για να ενεργοποιήσετε τον έλεγχο ταυτότητας χρήστη με Microsoft Entra αναγνωριστικό.
• Μία για τον προσαρμοσμένο καμβά για ενεργοποίηση του SSO.

Σημαντικό

Δεν μπορείτε να χρησιμοποιήσετε ξανά την ίδια εγγραφή εφαρμογής τόσο για τον έλεγχο ταυτότητας χρηστών του copilot σας όσο και για τον προσαρμοσμένο καμβά σας.

Δημιουργήστε μια καταχώρηση εφαρμογής στον καμβά του copilot σας

1. Εισέλθετε στην Πύλη Azure.

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

   

3. Επιλέξτε Νέα καταχώριση.

   

4. Πληκτρολογήστε ένα όνομα για την καταχώρηση. Μπορεί να είναι χρήσιμο να χρησιμοποιήσετε το όνομα του copilot του οποίου τον καμβά καταχωρείτε και να συμπεριλάβετε έναν "καμβά" για να τον διαχωρίσετε από την καταχώρηση εφαρμογής για τον έλεγχο ταυτότητας.

   Για παράδειγμα, αν το copilot ονομάζεται "Βοήθεια πωλήσεων Contoso", μπορείτε να ονομάσετε την καταχώρηση της εφαρμογής "ContosoSalesCanvas" ή κάτι παρόμοιο.

5. Στην περιοχή Υποστηριζόμενοι τύποι λογαριασμών, επιλέξτε Λογαριασμοί σε οποιονδήποτε μισθωτή οργανισμού (Οποιοσδήποτε κατάλογος αναγνωριστικών - Πολυμισθωτής Microsoft Entra ) και προσωπικούς λογαριασμούς Microsoft (π.χ. Skype, Xbox).

6. Αφήστε την ενότητα URI ανακατεύθυνσης κενή προς το παρόν, καθώς καταχωρείτε αυτές τις πληροφορίες στα επόμενα βήματα. Επιλέξτε Καταχώρηση.

   

7. Αφού ολοκληρωθεί η καταχώριση, ανοίγει η σελίδα Επισκόπηση. Μεταβείτε στο Δηλωτικό. Επιβεβαιώστε ότι το accessTokenAcceptedVersion έχει οριστεί σε 2. Αν όχι, αλλάξτε το σε 2 και μετά επιλέξτε Αποθήκευση.

Προσθέστε τη διεύθυνση URL ανακατεύθυνσης

1. Ενώ η καταχώριση είναι ανοιχτή, μεταβείτε στην επιλογή Έλεγχος ταυτότητας και μετά επιλέξτε Προσθήκη πλατφόρμας.

   

2. Στο blade Configure platforms , επιλέξτε Web.

   

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

4. Επιλέξτε Ρύθμιση παραμέτρων για να επιβεβαιώσετε τις αλλαγές σας.

   

5. Μεταβείτε στα Δικαιώματα API. Επιλέξτε Εκχώρηση συναίνεσης διαχειριστή για <το όνομα του μισθωτή σας> και στη συνέχεια Ναι.

   Σημαντικό

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

   

Ορίστε ένα προσαρμοσμένο πεδίο για το copilot σας

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

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

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

2. Μεταβείτε στα Δικαιώματα API και βεβαιωθείτε ότι έχουν προστεθεί τα σωστά δικαιώματα για το copilot σας. Επιλέξτε Εκχώρηση συναίνεσης διαχειριστή για <το όνομα του μισθωτή σας> και στη συνέχεια Ναι.

   Σημαντικό

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

3. Μεταβείτε στην Εμφάνιση ενός API και επιλέξτε Προσθήκη πεδίου.

   

4. Εισαγάγετε ένα όνομα για το πεδίο, μαζί με τις εμφανιζόμενες πληροφορίες που θα πρέπει να εμφανίζονται στους χρήστες όταν εισέρχονται στην οθόνη SSO. Επιλέξτε Προσθήκη πεδίου.

   

5. Επιλέξτε Προσθήκη εφαρμογής προγράμματος-πελάτη.

6. Εισαγάγετε το Αναγνωριστικό εφαρμογής (πρόγραμμα-πελάτης) από τη σελίδα Επισκόπηση για την καταχώριση της εφαρμογής καμβά στο πεδίο Αναγνωριστικό πελάτη. Επιλέξτε το πλαίσιο ελέγχου για το πεδίο που δημιουργήσατε.

7. Επιλέξτε Προσθήκη εφαρμογής.

Ρυθμίστε τις παραμέτρους ελέγχου ταυτότητας στο Copilot Studio για την ενεργοποίηση SSO

Η Διεύθυνση URL ανταλλαγής διακριτικών στη σελίδα διαμόρφωσης ελέγχου ταυτότητας του Copilot Studio χρησιμοποιείται για την ανταλλαγή του διακριτικού OBO για το διακριτικό πρόσβασης που ζητήθηκε μέσω του Bot Framework.

Το Copilot Studio καλεί το Microsoft Entra ID για την εκτέλεση της πραγματικής ανταλλαγής.

1. Συνδεθείτε στο Copilot Studio.

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

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

   

4. Εισαγάγετε το πλήρες URI πεδίου από το επίπεδο Έκθεση ενός API για την καταχώρηση της εφαρμογής ελέγχου ταυτότητας του copilot στο πεδίο Διεύθυνση URL του διακριτικού ανταλλαγής. Το URI πρέπει να έχει τη μορφή του api://1234-4567/scope.name.

   

   

5. Επιλέξτε Αποθήκευση και μετά δημοσιεύστε το περιεχόμενο του copilot.

Ρυθμίστε τις παραμέτρους του κώδικα HTML προσαρμοσμένου καμβά για να ενεργοποιήσετε SSO

Ενημερώστε τη σελίδα προσαρμοσμένου καμβά όπου βρίσκεται το copilot για να διακόψετε το αίτημα κάρτας σύνδεσης και να ανταλλάξετε το διακριτικό OBO.

1. Ρυθμίστε τις παραμέτρους της Βιβλιοθήκης ελέγχου ταυτότητας της Microsoft (MSAL) προσθέτοντας τον παρακάτω κώδικα σε μια ετικέτα <script> στην ενότητα <head>.

2. Ενημερώστε το clientId με το Αναγνωριστικό εφαρμογής (πρόγραμμα-πελάτης) για την καταχώριση της εφαρμογής καμβά. Αντικαταστήστε το <Directory ID> με το Αναγνωριστικό καταλόγου (μισθωτής). Μπορείτε να λάβετε αυτά τα αναγνωριστικά από τη σελίδα Επισκόπηση για την καταχώρηση της εφαρμογής καμβά.

   

   <head>
    <script>
      var clientApplication;
        (function () {
          var msalConfig = {
              auth: {
                clientId: '<Client ID [CanvasClientId]>',
                authority: 'https://login.microsoftonline.com/<Directory ID>'
              },
              cache: {
                cacheLocation: 'localStorage',
                storeAuthStateInCookie: false
              }
          };
          if (!clientApplication) {
            clientApplication = new Msal.UserAgentApplication(msalConfig);
          }
        } ());
    </script>
   </head>
   

3. Εισαγάγετε το ακόλουθο <script> στην ενότητα <body>. Αυτή η δέσμη ενεργειών καλεί μια μέθοδο ανάκτησης resourceUrl και ανταλλαγής του τρέχοντος διακριτικού σας με ένα διακριτικό που ζητείται από την OAuth προτροπή.

   <script>
   function getOAuthCardResourceUri(activity) {
     if (activity &&
          activity.attachments &&
          activity.attachments[0] &&
          activity.attachments[0].contentType === 'application/vnd.microsoft.card.oauth' &&
          activity.attachments[0].content.tokenExchangeResource) {
            // asking for token exchange with Microsoft Entra ID
            return activity.attachments[0].content.tokenExchangeResource.uri;
      }
   }
   
   function exchangeTokenAsync(resourceUri) {
     let user = clientApplication.getAccount();
      if (user) {
        let requestObj = {
          scopes: [resourceUri]
        };
        return clientApplication.acquireTokenSilent(requestObj)
          .then(function (tokenResponse) {
            return tokenResponse.accessToken;
            })
            .catch(function (error) {
              console.log(error);
            });
            }
            else {
            return Promise.resolve(null);
      }
   }
   </script>
   

4. Εισαγάγετε το ακόλουθο <script> στην ενότητα <body>. Στη μέθοδο main, ο κωδικός αυτός προσθέτει ένα στοιχείο υπό όρους στο store σας με το μοναδικό αναγνωριστικό του copilot σας. Δημιουργεί επίσης ένα μοναδικό αναγνωριστικό ως μεταβλητή userId.

5. Ενημερώστε το <COPILOT ID> με το αναγνωριστικό του copilot σας. Μπορείτε να δείτε το αναγνωριστικό του copilot στην καρτέλα καναλιών για το copilot που χρησιμοποιείτε και επιλέγοντας Εφαρμογή για κινητές συσκευές στην πύλη Copilot Studio.

   

   <script>
       (async function main() {
   
           // Add your COPILOT ID below 
           var BOT_ID = "<BOT ID>";
           var theURL = "https://powerva.microsoft.com/api/botmanagement/v1/directline/directlinetoken?botId=" + BOT_ID;
   
           const {
               token
           } = await fetchJSON(theURL);
   
           var directline = await fetchJSON(regionalChannelSettingsURL).then(res=> res.channelUrlsById.directline); 
   
           const directLine = window.WebChat.createDirectLine({
               domain: `${directline}v3/directline`,
               token
           });
   
           var userID = clientApplication.account?.accountIdentifier != null ?
               ("Your-customized-prefix-max-20-characters" + clientApplication.account.accountIdentifier).substr(0, 64) :
               (Math.random().toString() + Date.now().toString()).substr(0, 64); // Make sure this will not exceed 64 characters 
           const store = WebChat.createStore({}, ({
               dispatch
           }) => next => action => {
               const {
                   type
               } = action;
               if (action.type === 'DIRECT_LINE/CONNECT_FULFILLED') {
                   dispatch({
                       type: 'WEB_CHAT/SEND_EVENT',
                       payload: {
                           name: 'startConversation',
                           type: 'event',
                           value: {
                               text: "hello"
                           }
                       }
                   });
                   return next(action);
               }
               if (action.type === 'DIRECT_LINE/INCOMING_ACTIVITY') {
                   const activity = action.payload.activity;
                   let resourceUri;
                   if (activity.from && activity.from.role === 'bot' &&
                       (resourceUri = getOAuthCardResourceUri(activity))) {
                       exchangeTokenAsync(resourceUri).then(function(token) {
                           if (token) {
                               directLine.postActivity({
                                   type: 'invoke',
                                   name: 'signin/tokenExchange',
                                   value: {
                                       id: activity.attachments[0].content.tokenExchangeResource.id,
                                       connectionName: activity.attachments[0].content.connectionName,
                                       token,
                                   },
                                   "from": {
                                       id: userID,
                                       name: clientApplication.account.name,
                                       role: "user"
                                   }
                               }).subscribe(
                                   id => {
                                       if (id === 'retry') {
                                           // copilot was not able to handle the invoke, so display the oauthCard
                                           return next(action);
                                       }
                                       // else: tokenexchange successful and we do not display the oauthCard
                                   },
                                   error => {
                                       // an error occurred to display the oauthCard
                                       return next(action);
                                   }
                               );
                               return;
                           } else
                               return next(action);
                       });
                   } else
                       return next(action);
               } else
                   return next(action);
           });
   
           const styleOptions = {
   
               // Add styleOptions to customize Web Chat canvas
               hideUploadButton: true
           };
   
           window.WebChat.renderWebChat({
                   directLine: directLine,
                   store,
                   userID: userID,
                   styleOptions
               },
               document.getElementById('webchat')
           );
       })().catch(err => console.error("An error occurred: " + err));
   </script>
   

Πλήρες δείγμα κώδικα

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