Αναφορά εντολών CLI develop παράγοντα 365

Διαχειριστείτε διακομιστές εργαλείων MCP για την ανάπτυξη αντιπροσώπων. Η develop εντολή παρέχει επιλογές για τη διαχείριση διακομιστών εργαλείων MCP (Πρωτόκολλο περιβάλλοντος μοντέλου) για την ανάπτυξη αντιπροσώπων. Μπορείτε να παραθέσετε διαθέσιμους διακομιστές, να προβάλετε ρυθμισμένους διακομιστές και να προσθέσετε ή να καταργήσετε διακομιστές MCP από τη ρύθμιση παραμέτρων του παράγοντα.

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

Syntax

a365 develop [command] [options]

Options

Option Description
-v, --verbose Ενεργοποίηση λεπτομερούς καταγραφής
-?, -h, --help Εμφάνιση πληροφοριών βοήθειας και χρήσης.

develop list-available

Παραθέστε όλους τους διακομιστές MCP που είναι διαθέσιμοι στον κατάλογο (τι μπορείτε να εγκαταστήσετε).

a365 develop list-available [options]

Αυτή η εντολή εμφανίζει όλους τους διακομιστές MCP που είναι διαθέσιμοι στον κατάλογο και μπορείτε να τους εγκαταστήσετε για χρήση με την ανάπτυξη του παράγοντα.

list-available επιλογές

Option Description
--dry-run Εμφανίστε τι θα έκανε η εντολή χωρίς να την εκτελέσετε.
--skip-auth Skip authentication. Μόνο για δοκιμή. Η εντολή πιθανώς αποτυγχάνει χωρίς έγκυρο έλεγχο ταυτότητας.
-?, -h, --help Εμφάνιση πληροφοριών βοήθειας και χρήσης.

Note

develop list-available δεν απαιτεί a365.config.json. Διαβάζει το περιβάλλον από τη μεταβλητή A365_ENVIRONMENT περιβάλλοντος (προεπιλογή ).prod

develop list-configured

Λίστα διακομιστών MCP που έχουν ρυθμιστεί τη συγκεκριμένη στιγμή από την τοπική ToolingManifest.jsonσας .

a365 develop list-configured [options]

Αυτή η εντολή εμφανίζει όλους τους διακομιστές MCP που έχετε ρυθμίσει αυτήν τη στιγμή στο τοπικό αρχείο ToolingManifest.json.

list-configured επιλογές

Option Description
--project-path <path> Διαδρομή προς τον κατάλογο έργου πράκτορα που περιέχει ToolingManifest.json. Παρακάμψεις DeploymentProjectPath από a365.config.json.
--dry-run Εμφανίστε τι θα έκανε η εντολή χωρίς να την εκτελέσετε.
-?, -h, --help Εμφάνιση πληροφοριών βοήθειας και χρήσης.

develop add-mcp-servers

Προσθέστε διακομιστές MCP στην τρέχουσα ρύθμιση παραμέτρων του παράγοντα.

a365 develop add-mcp-servers [<servers>...] [options]

Αυτή η εντολή προσθέτει τους καθορισμένους διακομιστές ToolingManifest.json MCP στον φάκελο του έργου σας. Δεν εκχωρεί δικαιώματα στο σχέδιο πράκτορα.

Important

Αυτή η εντολή ενημερώνεται ToolingManifest.json μόνο - δεν εκχωρεί δικαιώματα στο σχέδιο παράγοντα. Ο τρόπος με τον οποίο εφαρμόζετε τα δικαιώματα εξαρτάται από το πού βρίσκεστε στη διαδικασία εγκατάστασης:

  • Πριν από την αρχική ρύθμιση: Συνεχίστε με a365 setup allτο . Τα δικαιώματα MCP εφαρμόζονται ως μέρος της αρχικής δημιουργίας σχεδίου.
  • Αφού εμφανιστεί ήδη το σχέδιο: Ένας καθολικός διαχειριστής πρέπει να εκτελεστεί a365 setup permissions mcp ξεχωριστά. Ο διαχειριστής πρέπει να επαληθεύσει ότι deploymentProjectPath οδηγεί στο φάκελο του έργου που περιέχει το ενημερωμένο ToolingManifest.jsonαρχείο .

add-mcp-servers Επιχειρήματα

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

Argument Description
<servers> Τα ονόματα των διακομιστών MCP που θα προστεθούν

add-mcp-servers επιλογές

Χρησιμοποιήστε αυτές τις επιλογές για να προσαρμόσετε τη συμπεριφορά της εντολής add-mcp-servers .

Option Description
--project-path <path> Διαδρομή προς τον κατάλογο έργου πράκτορα που περιέχει ToolingManifest.json. Παρακάμψεις DeploymentProjectPath από a365.config.json.
--dry-run Εμφανίστε τι θα έκανε η εντολή χωρίς να την εκτελέσετε.
-?, -h, --help Εμφάνιση πληροφοριών βοήθειας και χρήσης.

develop remove-mcp-servers

Καταργήστε τους διακομιστές MCP από την τρέχουσα ρύθμιση παραμέτρων του παράγοντα.

a365 develop remove-mcp-servers [<servers>...] [options]

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

remove-mcp-servers Επιχειρήματα

Argument Description
<servers> Τα ονόματα των διακομιστών MCP προς κατάργηση

remove-mcp-servers επιλογές

Option Description
--project-path <path> Διαδρομή προς τον κατάλογο έργου πράκτορα που περιέχει ToolingManifest.json. Παρακάμψεις DeploymentProjectPath από a365.config.json.
--dry-run Εμφανίστε τι θα έκανε η εντολή χωρίς να την εκτελέσετε.
-?, -h, --help Εμφάνιση πληροφοριών βοήθειας και χρήσης.

develop add-permissions

Προσθέστε δικαιώματα API διακομιστή MCP για να Microsoft Entra εφαρμογές για σενάρια ανάπτυξης όπου χρειάζεται να ρυθμίσετε προσαρμοσμένες εφαρμογές για πρόσβαση σε διακομιστές MCP.

a365 develop add-permissions [options]

add-permissions επιλογές

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

Option Description
-m, --manifest <manifest> Διαδρομή προς ToolingManifest.json (προεπιλογή: <deploymentProjectPath>/ToolingManifest.json)
--app-id <app-id> Αναγνωριστικό εφαρμογής (πρόγραμμα-πελάτης) για την προσθήκη δικαιωμάτων στο (προεπιλογή: clientAppId από τη ρύθμιση παραμέτρων)
--scopes <scopes> Συγκεκριμένες εμβέλειες για προσθήκη (διαχωρισμένες με κενό διάστημα) (προεπιλογή: Όλες οι εμβέλειες από ToolingManifest.jsonτο )
--dry-run Εμφάνιση του τι θα έκανε η εντολή χωρίς αλλαγές
-v, --verbose Εμφάνιση λεπτομερούς εξόδου
-?, -h, --help Εμφάνιση πληροφοριών βοήθειας και χρήσης.

Important

Η εφαρμογή που καθορίζεται από το ή το πρέπει να έχει το δικαίωμα /> a365 setup permissions mcp αντί για αυτό.

develop get-token

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

a365 develop get-token [options]

get-token επιλογές

Χρησιμοποιήστε αυτές τις επιλογές για να ζητήσετε ένα διακριτικό πρόσβασης, εμβέλειες ελέγχου, συμπεριφορά ανανέωσης και να επιλέξετε τη μορφή εξόδου.

Option Description
--app-id <app-id> Αναγνωριστικό εφαρμογής (πρόγραμμα-πελάτης) για έλεγχο ταυτότητας (προεπιλογή: clientAppId από τις παραμέτρους)
-m, --manifest <manifest> Διαδρομή προς ToolingManifest.json (προεπιλογή: <deploymentProjectPath>/ToolingManifest.json)
--scopes <scopes> Συγκεκριμένες εμβέλειες για αίτηση (διαχωρισμένες με κενό διάστημα) (προεπιλογή: Ανάγνωση από ToolingManifest.json)
-o, --output <output> Μορφή εξόδου: table, jsonή raw (προεπιλογή: table)
--force-refresh Επιβολή παράκαμψης του cache ανανέωσης διακριτικού
--resource <resource> Λέξη-κλειδί πόρου για λήψη διακριτικού για: mcp (προεπιλογή) ή powerplatform
--resource-id <resource-id> Αναγνωριστικό εφαρμογής προσαρμοσμένου πόρου (GUID) για πόρους που δεν καλύπτονται από --resource λέξεις-κλειδιά
-v, --verbose Εμφάνιση λεπτομερούς εξόδου, συμπεριλαμβανομένου του πλήρους διακριτικού
-?, -h, --help Εμφάνιση πληροφοριών βοήθειας και χρήσης.

get-token επιλογές πόρων

Χρησιμοποιήστε τις επιλογές --resource και --resource-id για να λάβετε διακριτικά για διαφορετικούς πόρους Azure:

  • --resource: Χρησιμοποιήστε μια λέξη-κλειδί για να επιλέξετε έναν προκαθορισμένο πόρο:
    • mcp (προεπιλογή): Εργαλεία παράγοντα 365 για διακομιστές MCP
    • powerplatform: API Power Platform
  • --resource-id: Εισαγάγετε ένα αναγνωριστικό εφαρμογής προσαρμοσμένου πόρου (GUID) για πόρους που δεν καλύπτονται από λέξεις-κλειδιά

Important

Δεν μπορείτε να χρησιμοποιήσετε --resource και --resource-id μαζί. Όταν χρησιμοποιείτε οποιαδήποτε από τις δύο επιλογές, συμπεριλάβετε --scopesτο . Μόνο η προεπιλεγμένη ροή MCP υποστηρίζει ανάλυση εμβέλειας βάσει διακήρυξης.

develop start-mock-tooling-server

Ξεκινήστε έναν ψεύτικο διακομιστή εργαλείων για σκοπούς δοκιμής και ανάπτυξης.

a365 develop start-mock-tooling-server [options]

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

start-mock-tooling-server επιλογές

Χρησιμοποιήστε αυτές τις επιλογές για να προσαρμόσετε τη συμπεριφορά της εντολής start-mock-tooling-server .

Option Description Default
-p, --port <port> Αριθμός θύρας για τον ψεύτικο διακομιστή 5309
-v, --verbose Ενεργοποίηση λεπτομερούς καταγραφής false
-?, -h, --help Εμφάνιση πληροφοριών βοήθειας και χρήσης -
-bg Εκτέλεση του διακομιστή σε ένα νέο τερματικό -