Παράγοντας 365 CLI

Σημαντικό

Πρέπει να είστε μέρος του προγράμματος προεπισκόπησης Σύνορα για να αποκτήσετε πρώιμη πρόσβαση στον Παράγοντα Microsoft 365. Η Frontier σάς συνδέει απευθείας με τις τελευταίες καινοτομίες τεχνητής νοημοσύνης της Microsoft. Οι προεπισκοπήσεις για τα σύνορα υπόκεινται στους υφιστάμενους όρους προεπισκόπησης των συμβάσεων πελατών σας. Καθώς αυτές οι δυνατότητες είναι ακόμα σε εξέλιξη, η διαθεσιμότητά τους και οι δυνατότητές τους ενδέχεται να αλλάξουν με την πάροδο του χρόνου.

Ο παράγοντας 365 CLI είναι ένα εργαλείο γραμμής εντολών μεταξύ πλατφορμών για την ανάπτυξη και τη διαχείριση εφαρμογών του παράγοντα 365 στο Azure.

Εγκατάσταση του παράγοντα 365 CLI

Ακολουθήστε τα παρακάτω βήματα για να εγκαταστήσετε το Agent 365 CLI καθολικά στο λειτουργικό σας σύστημα.

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

Πρέπει να έχετε εγκατεστημένο το .NET. (Συνιστάται.NET 8.0.)

Εγκατάσταση του .NET στα Windows

Linux

Εγκατάσταση του .NET σε Linux

macOS

Εγκατάσταση του .NET σε macOS

Χρήση εγκατάστασης του εργαλείου dotnet

Εγκαταστήστε το Agent 365 CLI χρησιμοποιώντας την ακόλουθη εντολή:

dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli

Εάν λάβετε ένα microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json σφάλμα, χρησιμοποιήστε την --prerelease παράμετρο, καθώς αυτό το πακέτο μπορεί να εξακολουθεί να έχει επισημανθεί ως προέκληση.

dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease

Για τις τελευταίες οδηγίες και τις διαθέσιμες εκδόσεις, επισκεφθείτε την επίσημη σελίδα NuGet: Microsoft.Agents.A365.DevTools.Cli στο NuGet.org

Επαλήθευση εγκατάστασης

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

a365 -h

Αυτή η εντολή εμφανίζει τις πληροφορίες βοήθειας και επιβεβαιώνει ότι η CLI είναι έτοιμη για χρήση.

Update

Ενημερώστε τον παράγοντα 365 CLI χρησιμοποιώντας την εντολή ενημέρωσης εργαλείου dotnet:

dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli

Σημείωμα

Όλες οι ενημερώσεις για το Agent 365 CLI απαιτούν σύνδεση στο Internet για πρόσβαση στο τελευταίο πακέτο Nuget: Microsoft.Agents.A365.DevTools.Cli

Κατάργηση εγκατάστασης του

Καταργήστε την εγκατάσταση του Παράγοντα 365 CLI χρησιμοποιώντας την εντολή κατάργησης εγκατάστασης του εργαλείου dotnet:

dotnet tool uninstall --global Microsoft.Agents.A365.DevTools.Cli

Θέση αρχείων

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

OS	Διαδρομή
Linux/macOS	$HOME/.dotnet/tools
Windows	%USERPROFILE%\.dotnet\tools

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

Η πρόσβαση στο εργαλείο είναι συγκεκριμένη για τον χρήστη, όχι καθολική στον υπολογιστή. Ένα καθολικό εργαλείο είναι διαθέσιμο μόνο στον χρήστη που εγκατέστησε το εργαλείο.

Διαθέσιμες εντολές

Για την πλήρη λίστα των διαθέσιμων εντολών, χρησιμοποιήστε την εντολή ή ανατρέξτε στο --help θέμα Αναφορά CLI παράγοντα 365

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

Αυτή η ενότητα περιέχει πληροφορίες σχετικά με τον τρόπο αντιμετώπισης προβλημάτων σφαλμάτων με τον Παράγοντα 365 CLI.

Αποτυχία εγκατάστασης, ενημέρωσης ή κατάργησης εγκατάστασης CLI με Not found in NuGet feeds

Εάν λάβετε ένα microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json σφάλμα, χρησιμοποιήστε την --prerelease παράμετρο, καθώς αυτό το πακέτο μπορεί να εξακολουθεί να έχει επισημανθεί ως προέκληση.

Για τις τελευταίες οδηγίες και τις διαθέσιμες εκδόσεις, επισκεφθείτε την επίσημη σελίδα NuGet: Microsoft.Agents.A365.DevTools.Cli στο NuGet.org

Η εγκατάσταση αποτυγχάνει με Authorization_RequestDenied σφάλμα

Εάν λάβετε ένα Authorization_RequestDenied σφάλμα κατά την εκτέλεση setup της εντολής, αυτό υποδεικνύει ένα ζήτημα δικαιωμάτων στο περιβάλλον σας Microsoft Entra.

Συνήθεις αιτίες

Αυτό το σφάλμα παρουσιάζεται συνήθως όταν:

• Ο λογαριασμός σας δεν διαθέτει τα απαιτούμενα δικαιώματα
• Η εφαρμογή Εργαλεία γραμμής εντολών του Microsoft Graph απαιτεί συγκατάθεση διαχειριστή
• Στο περιβάλλον σας υπάρχουν δικαιώματα που βρίσκονται σε διένεξη ή για τα δικαιώματα που δεν είναι σε διένεξη

Βήματα ανάλυσης

1. Επαληθεύστε ότι ο λογαριασμός σας έχει τον απαιτούμενο ρόλο

   Βεβαιωθείτε ότι έχετε εισέλθει με έναν λογαριασμό που έχει έναν από αυτούς τους ρόλους:

   • Αναγνωριστικό παράγοντα προγραμματιστή
   • Διαχειριστής αναγνωριστικού παράγοντα
   • Καθολικός διαχειριστής

2. Αναθεώρηση και εκχώρηση συγκατάθεσης διαχειριστή για τα Εργαλεία γραμμής εντολών του Microsoft Graph

   Η εντολή εγκατάστασης a365 χρησιμοποιεί την εφαρμογή Εργαλεία γραμμής εντολών του Microsoft Graph, η οποία μπορεί να έχει δικαιώματα σε διένεξη.

   Για να εξετάσετε και να διορθώσετε:

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

   2. Πραγματοποιήστε αναζήτηση για Εργαλεία γραμμής εντολών του Microsoft Graph ή αναζητήστε το Αναγνωριστικό εφαρμογής: 14d82eec-204b-4c2f-b7e8-296a70dab67e

   3. Επιλέξτε Δικαιώματα ασφαλείας>από την περιοχή περιήγησης.

   4. Αναζητήστε το Directory.AccessAsUser.All δικαίωμα

      • Αυτό το προνομιακό δικαίωμα παρεμβάλλεται στη δημιουργία σχεδίου
      • Εάν υπάρχει, εξετάστε το ενδεχόμενο να την καταργήσετε ή να την αντικαταστήσετε με εναλλακτικές με ελάχιστα δικαιώματα, όπως Directory.Read.All

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

      Καταργήστε αυτό το δικαίωμα μόνο εάν είστε βέβαιοι ότι δεν απαιτείται από άλλα εργαλεία ή δέσμες ενεργειών στο περιβάλλον σας

   5. Εάν η συγκατάθεση διαχειριστή δεν έχει ήδη εκχωρηθεί, επιλέξτε Εκχώρηση συγκατάθεσης διαχειριστή για [τον μισθωτή σας].

3. Μετά την πραγματοποίηση αλλαγών, εκτελέστε a365 setup ξανά

Πρόσθετοι πόροι

Για περισσότερες πληροφορίες σχετικά με αυτό το γνωστό ζήτημα, ανατρέξτε στο θέμα Γνωστά ζητήματα αναγνωριστικού παράγοντα της Microsoft - Directory.AccessAsUser.All προκαλεί την παράβλεψη άλλων δικαιωμάτων.