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

Ρυθμίστε το περιβάλλον του Παράγοντα 365 με λεπτομερή έλεγχο σε κάθε βήμα. Αυτή η εντολή διαχειρίζεται την αρχική ροή εργασιών ρύθμισης για τον Παράγοντα 365.

απαιτείται ρόλος Minimum: Azure Συμβάλλων + Προγραμματιστής αναγνωριστικών

Note

Ο ρόλος που έχετε καθορίζει πόσο από τη ρύθμιση ολοκληρώνεται σε μία εκτέλεση. Ο καθολικός διαχειριστής μπορεί να ολοκληρώσει όλα τα βήματα ταυτόχρονα. Ο διαχειριστής αναγνωριστικού παράγοντα και ο προγραμματιστής αναγνωριστικού παράγοντα μπορούν να ολοκληρώσουν όλα τα βήματα εκτός από τις εκχωρήσεις δικαιωμάτων OAuth2 (συγκατάθεση διαχειριστή), οι οποίες απαιτούν ενέργεια από έναν καθολικό διαχειριστή. Όταν ολοκληρωθεί η εγκατάσταση, το CLI εκτυπώνει τα επόμενα βήματα για τον καθολικό διαχειριστή απευθείας στην έξοδο.

Syntax

a365 setup [command] [options]

Options

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

Προτεινόμενη εντολή εκτέλεσης

# 0. Check prerequisites (optional)
a365 setup requirements

# 1. Create blueprint
a365 setup blueprint

# 2. Configure MCP permissions
a365 setup permissions mcp

# 3. Configure bot permissions
a365 setup permissions bot

# 4. Configure CopilotStudio permissions (if needed)
a365 setup permissions copilotstudio

# 5. Configure custom permissions (if needed)
a365 setup permissions custom

Εναλλακτικά, εκτελέστε όλα τα βήματα ταυτόχρονα:

# Full setup using config file (a365.config.json)
a365 setup all

# Config-free: no a365.config.json needed
a365 setup all --agent-name "MyAgent"

Εάν εκτελείτε ως Διαχειριστής αναγνωριστικού παράγοντα ή Προγραμματιστής αναγνωριστικού παράγοντα (όχι καθολικός διαχειριστής), a365 setup all ολοκληρώνει όλα τα βήματα εκτός από τις εκχωρήσεις δικαιωμάτων OAuth2. Όταν ολοκληρωθεί, η έξοδος περιλαμβάνει τα επόμενα βήματα για έναν καθολικό διαχειριστή για να ολοκληρώσει τις επιχορηγήσεις — συμπεριλαμβανομένου ενός άμεσου συνδέσμου ή μιας διεύθυνσης URL συγκατάθεσης που μπορεί να ανοίξει.

`setup requirements`

Επικυρώστε τις προϋποθέσεις για τη ρύθμιση του Παράγοντα 365. Εκτελεί αρθρωτές ελέγχους απαιτήσεων και παρέχει οδηγίες για τυχόν προβλήματα που εντοπίζει.

a365 setup requirements [options]

Αυτή η εντολή εκτελεί τα παρακάτω βήματα:

Ελέγχει όλες τις προϋποθέσεις που απαιτούνται για τη ρύθμιση του Παράγοντα 365.
Αναφέρει τυχόν προβλήματα με λεπτομερείς οδηγίες επίλυσης.
Συνεχίζει να ελέγχει όλες τις απαιτήσεις, ακόμη και αν αποτύχουν ορισμένοι έλεγχοι.
Παρέχει μια σύνοψη όλων των ελέγχων στο τέλος.

Tip

Εάν είστε καθολικός διαχειριστής και η γνωστή Agent 365 CLI εφαρμογή προγράμματος-πελάτη δεν βρίσκεται στον μισθωτή σας, setup requirements σας ζητά να τη δημιουργήσετε αυτόματα. Εισαγάγετε ένα υπάρχον αναγνωριστικό εφαρμογής ή πληκτρολογήστε C για να δημιουργήσετε την εφαρμογή και εκχωρήστε τη συγκατάθεση διαχειριστή σε ένα μόνο βήμα - δεν απαιτείται μη αυτόματη εγγραφή στο Entra.

`requirements` επιλογές

Option	Description
`-v`, `--verbose`	Ενεργοποιήστε την λεπτομερή καταγραφή.
`--category <category>`	Εκτελέστε ελέγχους μόνο για μια συγκεκριμένη κατηγορία, όπως `Azure`, `Authentication`, `PowerShell` ή `Tenant Enrollment`.
`-?`, `-h`, `--help`	Εμφάνιση πληροφοριών βοήθειας και χρήσης.

Note

setup requirements δεν απαιτεί αρχείο διαμόρφωσης - εκτελέστε το σε οποιονδήποτε κατάλογο.

`setup blueprint`

Δημιουργία σχεδίου παράγοντα (Entra ID καταχώρηση εφαρμογής).

Ελάχιστα απαιτούμενα δικαιώματα: Ρόλος προγραμματιστή αναγνωριστικού παράγοντα

a365 setup blueprint [options]

`blueprint` επιλογές

Option	Description
`-n`, `--agent-name <name>`	Όνομα βάσης πράκτορα. Όταν παρέχετε αυτήν την επιλογή, δεν χρειάζεστε αρχείο ρυθμίσεων. Η εντολή εντοπίζει αυτόματα το αναγνωριστικό μισθωτή από `az account show`το . Παρακάμψτε το με `--tenant-id`.
`--tenant-id <tenantId>`	Azure αναγνωριστικό μισθωτή AD. Overrides auto-detection. Χρησιμοποιήστε το με `--agent-name`.
`-v`, `--verbose`	Εμφάνιση λεπτομερούς εξόδου.
`--dry-run`	Εμφανίστε τι θα έκανε η εντολή χωρίς να την εκτελέσετε.
`--skip-requirements`	Παράλειψη ελέγχου επικύρωσης απαιτήσεων. Χρησιμοποιήστε με προσοχή.
`--no-endpoint`	Μην καταχωρήσετε τελικό σημείο ανταλλαγής μηνυμάτων (μόνο σχέδιο).
`--endpoint-only`	Καταχώρηση μόνο τελικού σημείου ανταλλαγής μηνυμάτων. Απαιτεί υπάρχον σχέδιο.
`--update-endpoint <url>`	Διαγράψτε το υπάρχον τελικό σημείο ανταλλαγής μηνυμάτων και καταχωρήστε ένα νέο με την καθορισμένη διεύθυνση URL.
`--m365`	Αντιμετωπίστε αυτόν τον παράγοντα ως παράγοντα M365. Ενεργό , τίθεται σε `a365 setup blueprint`ισχύ μόνο με `--endpoint-only` ή `--update-endpoint`. Για να καταχωρήσετε το τελικό σημείο ανταλλαγής μηνυμάτων ως μέρος της πλήρους ρύθμισης, χρησιμοποιήστε `a365 setup all --m365`το . Η προεπιλογή είναι `false` (opt-in).
`--show-secret`	Εμφανίστε τον αποθηκευμένο μυστικό πελάτη σχεδιαγράμματος σε απλό κείμενο. Δεν εκτελούνται βήματα ρύθμισης. Στα Windows, απαιτείται ο ίδιος υπολογιστής και λογαριασμός χρήστη που εκτελέστηκε η εγκατάσταση.
`-?`, `-h`, `--help`	Εμφάνιση πληροφοριών βοήθειας και χρήσης.

`setup permissions`

Ρυθμίστε τις παραμέτρους των εκχωρημένων δικαιωμάτων OAuth2 και των δικαιωμάτων με δυνατότητα μεταβίβασης.

Ελάχιστα απαιτούμενα δικαιώματα: Καθολικός διαχειριστής

a365 setup permissions [command] [options]

Options

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

Subcommands

Subcommand	Description
`mcp`	Ρυθμίστε τις παραμέτρους των εκχωρημένων δικαιωμάτων OAuth2 του διακομιστή MCP και των δικαιωμάτων με δυνατότητα μεταβίβασης.
`bot`	Ρυθμίστε τις παραμέτρους των εκχωρημένων δικαιωμάτων OAuth2 του Bot API ανταλλαγής μηνυμάτων και των δικαιωμάτων με δυνατότητα μεταβίβασης.
`custom`	Εφαρμόζει προσαρμοσμένα δικαιώματα API στο σχέδιο του πράκτορα που υπερβαίνουν τα τυπικά δικαιώματα που απαιτούνται για τη λειτουργία του παράγοντα.
`copilotstudio`	Ρυθμίζει τις παραμέτρους των εκχωρημένων δικαιωμάτων OAuth2 και των μεταβιβάσιμων δικαιωμάτων για το σχέδιο παράγοντα για κλήση Copilot Studio copilots μέσω του API Power Platform.

`setup permissions mcp`

Ρυθμίστε τις παραμέτρους των εκχωρημένων δικαιωμάτων OAuth2 του διακομιστή MCP και των δικαιωμάτων με δυνατότητα μεταβίβασης.

Ελάχιστα απαιτούμενα δικαιώματα: Καθολικός διαχειριστής

a365 setup permissions mcp [options]

This command:

Το διαβάζει ToolingManifest.json από το deploymentProjectPath καθορισμένο στο a365.config.json.
Εκχωρεί εκχωρήσεις δικαιωμάτων με ανάθεση OAuth2 για κάθε εμβέλεια διακομιστή MCP στο σχέδιο παράγοντα.
Ρυθμίζει τα δικαιώματα μεταβίβασης ώστε οι παρουσίες αντιπροσώπων να έχουν πρόσβαση σε εργαλεία MCP.
Είναι ταυτοδύναμη και ασφαλές να τρέχει πολλές φορές.

Important

Πριν εκτελέσετε αυτήν την εντολή, βεβαιωθείτε ότι deploymentProjectPath οδηγεί στο φάκελο του έργου που περιέχει το ενημερωμένο ToolingManifest.jsonαρχείο . Εάν ο προγραμματιστής προσθέσει διακομιστές MCP σε διαφορετικό υπολογιστή, μοιραστείτε πρώτα την ενημερωμένη έκδοση ToolingManifest.json με τον καθολικό διαχειριστή. Αν εκτελείται χωρίς τη σωστή, ToolingManifest.json δεν προστίθενται τα δικαιώματα του νέου διακομιστή MCP στο σχέδιο.
Εκτελέστε αυτή την εντολή αφού ο προγραμματιστής εκτελέσει a365 develop add-mcp-serversτο . Η προσθήκη διακομιστών MCP στη διακήρυξη και η εκχώρηση δικαιωμάτων στο σχέδιο είναι δύο ξεχωριστά βήματα. Αφού ολοκληρωθεί αυτή η εντολή, τα δικαιώματα του διακομιστή MCP είναι ορατά στο σχέδιο του παράγοντα.

`permissions mcp` επιλογές

Option	Description
`-n`, `--agent-name <name>`	Όνομα βάσης πράκτορα. Όταν παρέχετε αυτήν την επιλογή, δεν χρειάζεστε αρχείο ρυθμίσεων.
`--tenant-id <tenantId>`	Azure αναγνωριστικό μισθωτή AD. Overrides auto-detection. Χρησιμοποιήστε το με `--agent-name`.
`-v`, `--verbose`	Εμφάνιση λεπτομερούς εξόδου.
`--dry-run`	Εμφανίστε τι θα έκανε η εντολή χωρίς να την εκτελέσετε.
`--remove-legacy-scopes`	Καταργεί κοινόχρηστες εμβέλειες παλαιού τύπου (`McpServers.*.All` μορφή) από το σχέδιο μετά τη μετεγκατάσταση σε δικαιώματα ανά διακομιστή (`Tools.ListInvoke.All`). Χρησιμοποιήστε το μόνο αφού επιβεβαιωθεί ότι το V2 SDK είναι ενεργό - οι πράκτορες στο V1 SDK χάνουν την πρόσβαση στο εργαλείο εάν αφαιρεθούν πρόωρα.
`-?`, `-h`, `--help`	Εμφάνιση πληροφοριών βοήθειας και χρήσης.

Μετεγκατάσταση σε δικαιώματα MCP ανά διακομιστή

Χρησιμοποιήστε --remove-legacy-scopes το κατά τη μετεγκατάσταση από το μοντέλο κοινόχρηστων δικαιωμάτων παλαιού τύπου σε δικαιώματα ανά διακομιστή:

Κοινόχρηστο μοντέλο παλαιού τύπου: Ένα αναγνωριστικό εφαρμογής ενός πόρου (ea9ffc3e-8a23-4a7d-836d-234d7c7565c1) με κοινόχρηστες εμβέλειες όπως McpServers.Mail.All και McpServers.Teams.All.
Μοντέλο ανά διακομιστή: Κάθε διακομιστής MCP έχει το δικό του αναγνωριστικό εφαρμογής με την εμβέλεια Tools.ListInvoke.All.

Το παρακάτω παράδειγμα δείχνει πώς εμφανίζονται τα δικαιώματα ανά διακομιστή στο Κέντρο διαχείρισης Microsoft Entra μετά την εφαρμογή του σχεδίου. Κάθε διακομιστής MCP, όπως ο διακομιστής IQ Calendar MCP και το Work IQ Mail MCP, έχει τη δική του εμβέλεια ανάθεσης Tools.ListInvoke.All . Μια κοινόχρηστη McpServersMetadata.Read.All εμβέλεια παρέχει πρόσβαση στα μετα-δεδομένα του διακομιστή MCP.

`setup permissions bot`

Ρυθμίστε τις παραμέτρους των εκχωρημένων δικαιωμάτων OAuth2 του Bot API ανταλλαγής μηνυμάτων και των δικαιωμάτων με δυνατότητα μεταβίβασης.

Ελάχιστα απαιτούμενα δικαιώματα: Καθολικός διαχειριστής

Προαπαιτούμενα: Δικαιώματα Blueprint και MCP (πρώτα εκτέλεση a365 setup permissions mcp )

a365 setup permissions bot [options]

`permissions bot` επιλογές

Option	Description
`-n`, `--agent-name <name>`	Όνομα βάσης πράκτορα. Όταν παρέχετε αυτήν την επιλογή, δεν χρειάζεστε αρχείο ρυθμίσεων.
`--tenant-id <tenantId>`	Azure αναγνωριστικό μισθωτή AD. Overrides auto-detection. Χρησιμοποιήστε το με `--agent-name`.
`-v`, `--verbose`	Εμφάνιση λεπτομερούς εξόδου.
`--dry-run`	Εμφανίστε τι θα έκανε η εντολή χωρίς να την εκτελέσετε.
`-?`, `-h`, `--help`	Εμφάνιση πληροφοριών βοήθειας και χρήσης.

`setup permissions custom`

Εφαρμόζει προσαρμοσμένα δικαιώματα API στο σχέδιο του πράκτορα που υπερβαίνουν τα τυπικά δικαιώματα που απαιτούνται για τη λειτουργία του παράγοντα. Χρησιμοποιώντας αυτήν την εντολή, εκχωρείτε στον πράκτορά σας πρόσβαση σε πρόσθετες εμβέλειες Microsoft Graph, όπως Παρουσία, Αρχεία και Συνομιλία ή σε προσαρμοσμένα API που έχουν καταχωρηθεί στον μισθωτή Microsoft Entra ID του οργανισμού σας.

Ελάχιστα απαιτούμενα δικαιώματα: Καθολικός διαχειριστής

Προαπαιτούμενα: Εκτελέστε a365 setup blueprint πρώτα.

a365 setup permissions custom [options]

This command:

Ρυθμίζει τις παραμέτρους των εκχωρημένων δικαιωμάτων OAuth2 με ανάθεση με συγκατάθεση διαχειριστή για κάθε διαμορφωμένο πόρο.
Ορίζει δικαιώματα με δυνατότητα μεταβίβασης, ώστε οι χρήστες αντιπροσώπων να μπορούν να μεταβιβάσουν την πρόσβαση από το σχέδιο.
Συμφιλιώνει Microsoft Entra με την τρέχουσα ρύθμιση παραμέτρων, προσθέτοντας νέα δικαιώματα και καταργώντας τυχόν δικαιώματα που διαγράψατε από τη ρύθμιση παραμέτρων.
Είναι ταυτοδύναμη και ασφαλές να τρέχει πολλές φορές.

`permissions custom` επιλογές

Option	Description
`-n`, `--agent-name <name>`	Όνομα βάσης πράκτορα. Όταν παρέχετε αυτήν την επιλογή, δεν χρειάζεστε αρχείο ρυθμίσεων.
`--tenant-id <tenantId>`	Azure αναγνωριστικό μισθωτή AD. Overrides auto-detection. Χρησιμοποιήστε το με `--agent-name`.
`-v`, `--verbose`	Εμφάνιση λεπτομερούς εξόδου.
`--dry-run`	Εμφανίστε τι θα έκανε η εντολή χωρίς να την εκτελέσετε.
`--resource-app-id <guid>`	Αναγνωριστικό εφαρμογής πόρου (GUID) για ένα ενσωματωμένο προσαρμοσμένο δικαίωμα. Χρησιμοποιήστε το με `--scopes`.
`--scopes <scopes>`	Εμβέλειες ανάθεσης διαχωρισμένες με κόμματα για το ενσωματωμένο προσαρμοσμένο δικαίωμα. Χρησιμοποιήστε το με `--resource-app-id`.
`-?`, `-h`, `--help`	Εμφάνιση πληροφοριών βοήθειας και χρήσης.

Ρύθμιση παραμέτρων προσαρμοσμένων δικαιωμάτων ενσωματωμένων

Χρησιμοποιήστε --resource-app-id και --scopes εφαρμόστε προσαρμοσμένα δικαιώματα απευθείας χωρίς επεξεργασία a365.config.json:

# Add Microsoft Graph extended permissions
a365 setup permissions custom `
  --resource-app-id 00000003-0000-0000-c000-000000000000 `
  --scopes Presence.ReadWrite,Files.Read.All,Chat.Read

# Add custom API permissions
a365 setup permissions custom `
  --resource-app-id <your-api-app-id> `
  --scopes CustomScope.Read,CustomScope.Write

Το όνομα του πόρου επιλύεται αυτόματα από το Microsoft Entra. Δεν χρειάζεται να το προσδιορίσετε.

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

Εναλλακτικά, προσθέστε customBlueprintPermissionsa365.config.json και εκτελέστε την εντολή χωρίς ενσωματωμένες σημαίες:

a365 setup permissions custom

Αυτή η εντολή εναρμονίζει το Microsoft Entra με τα ρυθμισμένα δικαιώματα - προσθέτει νέα δικαιώματα και καταργεί τυχόν δικαιώματα που διαγράψατε από τη ρύθμιση παραμέτρων.

Ενοποίηση με τα `setup all`

Όταν η ρύθμιση παραμέτρων σας περιλαμβάνει προσαρμοσμένα δικαιώματα, η εκτέλεση a365 setup all τις ρυθμίζει αυτόματα ως μέρος μιας φάσης δικαιωμάτων μοναδικής δέσμης. Η πλήρης σειρά εγκατάστασης είναι:

Blueprint
Δέσμη δικαιωμάτων (MCP, Bot API, Δικαιώματα προσαρμοσμένου σχεδίου — όλα ρυθμισμένα μαζί)

`setup permissions copilotstudio`

Ρυθμίζει τις παραμέτρους των εκχωρημένων δικαιωμάτων OAuth2 και των μεταβιβάσιμων δικαιωμάτων για το σχέδιο παράγοντα για κλήση Copilot Studio copilots μέσω του API Power Platform.

Ελάχιστα απαιτούμενα δικαιώματα: Καθολικός διαχειριστής

Προαπαιτούμενα: Εκτελέστε a365 setup blueprint πρώτα.

a365 setup permissions copilotstudio [options]

This command:

Βεβαιωθείτε ότι η κύρια υπηρεσία API Power Platform υπάρχει στον μισθωτή σας.
Δημιουργεί μια εκχώρηση δικαιωμάτων OAuth2 από το σχέδιο στο Power Platform API με την CopilotStudio.Copilots.Invoke εμβέλεια.
Ορίζει δικαιώματα μεταβίβασης ώστε οι παρουσίες αντιπροσώπων να μπορούν να καλούν Copilot Studio copilots.

`permissions copilotstudio` επιλογές

Option	Description
`-n`, `--agent-name <name>`	Όνομα βάσης πράκτορα. Όταν παρέχετε αυτήν την επιλογή, δεν χρειάζεστε αρχείο ρυθμίσεων.
`--tenant-id <tenantId>`	Azure αναγνωριστικό μισθωτή AD. Overrides auto-detection. Χρησιμοποιήστε το με `--agent-name`.
`-v`, `--verbose`	Εμφάνιση λεπτομερούς εξόδου.
`--dry-run`	Εμφανίστε τι θα έκανε η εντολή χωρίς να την εκτελέσετε.
`-?`, `-h`, `--help`	Εμφάνιση πληροφοριών βοήθειας και χρήσης.

Χρησιμοποιήστε αυτή την εντολή όταν ο πράκτοράς σας χρειάζεται να καλέσει Copilot Studio copilots κατά τον χρόνο εκτέλεσης ή να καλέσει API Power Platform που απαιτούν δικαιώματα CopilotStudio.

`setup all`

Εκτελέστε όλα τα βήματα ρύθμισης για να ρυθμίσετε το περιβάλλον του Παράγοντα 365

a365 setup all [options]

Εκτελεί την πλήρη εγκατάσταση του Παράγοντα 365, όλα τα βήματα με τη σειρά.

Περιλαμβάνει: Blueprint και δικαιώματα.

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

Step	Global Administrator	Διαχειριστής Αναγνωριστικού Πράκτορα	Αναγνωριστικό προγραμματιστή πράκτορα
Prerequisites check	Yes	Yes	Yes
Δημιουργία σχεδίου παράγοντα	Yes	Yes	Yes
Μεταβιβάσιμα δικαιώματα (μόνο για συμπαίκτη AI)	Yes	Yes	Yes
Εκχωρήσεις δικαιωμάτων OAuth2 (συγκατάθεση διαχειριστή)	Yes	Απαιτεί βήμα ga	Απαιτεί βήμα ga
Εκχωρήσεις ταυτότητας αντιπροσώπου (`--authmode s2s` ή `both`)	Yes	PowerShell fallback	PowerShell fallback

Όταν εκτελείτε a365 setup all χωρίς καθολικό διαχειριστή, η CLI:

Ολοκληρώνει όλα τα βήματα που μπορεί (δημιουργία σχεδίου και δικαιώματα με δυνατότητα μεταβίβασης).
Δημιουργεί διευθύνσεις URL συγκατάθεσης διαχειριστή ανά πόρο και τις αποθηκεύει στο a365.generated.config.json.
Εμφανίζει τα επόμενα βήματα στην έξοδο για έναν καθολικό διαχειριστή για την ολοκλήρωση των εκχωρήσεων OAuth2, συμπεριλαμβανομένης μιας άμεσης σύνδεσης ή μιας διεύθυνσης URL συγκατάθεσης.

Tip

Εάν είστε καθολικός διαχειριστής, a365 setup all ολοκληρώνει όλα τα στοιχεία σε μία εκτέλεση χωρίς να απαιτείται παράδοση.

Ελάχιστα απαιτούμενα δικαιώματα:

Ρόλος προγραμματιστή αναγνωριστικού παράγοντα (για δημιουργία σχεδίου)
Καθολικός διαχειριστής (για παραχωρήσεις δικαιωμάτων OAuth2 - εάν δεν είναι διαθέσιμες, το CLI εκτυπώνει τα επόμενα βήματα στην έξοδο)
Διαχειριστής εφαρμογής ή καθολικός διαχειριστής (για εκχωρήσεις ταυτότητας παράγοντα S2S (Server-to-Server) - --authmode s2s ή both; εάν δεν είναι διαθέσιμο, το CLI εκτυπώνει μια εναλλακτική λύση PowerShell στη σύνοψη εγκατάστασης)

`setup all` επιλογές

Option	Description
`-v`, `--verbose`	Εμφάνιση λεπτομερούς εξόδου.
`--dry-run`	Εμφανίστε τι θα έκανε η εντολή χωρίς να την εκτελέσετε.
`--skip-requirements`	Παράλειψη ελέγχου επικύρωσης απαιτήσεων. Να είστε προσεκτικοί: Η ρύθμιση ενδέχεται να αποτύχει εάν δεν πληρούνται τα προαπαιτούμενα.
`--aiteammate`	Χρησιμοποιήστε αυτήν την παράμετρο για να κατευθύνετε τη ροή εκπροσώπου συμπαίκτη AI μόνο στην παροχή σχεδιαγράμματος και δικαιωμάτων. Χωρίς αυτήν την παράμετρο, η ροή παράγοντα σχεδιαγράμματος δημιουργεί αυτόματα την κύρια υπηρεσία ταυτότητας εκπροσώπου χωρίς χρήστη Entra. Αυτή η παράμετρος παρακάμπτει το `aiteammate` πεδίο στο `a365.config.json`.
`--authmode <mode>`	Μοτίβο ελέγχου ταυτότητας για εκχωρήσεις δικαιωμάτων ταυτότητας εκπροσώπου (μόνο πράκτορες σχεδιαγράμματος). `obo` (προεπιλογή) — Εξουσιοδοτημένες επιχορηγήσεις κύριου επιπέδου, δεν απαιτείται ρόλος διαχειριστή. `s2s` — αναθέσεις ρόλων εφαρμογής στο SP ταυτότητας εκπροσώπου, απαιτείται Διαχειριστής Εφαρμογής ή Καθολικός Διαχειριστής. Το εναλλακτικό PowerShell εκτυπώνεται εάν ο ρόλος απουσιάζει. `both` — εφαρμόζει επιχορηγήσεις OBO (On-Behalf-Of) και S2S. Δεν υποστηρίζεται με `--aiteammate`. Μπορεί επίσης να οριστεί όπως `authMode` στο `a365.config.json`.
`--agent-registration-only`	Παραλείψτε τα βήματα σχεδιαγράμματος και δικαιωμάτων και εκτελέστε μόνο την εγγραφή αντιπροσώπου. Χρησιμοποιήστε το για να δοκιμάσετε ξανά ένα αποτυχημένο βήμα καταχώρησης.
`--m365`	Αντιμετωπίστε αυτόν τον παράγοντα ως παράγοντα M365. Καταχωρεί το τελικό σημείο ανταλλαγής μηνυμάτων μέσω της πλατφόρμας MCP. Η προεπιλογή είναι `false` (opt-in).
`-n`, `--agent-name <name>`	Όνομα βάσης παράγοντα (για παράδειγμα, `"MyAgent"`). Όταν παρέχεται, δεν απαιτείται αρχείο ρύθμισης παραμέτρων. Αντλεί εμφανιζόμενα ονόματα ως `"<name> Identity"` και `"<name> Blueprint"`. Το TenantId ανιχνεύεται αυτόματα από `az account show` το (παράκαμψη με `--tenant-id`το ). Το ClientAppId επιλύεται με αναζήτηση `Agent 365 CLI` στον μισθωτή σας.
`--tenant-id <tenantId>`	Azure αναγνωριστικό μισθωτή AD. Παρακάμπτει τον αυτόματο εντοπισμό από `az account show`το . Χρησιμοποιήστε την με `--agent-name` κατά την εκτέλεση σε ένα μη αλληλεπιδραστικό περιβάλλον ή για τη στόχευση ενός συγκεκριμένου μισθωτή.
`-?`, `-h`, `--help`	Εμφάνιση πληροφοριών βοήθειας και χρήσης.

Agent setup

Από προεπιλογή, a365 setup all εκτελεί τη ροή παράγοντα σχεδιαγράμματος. Αυτή η ροή δημιουργεί έναν παράγοντα χωρίς εξάρτηση Από το Dataverse ή το AI. Λειτουργεί για πράκτορες που επικοινωνούν απευθείας με την πλατφόρμα Agent 365.

# Default: uses a365.config.json
a365 setup all

# Or explicitly (same result)
a365 setup all --aiteammate false

Για να εκτελέσετε τη ροή πράκτορα συμπαίκτη AI, περάστε --aiteammateτο .

Αυτή η ροή εκτελεί τα ακόλουθα βήματα με τη σειρά:

Επικύρωση αναφορών — ελέγχει Azure ρόλους και προαπαιτούμενα.
Blueprint creation — δημιουργεί ή επαναχρησιμοποιεί την εφαρμογή Entra ID Agent Blueprint.
Βατικά δικαιώματα — ρυθμίζει τις επιχορηγήσεις δικαιωμάτων με ανάθεση στο σχέδιο για Microsoft Graph, εργαλεία agent 365, API bot ανταλλαγής μηνυμάτων, API παρατηρήσεων, Power Platform και οποιουσδήποτε προσαρμοσμένους πόρους.
Δηματική ταυτότητα — δημιουργεί μια ταυτότητα παράγοντα στο Entra ID μέσω του Graph API ταυτότητας του παράγοντα.
Καταχώρηση παράγοντα — καταχωρεί τον πράκτορα μέσω του API καταχώρισης παράγοντα AgentX V2.
Συγχρονισμός ρύθμισης παραμέτρων — εγγράφει τις ρυθμίσεις σύνδεσης χρόνου εκτέλεσης και τη ρύθμιση παραμέτρων της δυνατότητας παρακολούθησης στα αρχεία του έργου σας (appsettings.json, .env).

Note

Η ροή εκπροσώπου AI Teammate απαιτεί πρόσθετα δικαιώματα API beta στην προσαρμοσμένη εφαρμογή προγράμματος-πελάτη πέρα από το βασικό σύνολο. Ανατρέξτε στην ενότητα Εγγραφή προσαρμοσμένης εφαρμογής προγράμματος-πελάτη για την πλήρη λίστα απαιτούμενων δικαιωμάτων.

Ρύθμιση χωρίς ρύθμιση παραμέτρων με `--agent-name`

Εάν δεν έχετε ένα a365.config.json αρχείο, χρησιμοποιήστε --agent-name το για να εκτελέσετε τη ρύθμιση χωρίς ένα. Το CLI εντοπίζει αυτόματα τον μισθωτή σας και επιλύει την εφαρμογή προγράμματος-πελάτη, αναζητώντας τη γνωστή Agent 365 CLI καταχώρηση εφαρμογής στον μισθωτή σας.

# Preview what would happen (no changes made)
a365 setup all --agent-name "MyAgent" --dry-run

# Run the full setup
a365 setup all --agent-name "MyAgent"

Κατά τη χρήση του --agent-name:

Το TenantId ανιχνεύεται αυτόματα από az account showτο . Μεταβιβάστε --tenant-id το για παράκαμψη.
Το ClientAppId επιλύεται αναζητώντας μια εφαρμογή Entra με το όνομα Agent 365 CLI του μισθωτή σας. Εάν δεν βρεθεί, η CLI θα τερματιστεί με σφάλμα. Ανατρέξτε στο θέμα Καταχώρηση προσαρμοσμένης εφαρμογής προγράμματος-πελάτη για τον τρόπο καταχώρησης αυτής της εφαρμογής.
Τα εμφανιζόμενα ονόματα προέρχονται ως "<name> Agent" (ταυτότητα) και "<name> Blueprint" (σχέδιο).
Η υποδομή παραλείπεται πάντα (θεωρείται εξωτερική φιλοξενία).
Παραλείπεται ο συγχρονισμός ρύθμισης παραμέτρων (εγγραφήappsettings.json), καθώς δεν έχει ρυθμιστεί καμία διαδρομή έργου.

Εάν η εφαρμογή προγράμματος-πελάτη δεν έχει AllPrincipals συγκατάθεση διαχειριστή για τα απαιτούμενα δικαιώματα, η CLI το εντοπίζει αυτό και σας ζητά να εκχωρήσετε δικαιώματα με αλληλεπιδραστικό τρόπο:

The following permissions require admin consent:
  AgentIdentity.ReadWrite.All
  AgentIdentity.Create.All
  ...
Grant admin consent for these permissions now? [y/N]:

Πληκτρολογήστε y για να εκχωρήσετε συγκατάθεση εντός γραμμής. Εάν δεν είστε καθολικός διαχειριστής, απορρίψτε — το CLI εκτυπώνει τα επόμενα βήματα για έναν καθολικό διαχειριστή στη σύνοψη εγκατάστασης.

Εκχωρήσεις ταυτότητας αντιπροσώπου (`--authmode`)

Από προεπιλογή, a365 setup all δημιουργεί εξουσιοδοτήσεις ανάθεσης με ανάθεση σε κύριο πεδίο στην κύρια υπηρεσία ταυτότητας εκπροσώπου (obo λειτουργία). Αυτές οι εκχωρήσεις δεν απαιτούν ρόλο διαχειριστή.

Χρησιμοποιείται --authmode για τον έλεγχο του τύπου επιχορήγησης:

Value	Behavior	Minimum role
`obo` (προεπιλογή)	Εξουσιοδοτήσεις με ανάθεση κύριου επιπέδου για την ταυτότητα εκπροσώπου SP	Κανένας (οποιοσδήποτε πιστοποιημένος χρήστης)
`s2s`	Αναθέσεις ρόλων εφαρμογής στην ταυτότητα εκπροσώπου SP	Διαχειριστής εφαρμογής ή καθολικός διαχειριστής
`both`	Τόσο οι επιχορηγήσεις ανάθεσης OBO όσο και οι αναθέσεις ρόλων εφαρμογών S2S	Ρόλος S2S (παραπάνω) για το τμήμα S2S

# Default — OBO delegated grants (no admin role needed)
a365 setup all

# S2S app role assignments
a365 setup all --authmode s2s

# Both OBO and S2S
a365 setup all --authmode both

Όταν ο συνδεδεμένος χρήστης δεν διαθέτει τον απαιτούμενο ρόλο για επιχορηγήσεις S2S, το CLI εκτυπώνει ένα εναλλακτικό μπλοκ PowerShell στη σύνοψη εγκατάστασης. Ένας διαχειριστής μπορεί να το εκτελέσει για να ολοκληρώσει τις αναθέσεις.

Ρυθμίστε authModea365.config.json έτσι ώστε να ισχύει σε κάθε διαδρομή χωρίς τη σημαία:

{
  "authMode": "s2s"
}

Note

--authmode δεν υποστηρίζεται με --aiteammate. Οι πράκτορες συμπαικτών AI χρησιμοποιούν αυτόματα το OBO μέσω της ταυτότητας χρήστη του πράκτορα.

Config sync

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

Setting	Written to	Description
`Connections.ServiceConnection`	`appsettings.json` / `.env`	Αναγνωριστικό προγράμματος-πελάτη Blueprint, μυστικός κωδικός προγράμματος-πελάτη, αναγνωριστικό μισθωτή και τελικό σημείο διακριτικού
`Agent365Observability`	`appsettings.json` / `.env`	Αναγνωριστικό παράγοντα (Ταυτότητα παράγοντα), αναγνωριστικό σχεδίου, αναγνωριστικό μισθωτή, αναγνωριστικό πελάτη και μυστικό πελάτη για εξαγωγή τηλεμετρίας
`TokenValidation`	`appsettings.json`	Ρυθμίσεις επικύρωσης διακριτικού (απενεργοποιημένη από προεπιλογή για μη DW)
`ConnectionsMap`	`appsettings.json` / `.env`	Προεπιλεγμένη διεύθυνση URL υπηρεσίας για αντιστοίχιση συνδέσεων

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

Επανάληψη μιας αποτυχημένης καταχώρησης

Εάν η ρύθμιση ολοκληρώσει με επιτυχία το σχέδιο και τα δικαιώματα, αλλά αποτύχει κατά τη διάρκεια της εγγραφής του παράγοντα, χρησιμοποιήστε το --agent-registration-only για να επαναλάβετε μόνο αυτό το βήμα χωρίς να επαναλάβετε την προηγούμενη εργασία:

a365 setup all --agent-registration-only

Σχόλια

Ήταν χρήσιμη αυτή η σελίδα;

Last updated on 2026-05-07

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

Syntax

Options

Προτεινόμενη εντολή εκτέλεσης

setup requirements

requirements επιλογές

setup blueprint

blueprint επιλογές

setup permissions

Options

Subcommands

setup permissions mcp

permissions mcp επιλογές

Μετεγκατάσταση σε δικαιώματα MCP ανά διακομιστή

setup permissions bot

permissions bot επιλογές

setup permissions custom

permissions custom επιλογές

Ρύθμιση παραμέτρων προσαρμοσμένων δικαιωμάτων ενσωματωμένων

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

Ενοποίηση με τα setup all

setup permissions copilotstudio

permissions copilotstudio επιλογές

setup all

setup all επιλογές

Agent setup

Ρύθμιση χωρίς ρύθμιση παραμέτρων με --agent-name

Συγκατάθεση διαχειριστή κατά τη ρύθμιση

Εκχωρήσεις ταυτότητας αντιπροσώπου (--authmode)

Config sync

Επανάληψη μιας αποτυχημένης καταχώρησης

Σχόλια

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

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

`setup requirements`

`requirements` επιλογές

`setup blueprint`

`blueprint` επιλογές

`setup permissions`

`setup permissions mcp`

`permissions mcp` επιλογές

`setup permissions bot`

`permissions bot` επιλογές

`setup permissions custom`

`permissions custom` επιλογές

Ενοποίηση με τα `setup all`

`setup permissions copilotstudio`

`permissions copilotstudio` επιλογές

`setup all`

`setup all` επιλογές

Ρύθμιση χωρίς ρύθμιση παραμέτρων με `--agent-name`

Εκχωρήσεις ταυτότητας αντιπροσώπου (`--authmode`)