Agent 365 CLI

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

Δεν χρειάζεται εγκατάσταση του CLI χειροκίνητα. Η ρύθμιση με καθοδήγηση AI ελέγχει την ύπαρξη του CLI, το εγκαθιστά ή το ενημερώνει αυτόματα και εκτελεί όλες τις απαιτούμενες εντολές για λογαριασμό σας. Αυτή η σελίδα αποτελεί αναφορά για προγραμματιστές που χρειάζεται να εγκαταστήσουν ή να χρησιμοποιήσουν απευθείας το CLI — για παράδειγμα, κατά τη δημιουργία αυτοματισμού CI/CD, την αντιμετώπιση προβλημάτων σε ένα συγκεκριμένο βήμα ή όταν εργάζονται χωρίς παράγοντας AI για κωδικοποίηση.

Σημείωμα

Η πλήρης ροή εργασιών προγραμματιστή – συμπεριλαμβανομένης της ρύθμισης με καθοδήγηση από AI, της καθοδήγησης ρόλων και των βημάτων μετά την ανάπτυξη – θα τη βρείτε στην ενότητα Ξεκινήστε με την ανάπτυξη του Agent 365. Αυτή η σελίδα αποτελεί αναφορά για το CLI: εγκατάσταση, ενημέρωση, απεγκατάσταση, διαθέσιμες εντολές και αντιμετώπιση προβλημάτων.

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

Το CLI απαιτεί .NET 8.0 ή νεότερη έκδοση. Για όλες τις άλλες προϋποθέσεις - συνδρομή Azure, απαιτούμενοι ρόλοι Entra και προσαρμοσμένη καταχώρηση εφαρμογής προγράμματος-πελάτη - ανατρέξτε στο θέμα Ρύθμιση καθοδηγούμενη από AI.

Εγκαταστήστε το Agent 365 CLI

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

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

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

Εκτελέστε την εντολή dotnet tool install

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

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

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

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

Αφού εγκαταστήσετε το Agent 365 CLI, επαληθεύστε ότι έχει εγκατασταθεί σωστά εκτελώντας την εντολή --help:

a365 -h

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

Update

Ενημερώστε το Agent 365 CLI χρησιμοποιώντας την εντολή dotnet tool update:

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

Σημείωμα

Για να ενημερώσετε το Agent 365 CLI, χρειάζεστε σύνδεση στο Internet για να αποκτήσετε πρόσβαση στο πιο πρόσφατο πακέτο NuGet: Microsoft.Agents.A365.DevTools.Cli.

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

Απεγκαταστήστε το Agent 365 CLI χρησιμοποιώντας την εντολή dotnet tool uninstall:

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

Θέσεις αρχείων

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

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

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

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

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

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

Φιλοδώρημα

Δεν χρειάζεται να εκτελείτε εντολές CLI χειροκίνητα. Η AI-guided setup αυτοματοποιεί ολόκληρη τη ροή εργασίας – εγκατάσταση CLI, διαμόρφωση, ρύθμιση blueprint, ανάπτυξη και δημοσίευση – χρησιμοποιώντας έναν AI coding παράγοντα. Χρησιμοποιήστε την αναφορά CLI εδώ αν δημιουργείτε αυτοματισμό CI/CD, αντιμετωπίζετε πρόβλημα σε συγκεκριμένο βήμα ή εργάζεστε χωρίς παράγοντα κωδικοποίησης AI.

Για πλήρεις οδηγίες σχετικά με τον τρόπο ρύθμισης ενός παράγοντα Agent 365 χρησιμοποιώντας το CLI, ανατρέξτε στο θέμα Γρήγορα αποτελέσματα με την ανάπτυξη Agent 365.

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

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

Φιλοδώρημα

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

Ζητήματα CLI που καλύπτονται σε αυτήν την ενότητα:

Ο παράγοντας δεν εμφανίζεται στο Teams

Δημιουργία αντιμετώπισης προβλημάτων παρουσιών παράγοντα: Ο παράγοντας δεν εμφανίζεται στο Teams

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

Αντιμετώπιση προβλημάτων δημιουργίας παρουσιών παράγοντα: Δεν είναι δυνατή η δημιουργία παρουσίας παράγοντα στο Teams