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

Ενοποίηση web ή εγγενών εφαρμογών με το SDK Παραγόντων Microsoft 365

Σημαντικό

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

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

Σημείωμα

Εάν θέλετε να χρησιμοποιήσετε τον κώδικα ενσωμάτωσης για την εφαρμογή web στο Copilot Studio, πρέπει να ορίσετε τις επιλογές ελέγχου ταυτότητας ασφαλείας σε Χωρίς έλεγχο ταυτότητας. Μεταβείτε στην επιλογή Ρυθμίσεις Έλεγχος ταυτότητας>ασφαλείας> και επιλέξτε Χωρίς έλεγχο ταυτότητας για να τον καταστήσετε διαθέσιμο στο κοινό.

Αυτός ο οδηγός καλύπτει τον τρόπο λήψης του παράγοντα Copilot Studio και ενσωμάτωσής του με την υπάρχουσα εφαρμογή web (συνήθως μια τοποθεσία Web) ή την εγγενή εφαρμογή χρησιμοποιώντας το πρόγραμμα-πελάτη Copilot Studio με το SDK Microsoft 365 Agents.

Τα διάφορα μέρη αυτού του οδηγού είναι σχετικά, ανάλογα με το αν έχετε μια υπάρχουσα UX/UI στην οποία θέλετε να ενσωματώσετε τον παράγοντα ή αν σκοπεύετε να χρησιμοποιήσετε μια UX/UI που παρέχεται από τη Microsoft. Χρησιμοποιήστε τον παρακάτω πίνακα για να βρείτε την ενότητα που ταιριάζει με το σενάριό σας.

Μέθοδος ανάπτυξης Πώς, πού και γιατί Γρήγορη σύνδεση
Χρήση του προεπιλεγμένου κώδικα ενσωμάτωσης συνομιλίας Web Με έναν παράγοντα που έχει ενεργοποιημένη τη ρύθμιση ασφαλείας Χωρίς έλεγχο ταυτότητας, είναι διαθέσιμη στο τμήμα παραθύρου δημοσίευσης καναλιού Web στο Copilot Studio. Σημείωση: Αυτή η επιλογή εμφανίζεται μόνο όταν δεν έχετε επιλεγμένο έλεγχο ταυτότητας στο Copilot Studio. Χρησιμοποιήστε τον προεπιλεγμένο κώδικα ενσωμάτωσης συνομιλίας Web (χωρίς ανάπτυξη/κώδικα)
Σύνδεση στο Copilot Studio με είσοδο χρήστη Agents SDK Χρησιμοποιήστε τη συμβολοσειρά σύνδεσης Agents SDK ή ρυθμίσεις παραμέτρων για απευθείας ενοποίηση στον πράκτορά σας χρησιμοποιώντας διαπιστευτήρια χρήστη χρησιμοποιώντας το copilot. Ρύθμιση παραμέτρων της καταχώρησης της εφαρμογής σας για αλληλεπιδραστική είσοδο χρηστών
Σύνδεση στο Copilot Studio με είσοδο για την κύρια υπηρεσία Agents SDK Να χρησιμοποιηθεί όταν θέλετε ο αντιπρόσωπος να έχει τη δική του ταυτότητα και να μην χρησιμοποιηθεί εκ μέρους του χρήστη που αποκτά πρόσβαση στον πράκτορα. Χρήσιμο σε σενάρια όπου δεν χρειάζεστε περιβάλλον χρήστη, αλλά εξακολουθείτε να χρειάζεται να αποκτήσετε πρόσβαση σε προνομιακά API ή πληροφορίες και απαιτεί έλεγχο ταυτότητας. Σημείωση: Για να εκτελέσετε αυτή την εργασία, πρέπει να έχετε έλεγχο ταυτότητας για αυτόν τον παράγοντα στο Copilot Studio, ο οποίος έχει οριστεί σε Χωρίς έλεγχο ταυτότητας. Ρύθμιση παραμέτρων της καταχώρησης της εφαρμογής σας για την κύρια υπηρεσία
Χρήση DirectLine παλαιού τύπου για σύνδεση στο Copilot Studio Μπορείτε να συνδεθείτε στην DirectLine χρησιμοποιώντας το API DirectLine και θα πρέπει να χρησιμοποιηθεί εκεί όπου το SDK Αντιπροσώπων δεν υποστηρίζει το σενάριό σας. Δημοσίευση παράγοντα σε εφαρμογές για κινητές συσκευές ή σε προσαρμοσμένες εφαρμογές

Προαπαιτούμενα στοιχεία

  • .NET Core / JS/ Python
  • Πακέτα–Πρόγραμμα-πελάτης Copilot Studio
  • Ένας αντιπρόσωπος

Μέθοδοι ενσωμάτωσης του παράγοντα Copilot Studio

  • Πρόγραμμα-πελάτης Copilot Studio (χρησιμοποιώντας το Agents SDK): Αυτή η μέθοδος είναι ο προτιμώμενος τρόπος ενοποίησης με το Copilot Studio.

  • DirectLine: Η DirectLine είναι ο τρόπος ενοποίησης με το Copilot Studio παλαιού τύπου και θα πρέπει να χρησιμοποιείται όπου δεν υπάρχει υποστήριξη για την περίπτωση χρήσης σας με το πρόγραμμα-πελάτη Copilot Studio.

    • Δεν υποστηρίζει διακριτικό κύριας υπηρεσίας

Γρήγορα αποτελέσματα: Βασική ρύθμιση παραμέτρων και δοκιμή σύνδεσης παράγοντα με χρήση του SDK Microsoft 365 Agents

  1. Κάντε λήψη του δείγματος προγράμματος-πελάτη Copilot Studio από το SDK Microsoft 365 Agents.

    Απλοποιήσαμε την ενοποίηση με το Agents SDK για το Web και τις εγγενείς εφαρμογές σας, παρέχοντας μια βιβλιοθήκη προγραμμάτων-πελατών που επιτρέπει στους προγραμματιστές να καταχωρούν μερικές λεπτομέρειες σχετικά με τον πράκτορά σας και να την ενσωματώνουν εύκολα στις εφαρμογές σας.

  2. Λάβετε το δείγμα προγράμματος-πελάτη Copilot Studio από το αποθετήριο δεδομένων Agents SDK GitHub είτε σε C#, JavaScript ή Python.

  3. Λάβετε τον κώδικα ενσωμάτωσης ή τη συμβολοσειρά σύνδεσης για τον πράκτορά σας στο Copilot Studio.

    Χρειάζεστε πρόσβαση στον πράκτορά σας στο Copilot Studio για να λάβετε τις λεπτομέρειες της συμβολοσειράς σύνδεσης (ή λεπτομέρειες για τη ρύθμιση παραμέτρων) για να μπορέσετε να συνδεθείτε σε αυτή.

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

    • Εάν είναι επιλεγμένο το στοιχείο Έλεγχος ταυτότητας με τη Microsoft ή ο Έλεγχος ταυτότητας με μη αυτόματο τρόπο , βλέπετε μόνο την επιλογή συμβολοσειράς σύνδεσης για ενοποίηση με το SDK Agent.

    • Εάν δεν έχει επιλεγεί έλεγχος ταυτότητας , βλέπετε τόσο τον κώδικα ενσωμάτωσης που μπορείτε να προσθέσετε στην τοποθεσία Web σας όσο και τη συμβολοσειρά σύνδεσης. Η επιλογή Κώδικας Ενσωμάτωσης δεν χρησιμοποιεί το SDK των Πρακτόρων και χρησιμοποιεί το βασικό, έτοιμο προς χρήση συστατικό συνομιλίας Web.

    Στιγμιότυπο οθόνης των ρυθμίσεων ελέγχου ταυτότητας ενός παράγοντα, που εμφανίζει ότι δεν έχει επιλεγεί έλεγχος ταυτότητας.

  4. Λάβετε τη συμβολοσειρά σύνδεσης.

    Για να λάβετε τη συμβολοσειρά σύνδεσης για τον πράκτορά σας στο Copilot Studio, επιλέξτε εφαρμογή Web ή Εγγενής εφαρμογή στη σελίδα Κανάλια . Επιλέξτε Αντιγραφή δίπλα στη συμβολοσειρά σύνδεσης στην περιοχή Microsoft 365 Agents SDK. Χρησιμοποιήστε αυτήν τη συμβολοσειρά για να συνδεθείτε σε αυτόν τον παράγοντα από τον κώδικα web ή την εγγενή εφαρμογή σας.

    Στιγμιότυπο οθόνης της σελίδας καναλιών του Copilot Studio.

    Στιγμιότυπο οθόνης του πίνακα καναλιού εφαρμογής Web στο Copilot Studio.

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

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

    Επιλέξτε Ρυθμίσεις>για προχωρημένους. Στην περιοχή Μετα-δεδομένα, χρειάζεστε το αναγνωριστικό περιβάλλοντος, το αναγνωριστικό μισθωτή και το όνομα σχήματος. Καταγράψτε αυτές τις τιμές μετα-δεδομένων για αργότερα.

    Στιγμιότυπο οθόνης της σελίδας σύνθετων ρυθμίσεων για έναν πράκτορα στο Copilot Studio.

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

    Η εφαρμογή web ή η εγγενής εφαρμογή σας πρέπει να έχει μια καταχώρηση εφαρμογής στο Azure. Εάν δεν έχετε μια καταχώρηση εφαρμογής στο Azure, μπορείτε να ακολουθήσετε τον πλήρη οδηγό για τη ρύθμιση μίας χρησιμοποιώντας το Readme ή την τεκμηρίωση του Azure. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Καταχώρηση εφαρμογής στο Microsoft Entra ID.

    Σημείωμα

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

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

  1. Μεταβείτε στο δικαίωμα >APIΠροσθήκη δικαιωμάτων, επιλέξτε API που χρησιμοποιεί ο οργανισμός μου και κάντε αναζήτηση για Power Platform API.

  2. Επιλέξτε δικαιώματα >με ανάθεσηCopilot Studio>Copilot Studio.Copilots.Κλήση δικαιωμάτων. Επιλέξτε Προσθήκη δικαιωμάτων.

Για είσοδο από τον χρήστη, μπορείτε να ελέγξετε το δείγμα εργασίας με την καταχώρηση της εφαρμογής και τον παράγοντα Copilot Studio, ως εξής:

Προσθήκη της συμβολοσειράς σύνδεσης στις ρυθμίσεις προγράμματος-πελάτη Copilot Studio στο αρχείο appsettings.config :

  • DirectConnectUrl
  • TenantID:
  • ClientID:
  • ClientSecret:

Προσθήκη των ρυθμίσεων προγράμματος-πελάτη Copilot Studio στο αρχείο appsettings.config :

  • EnvironmentID:
  • SchemaName:
  • TenantID:
  • AppClientID:
  • AppClientSecret:

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

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

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

  1. Στην καταχώρηση της εφαρμογής σας, μεταβείτε στο δικαίωμα API, προσθέστε δικαιώματα, επιλέξτε API που χρησιμοποιεί ο οργανισμός μου και κάντε αναζήτηση για Power Platform API.
  2. Επιλέξτε Δικαιώματα εφαρμογής>Copilot Studio και ελέγξτε το δικαίωμα Copilot Studio.Copilots.Invoke .
  3. Επιλέξτε Προσθήκη δικαιωμάτων.

Για είσοδο από τον χρήστη, μπορείτε να ελέγξετε το δείγμα εργασίας με την καταχώρηση της εφαρμογής και τον παράγοντα Copilot Studio, ως εξής:

  1. Προσθήκη της συμβολοσειράς σύνδεσης στις ρυθμίσεις προγράμματος-πελάτη Copilot Studio στο αρχείο appsettings.config :

    • DirectConnectUrl
    • TenantID:
    • UseS2SConnection: true
    • ClientID:
    • ClientSecret:

  2. Προσθήκη των ρυθμίσεων προγράμματος-πελάτη Copilot Studio στο αρχείο appsettings.config :

    • EnvironmentID:
    • SchemaName:
    • TenantID:
    • UseS2SConnection: true
    • AppClientID:
    • AppClientSecret:

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

Ενσωματώστε το πρόγραμμα-πελάτη Copilot Studio στο υπάρχον περιβάλλον εργασίας χρήστη/UX

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

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

  1. Αναφορά της βιβλιοθήκης στην εφαρμογή σας.
  2. Υλοποιήστε αντικείμενα και μεθόδους από τη βιβλιοθήκη προγράμματος-πελάτη στο έργο σας.
  3. Έγχυση με DI ή διαχείριση του πελάτη με βάση τον υπάρχοντα σχεδιασμό της εφαρμογής σας, διασφαλίζοντας ότι αναφέρετε τις ρυθμίσεις της εφαρμογής για τις λεπτομέρειες διαμόρφωσης για τον παράγοντα.

Χρησιμοποιήστε τον προεπιλεγμένο κώδικα ενσωμάτωσης συνομιλίας Web (χωρίς ανάπτυξη/κώδικα)

Μπορείτε να προσθέσετε τον παράγοντα Copilot Studio στην τοποθεσία web σας χρησιμοποιώντας ένα iFrame, με δυνατότητα ενσωμάτωσης στον ΚΏΔΙΚΑ HTML της τοποθεσίας Web/εφαρμογής web.

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

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

Χρήση DirectLine για σύνδεση στο Copilot Studio

Ανατρέξτε στο θέμα Δημοσίευση παράγοντα σε κινητές συσκευές ή προσαρμοσμένες εφαρμογές για χρήση της DirectLine για ενσωμάτωση με τον παράγοντα Copilot Studio.