Δημοσίευση παράγοντα στο κέντρο διαχείρισης της Microsoft

Χρησιμοποιήστε την εντολή a365 publish για να συσκευάσετε τον παράγοντα σας και στη συνέχεια ανεβάστε το πακέτο στο Κέντρο διαχείρισης Microsoft 365. Μετά τη δημοσίευση, μπορείτε να δημιουργήσετε παραδείγματα παράγοντα εντός του οργανισμού σας και να διαχειριστείτε τον παράγοντα.

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

Προτού ξεκινήσετε, βεβαιωθείτε ότι έχετε τα παρακάτω στοιχεία.

Απαιτούμενοι λογαριασμοί και δικαιώματα

  • Microsoft 365 tenant με έναν από τους παρακάτω ρόλους (απαιτείται για το βήμα μεταφόρτωσης στο Κέντρο διαχείρισης):

    • Καθολικός διαχειριστής

Απαιτούμενα εργαλεία

Απαιτούμενα βήματα ρύθμισης

Πριν από τη δημοσίευση, ολοκληρώστε τα εξής βήματα:

  1. Δημιουργία blueprint παράγοντα - Ακολουθήστε το βήμα ρύθμισης για να δημιουργήσετε το blueprint παράγοντα σας.
  2. Δοκιμάστε τον παράγοντα τοπικά – Επαληθεύστε ότι ο παράγοντάς σας λειτουργεί σωστά χρησιμοποιώντας το Agents Playground (δείτε Test agents locally).
  3. Προετοιμάστε τα αρχεία διαμόρφωσης - Εξασφαλίστε ότι a365.config.json και a365.generated.config.json είναι ενημερωμένα.

Εντολή δημοσίευσης

Εκτέλεση της a365 publishεντολής:

a365 publish

Σημείωμα

Η εκτέλεση a365 publish -h εμφανίζει όλες τις επιλογές που υποστηρίζει αυτή η εντολή.

Τι κάνει αυτή η εντολή:

  1. Ενημέρωση μανιφέστου - Ενημερώνει το αρχείο μανιφέστουmanifest.json με το αναγνωριστικό σχεδιαγράμματος του παράγοντα σας.
  2. Δημιουργία πακέτου - Πακέτα manifest.json και εικονίδια σε manifest.zip.
  3. Εκτύπωση οδηγιών - Προβάλλει αναλυτικές οδηγίες βήμα προς βήμα για τη μεταφόρτωση μέσω του Κέντρο διαχείρισης Microsoft 365.

Σημείωμα

Η εντολή a365 publish λειτουργεί τόσο για παράγοντες όσο και για συνεργάτες AI. Για τους παράγοντες που παρέχονται με χρήση --agent-name (χωρίς διαμόρφωση), βεβαιωθείτε ότι το a365.generated.config.json υπάρχει στον κατάλογο εργασίας σας πριν εκτελέσετε το a365 publish, καθώς η εντολή διαβάζει το αναγνωριστικό Blueprint από αυτό το αρχείο.

Αποστολή στο κέντρο διαχείρισης

Μόλις ολοκληρωθεί το a365 publish, ακολουθήστε τις οδηγίες που εμφανίζονται στην οθόνη για να μεταφορτώσετε τον παράγοντα σας:

  1. Μεταβείτε στο Κέντρο διαχείρισης του Microsoft 365.
  2. Μεταβείτε στους Παράγοντες>Όλοι οι παράγοντες.
  3. Επιλέξτε Αποστολή σε προσαρμοσμένο παράγοντα.
  4. Ανεβάστε το manifest.zip αρχείο από το φάκελο manifest του έργου σας.

Για περισσότερες πληροφορίες, δείτε την ενότητα Αποστολή παραγόντων στο Κέντρο διαχείρισης Microsoft 365.

Επαλήθευση επιτυχούς δημοσίευσης

Χρησιμοποιήστε την παρακάτω λίστα ελέγχου για να επαληθεύσετε ότι ο παράγοντας σας δημοσιεύτηκε με επιτυχία:

✅ Η δημοσίευση μέσω CLI ολοκληρώθηκε με επιτυχία
✅ manifest Ο φάκελος δημιουργήθηκε με manifest.json και manifest.zip
✅ Ο παράγοντας εμφανίζεται στο κέντρο διαχείρισης της Microsoft

Έξοδος CLI

Βλέπετε αυτά τα μηνύματα εξόδου όταν η εντολή δημοσίευσης ολοκληρώνεται με επιτυχία:

✅ Manifest updated successfully
✅ manifest.zip created successfully
✅ Εκτυπώθηκαν οδηγίες μεταφόρτωσης βήμα προς βήμα

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

Πιθανά σφάλματα:

Error Βήμα για επίλυση
Agent blueprint ID not found Εκτελέστε a365 setup για να ολοκληρώσετε τη ρύθμιση του σχεδιαγράμματος.
Permissions missing Εκτελέστε ξανά το πρόγραμμα εγκατάστασης με την a365 setup permissions εντολή.

Ακολουθήστε αυτά τα βήματα όταν αποτύχει η δημοσίευση.

Αρχεία δηλωτικού

Μπορείτε να ελέγξετε τα παρακάτω αρχεία στον φάκελο manifest χρησιμοποιώντας την εντολή PowerShell Test-Path.

# Check manifest folder and contents exists
Test-Path <deploymentProjectPath>/manifest/
Test-Path <deploymentProjectPath>/manifest/manifest.json
Test-Path <deploymentProjectPath>/manifest/manifest.zip
# All should return: True

Σημείωμα

Εάν δεν βλέπετε αυτά τα αρχεία, δοκιμάστε να εκτελέσετε την a365 publishεντολή ξανά.

Ο παράγοντας εμφανίζεται στο κέντρο διαχείρισης

Σημείωμα

Μετά τη μεταφόρτωση, μπορεί να χρειαστούν 5-10 λεπτά για να εμφανιστεί ο παράγοντας σας στο κέντρο διαχείρισης και στο Teams. Αυτή η καθυστέρηση είναι φυσιολογική.

Επιβεβαιώστε ότι ο παράγοντας εμφανίζεται ακολουθώντας τα εξής βήματα:

  1. Μεταβείτε στο Κέντρο διαχείρισης του Microsoft 365.
  2. Μεταβείτε στους Παράγοντες>Όλοι οι παράγοντες.
  3. Ο παράγοντας σας εμφανίζεται στη λίστα.

Ο παρακάτω πίνακας δείχνει τις λεπτομέρειες που μπορείτε να βρείτε:

Πεδίο Τι να ελέγξετε
Όνομα Το όνομα του παράγοντα σας (από manifest.json)
Έκδοση Αριθμός έκδοσης (για παράδειγμα, 1.0.0)
Εκδότης Το όνομα του οργανισμού σας
Διαθεσιμότητα Διαθέσιμοι/Όλοι οι χρήστες

Δείτε επίσης

Επόμενα βήματα

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

Δημιουργία στιγμιότυπου παράγοντα

Αντιμετώπιση προβλημάτων

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

Φιλοδώρημα

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

Η δημοσίευσης εντολής αποτυγχάνει

Συμπτώματα:

  • Σφάλμα κατά τη διάρκεια a365 publish
  • manifest.zip δεν έχει δημιουργηθεί

Βασικές αιτίες:

  • Η εγκατάσταση δεν ολοκληρώθηκε
  • Σφάλματα επικύρωσης manifest
  • Ανεπαρκή δικαιώματα

Λύση:

  1. Βεβαιωθείτε ότι η εγκατάσταση έχει ολοκληρωθεί.

    Get-Content a365.generated.config.json | ConvertFrom-Json | Select-Object agentBlueprintId

  2. Εκτελέστε την εντολή δημοσίευσης και ακολουθήστε τις οδηγίες.

Η μεταφόρτωση αποτυγχάνει στο κέντρο διαχείρισης

Συμπτώματα:

  • Σφάλμα κατά την αποστολή manifest.zip στο Κέντρο διαχείρισης Microsoft 365
  • Ο παράγοντας δεν εμφανίζεται μετά την αποστολή

Βασικές αιτίες:

  • Ανεπαρκή δικαιώματα στο κέντρο διαχείρισης
  • Μη έγκυρο ή ξεπερασμένο manifest.zip

Λύση:

  1. Βεβαιωθείτε ότι έχετε τον ρόλο του καθολικού διαχειριστή.
  2. Εκτελέστε ξανά το a365 publish για να δημιουργήσετε ένα νέο manifest.zip.
  3. Δοκιμάστε να ανεβάσετε ξανά ακολουθώντας τα βήματα μεταφόρτωσης.

Για περισσότερη βοήθεια, δείτε την ενότητα Αποστολή παραγόντων στο Κέντρο διαχείρισης Microsoft 365.

  • Last updated on