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


Μη αυτόματη ανάπτυξη του παράγοντα στο Azure

Η εκτέλεση ενός παράγοντα SDK παραγόντων Microsoft 365 στο Azure απαιτεί τα παρακάτω βήματα:

Αυτό το έγγραφο καλύπτει την ανάπτυξη ενός παράγοντα που δημιουργήσατε στο Azure και το Teams ή το Microsoft 365 Copilot.

Εάν δεν έχετε δημιουργήσει έναν παράγοντα ακόμα, ξεκινήστε με τον Οδηγό γρήγορης εκκίνησης: Δημιουργήστε και δοκιμάστε έναν βασικό παράγοντα χρησιμοποιώντας C#.

Δημοσίευση του παράγοντά σας σε μια εφαρμογή web

Ένας παράγοντας SDK είναι μια εφαρμογή Web. Για να δημοσιεύσετε τον παράγοντά σας, μπορείτε να χρησιμοποιήσετε τις μεθόδους που θα χρησιμοποιούσατε κανονικά για την ανάπτυξη μιας εφαρμογής Web στο Azure:

  • Ανάπτυξη ως πακέτου ZIP σε μια εφαρμογή υπηρεσίας εφαρμογής Azure
  • Visual Studio δημοσίευση σε μια εφαρμογή ή κοντέινερ υπηρεσίας εφαρμογής Azure
  • Άλλες αναπτύξεις κοντέινερ που υποστηρίζονται από το Azure
  • Ανάπτυξη κιτ εργαλείων παραγόντων Microsoft 365

Σημαντικό

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

Μετά την ανάπτυξη του κωδικού παράγοντα, διαθέτει μια διεύθυνση URL βάσης όπως example.azurewebsites.net.

Στο Azure, μεταβείτε στον πόρο σας Azure Bot. Κάτω από τη Ρύθμιση παραμέτρων, αλλάξτε το τελικό σημείο ανταλλαγής μηνυμάτων σε https://{yourwebsite}/api/messages. Αντικαταστήστε το {yourwebsite} με τη βασική διεύθυνση URL της εφαρμογής σας web.

Δοκιμή στη συνομιλία Web

Για να δείτε το μήνυμά σας στη συνομιλία web, επιλέξτε Δοκιμή στη Web Συνομιλία στον πόρο σας Azure Bot και στείλτε μηνύματα στον παράγοντά σας.

Προετοιμασία του δηλωτικού Teams και Microsoft 365 Copilot

Για το Microsoft Teams και το Microsoft 365 Copilot, πρέπει να δημιουργήσετε και να αποστείλετε ένα δηλωτικό. Δεν είναι δυνατή η παροχή ενός παραδείγματος δηλωτικού που καλύπτει όλες τις ανάγκες του Teams ή του Microsoft 365 Copilot. Οι δυνατότητες του Teams απαιτούν συγκεκριμένο περιεχόμενο δηλωτικού.

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

  1. Δημιουργήστε έναν κενό φάκελο στο έργο σας.
  2. Αντιγράψτε τα περιεχόμενα των αρχείων δηλωτικού Teams στον φάκελο.
  3. Στον φάκελο, ανοίξτε το manifest.json και κάντε τις ακόλουθες αλλαγές:
    • Όπου βλέπετε τη συμβολοσειρά χαρακτήρα κράτησης θέσης <<AAD_APP_CLIENT_ID>>, αντικαταστήστε με ClientId για τον πόρο Azure Bot.
    • Αντικαταστήστε το <<BOT_DOMAIN>> με τη διεύθυνση URL βάσης του παράγοντα σας.
    • Συμπιέστε τα περιεχόμενα του φακέλου για να δημιουργήσετε ένα manifest.zip με τα περιεχόμενα:
      • manifest.json
      • outline.png
      • color.png

Ανάπτυξη στο Microsoft 365

  1. Στον πόρο σας Azure Bot θα πρέπει να έχει προστεθεί το κανάλι Microsoft Teams στην περιοχή Κανάλια.

  2. Μεταβείτε στην Πύλη διαχείρισης της Microsoft (MAC). Στην περιοχή Ρυθμίσεις και Ενσωματωμένες εφαρμογές επιλέξτε Αποστολή προσαρμοσμένης εφαρμογής.

  3. Επιλέξτε το manifest.zip που δημιουργήθηκε στην προηγούμενη ενότητα και αποστείλετε το αρχείο.

Μετά από ένα σύντομο χρονικό διάστημα, ο παράγοντας εμφανίζεται στο Microsoft Teams και το Microsoft 365 Copilot.