Agent 365 CLI-Befehlsreferenz `setup`

Von Bedeutung

Sie müssen Teil des Frontier-Vorschauversionsprogramms sein, um Vorabzugriff auf Microsoft Agent 365 zu erhalten. Frontier verbindet Sie direkt mit den neuesten KI-Innovationen von Microsoft. Frontier-Vorschauen unterliegen den bestehenden Vorschaubedingungen Ihrer Kundenverträge. Da diese Funktionen noch in Entwicklung sind, können sich ihre Verfügbarkeit und Fähigkeiten im Laufe der Zeit ändern.

Richten Sie Ihre Agent 365-Umgebung mit präziser Kontrolle über jeden Schritt ein. Mit diesem Befehl wird der anfängliche Setupworkflow für Agent 365-Blueprints verwaltet.

Minimum role required: Azure Contributor + Global Administrator

Syntax

a365 setup [command] [options]

Options

Option	Description
`-?`, `-h--help`	Zeigt Hilfe- und Nutzungsinformationen an.

Empfohlene Ausführungsreihenfolge

# 0. Check prerequisites (optional)
a365 setup requirements

# 1. Create infrastructure (or skip if infrastructure exists)
a365 setup infrastructure

# 2. Create blueprint
a365 setup blueprint

# 3. Configure MCP permissions
a365 setup permissions mcp

# 4. Configure bot permissions
a365 setup permissions bot

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

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

Oder führen Sie alle Schritte gleichzeitig aus:

# Full setup (includes infrastructure)
a365 setup all

# Skip infrastructure if it already exists
a365 setup all --skip-infrastructure

`setup requirements`

Überprüfen Sie die Voraussetzungen für das Agent 365-Setup. Führt modulare Anforderungsprüfungen durch und bietet Anleitungen für probleme, die gefunden werden.

a365 setup requirements [options]

Dieser Befehl führt die folgenden Schritte aus:

Überprüft alle erforderlichen Voraussetzungen für die Agent 365-Einrichtung.
Meldet alle Probleme mit detaillierten Lösungsanleitungen.
Überprüft weiterhin alle Anforderungen, auch wenn einige Überprüfungen fehlschlagen.
Enthält eine Zusammenfassung aller Prüfungen am Ende.

`requirements`-Optionen

Option	Description
`-c`, `--config <config>`	Konfigurationsdateipfad. Der Standardwert lautet `a365.config.json`.
`-v`, `--verbose`	Zeigt eine detaillierte Ausgabe für alle Prüfungen an.
`--category <category>`	Führt nur Prüfungen für eine bestimmte Kategorie aus, z. B. `Azure`, `Authentication` oder `Configuration`.
`-?`, `-h--help`	Zeigt Hilfe- und Nutzungsinformationen an.

`setup infrastructure`

Erstellen Sie Azure Infrastruktur.

Minimum erforderliche Berechtigungen: Azure Abonnementmitwirkender oder Besitzer

a365 setup infrastructure [options]

`infrastructure`-Optionen

Option	Description
`-c`, `--config <config>`	Konfigurationsdateipfad. Der Standardwert lautet `a365.config.json`.
`-v`, `--verbose`	Detaillierte Ausgabe anzeigen.
`--dry-run`	Zeigen Sie an, was ohne Ausführung geschehen würde.
`-?`, `-h--help`	Zeigt Hilfe- und Nutzungsinformationen an.

`setup blueprint`

Erstellen sie den Agent-Blueprint (Entra ID-Anwendungsregistrierung).

Erforderliche Mindestberechtigungen: Rolle "Agent-ID-Entwickler"

a365 setup blueprint [options]

`blueprint`-Optionen

Option	Description
`-c`, `--config <config>`	Konfigurationsdateipfad. Der Standardwert lautet `a365.config.json`.
`-v`, `--verbose`	Detaillierte Ausgabe anzeigen.
`--dry-run`	Zeigen Sie an, was ohne Ausführung geschehen würde.
`--no-endpoint`	Registrieren Sie keinen Messaging-Endpunkt (nur Blueprint).
`--endpoint-only`	Registrieren Sie nur den Messagingendpunkt. Erfordert einen vorhandenen Blueprint.
`-?`, `-h--help`	Zeigt Hilfe- und Nutzungsinformationen an.

`setup permissions`

Konfigurieren Sie OAuth2-Berechtigungserteilungen und vererbbare Berechtigungen.

Erforderliche Mindestberechtigungen: Globaler Administrator

a365 setup permissions [command] [options]

Options

Option	Description
`-?`, `-h--help`	Zeigt Hilfe- und Nutzungsinformationen an.

Unterbefehle

Subcommand	Description
`mcp`	Konfigurieren Sie DEN MCP-Server OAuth2, der Berechtigungen gewährt und vererbbar ist.
`bot`	Konfigurieren der Messaging-Bot-API OAuth2 gewährt und vererbbare Berechtigungen.
`custom`	Wendet benutzerdefinierte API-Berechtigungen auf Ihren Agent-Blueprint an, die über die für den Agent-Betrieb erforderlichen Standardberechtigungen hinausgehen.
`copilotstudio`	Konfiguriert OAuth2-Berechtigungserteilungen und vererbbare Berechtigungen für den Agent-Blueprint, um Copilot Studio-Copiloten über die Power Platform-API aufzurufen.

`setup permissions mcp`

Konfigurieren Sie DEN MCP-Server OAuth2, der Berechtigungen gewährt und vererbbar ist.

Erforderliche Mindestberechtigungen: Globaler Administrator

a365 setup permissions mcp [options]

Dieser Befehl:

ToolingManifest.json Liest aus dem deploymentProjectPath in .a365.config.json
Gewährt OAuth2 delegierte Berechtigungserteilungen für jeden MCP-Serverbereich für den Agent-Blueprint.
Konfiguriert vererbbare Berechtigungen, sodass Agentinstanzen auf MCP-Tools zugreifen können.
Ist idempotent und sicher, mehrmals auszuführen.

Von Bedeutung

Führen Sie a365 config display vor dem Ausführen dieses Befehls aus, um zu überprüfen, ob deploymentProjectPath auf den Projektordner mit dem aktualisierten ToolingManifest.jsonOrdner verweist. Wenn der Entwickler MCP-Server auf einem anderen Computer hinzufügt, geben Sie zuerst die Aktualisierung ToolingManifest.json mit dem globalen Administrator frei. Wird ohne den richtigen ToolingManifest.json Vorgang ausgeführt, werden dem Blueprint nicht die neuen MCP-Serverberechtigungen hinzugefügt.
Führen Sie diesen Befehl aus, nachdem der Entwickler ausgeführt wurde a365 develop add-mcp-servers. Das Hinzufügen von MCP-Servern zum Manifest und das Erteilen von Berechtigungen für den Blueprint sind zwei separate Schritte. Nach Abschluss dieses Befehls sind die MCP-Serverberechtigungen im Agent-Blueprint sichtbar.

`permissions mcp`-Optionen

Option	Description
`-c`, `--config <config>`	Konfigurationsdateipfad. Der Standardwert lautet `a365.config.json`.
`-v`, `--verbose`	Detaillierte Ausgabe anzeigen.
`--dry-run`	Zeigen Sie an, was ohne Ausführung geschehen würde.
`-?`, `-h--help`	Zeigt Hilfe- und Nutzungsinformationen an.

`setup permissions bot`

Konfigurieren der Messaging-Bot-API OAuth2 gewährt und vererbbare Berechtigungen.

Erforderliche Mindestberechtigungen: Globaler Administrator

Voraussetzungen: Blueprint- und MCP-Berechtigungen (zuerst ausführen a365 setup permissions mcp )

Nächster Schritt: Stellen Sie Ihren Agent bereit (führen Sie a365 deploy aus, wenn sie auf Azure gehostet wird)

a365 setup permissions bot [options]

`permissions bot`-Optionen

Option	Description
`-c`, `--config <config>`	Konfigurationsdateipfad. Der Standardwert lautet `a365.config.json`.
`-v`, `--verbose`	Detaillierte Ausgabe anzeigen.
`--dry-run`	Zeigen Sie an, was ohne Ausführung geschehen würde.
`-?`, `-h--help`	Zeigt Hilfe- und Nutzungsinformationen an.

`setup permissions custom`

Wendet benutzerdefinierte API-Berechtigungen auf Ihren Agent-Blueprint an, die über die für den Agent-Betrieb erforderlichen Standardberechtigungen hinausgehen. Mit diesem Befehl gewähren Sie Ihrem Agent Zugriff auf zusätzliche Microsoft Graph Bereiche wie Anwesenheit, Dateien und Chat oder benutzerdefinierte APIs, die im Entra-ID-Mandanten Ihrer Organisation registriert sind.

Erforderliche Mindestberechtigungen: Globaler Administrator

Voraussetzungen: Zuerst ausführen a365 setup blueprint . Fügen Sie vor dem Ausführen dieses Befehls benutzerdefinierte Berechtigungen hinzu a365.config.jsona365 config permissions .

a365 setup permissions custom [options]

Dieser Befehl:

Konfiguriert delegierte OAuth2-Berechtigungserteilungen mit Administratorzustimmung für jede konfigurierte Ressource.
Legt vererbbare Berechtigungen fest, sodass Agentbenutzer den Zugriff vom Blueprint erben können.
Synchronisiert Microsoft Entra mit der aktuellen Konfiguration, indem neue Berechtigungen hinzugefügt und alle Berechtigungen entfernt werden, die aus der Konfiguration gelöscht wurden.
Ist idempotent und sicher, mehrmals auszuführen.

`permissions custom`-Optionen

Option	Description
`-c`, `--config <config>`	Konfigurationsdateipfad. Der Standardwert lautet `a365.config.json`.
`-v`, `--verbose`	Detaillierte Ausgabe anzeigen.
`--dry-run`	Zeigen Sie an, was ohne Ausführung geschehen würde.
`-?`, `-h--help`	Zeigt Hilfe- und Nutzungsinformationen an.

Konfigurieren von benutzerdefinierten Berechtigungen

Dient a365 config permissions zum Hinzufügen von benutzerdefinierten Berechtigungen zu Ihrer Konfiguration, bevor Sie diesen Befehl ausführen:

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

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

# Apply all configured custom permissions
a365 setup permissions custom

Der Ressourcenname wird während des Setups automatisch von Azure aufgelöst. Sie müssen sie nicht in der Konfiguration angeben.

Entfernen von benutzerdefinierten Berechtigungen

So entfernen Sie benutzerdefinierte Berechtigungen sowohl aus der Konfiguration als auch aus Microsoft Entra:

# Step 1: Remove from config
a365 config permissions --reset

# Step 2: Reconcile Microsoft Entra with updated config
a365 setup permissions custom

Integration mit `setup all`

Wenn Ihre Konfiguration benutzerdefinierte Berechtigungen enthält, konfiguriert die Ausführung a365 setup all diese automatisch. Die vollständige Einrichtungsreihenfolge lautet:

Infrastruktur
Bauplan
MCP-Berechtigungen
Bot-API-Berechtigungen
Benutzerdefinierte Blueprintberechtigungen (falls konfiguriert)
Endpunkt Messaging

`setup permissions copilotstudio`

Konfiguriert OAuth2-Berechtigungserteilungen und vererbbare Berechtigungen für den Agent-Blueprint, um Copilot Studio-Copiloten über die Power Platform-API aufzurufen.

Erforderliche Mindestberechtigungen: Globaler Administrator

Voraussetzungen: Zuerst ausführen a365 setup blueprint .

a365 setup permissions copilotstudio [options]

Dieser Befehl:

Stellt sicher, dass der Power Platform-API-Dienstprinzipal in Ihrem Mandanten vorhanden ist.
Erstellt eine OAuth2-Berechtigungserteilung vom Blueprint bis zur Power Platform-API mit dem CopilotStudio.Copilots.Invoke Bereich.
Legt vererbbare Berechtigungen fest, damit Agentinstanzen Copilot Studio-Copiloten aufrufen können.

`permissions copilotstudio`-Optionen

Option	Description
`-c`, `--config <config>`	Konfigurationsdateipfad. Der Standardwert lautet `a365.config.json`.
`-v`, `--verbose`	Detaillierte Ausgabe anzeigen.
`--dry-run`	Zeigen Sie an, was ohne Ausführung geschehen würde.
`-?`, `-h--help`	Zeigt Hilfe- und Nutzungsinformationen an.

Verwenden Sie diesen Befehl, wenn Ihr Agent Copilot Studio-Copiloten zur Laufzeit aufrufen oder Power Platform-APIs aufrufen muss, die CopilotStudio-Berechtigungen erfordern.

`setup all`

Ausführen aller Setupschritte zum Einrichten Ihrer Agent 365-Umgebung

a365 setup all [options]

Führt das vollständige Agent 365-Setup aus, alle Schritte in Folge.

Umfasst: Infrastruktur, Blueprint, Berechtigungen und Endpunkt.

Mindestens erforderliche Berechtigungen (globaler Administrator verfügt über alle diese Berechtigungen):

Azure Abonnementmitwirkender (für Infrastruktur und Endpunkt)
Rolle "Agent-ID-Entwickler" (für die Erstellung von Blueprints)
Globaler Administrator (für Berechtigungserteilungen und Administratorzustimmungen)

`setup all`-Optionen

Option	Description
`-c`, `--config <config>`	Konfigurationsdateipfad. Der Standardwert lautet `a365.config.json`.
`-v`, `--verbose`	Detaillierte Ausgabe anzeigen.
`--dry-run`	Zeigen Sie an, was ohne Ausführung geschehen würde.
`--skip-infrastructure`	Überspringen Sie Azure Infrastrukturerstellung (verwenden Sie diese, wenn die Infrastruktur bereits vorhanden ist). Diese Option erstellt weiterhin: Blueprint, Berechtigungen und Endpunkt.
`--skip-requirements`	Überprüfung der Anforderungen überspringen. Vorsicht: Setup schlägt möglicherweise fehl, wenn die Voraussetzungen nicht erfüllt sind.
`-?`, `-h--help`	Zeigt Hilfe- und Nutzungsinformationen an.

Feedback

War diese Seite hilfreich?

Last updated on 2026-03-10

Freigeben über

Agent 365 CLI-Befehlsreferenz setup

Syntax

Options

Empfohlene Ausführungsreihenfolge

setup requirements

requirements-Optionen

setup infrastructure

infrastructure-Optionen

setup blueprint

blueprint-Optionen

setup permissions

Options

Unterbefehle

setup permissions mcp

permissions mcp-Optionen

setup permissions bot

permissions bot-Optionen

setup permissions custom

permissions custom-Optionen

Konfigurieren von benutzerdefinierten Berechtigungen

Entfernen von benutzerdefinierten Berechtigungen

Integration mit setup all

setup permissions copilotstudio

permissions copilotstudio-Optionen

setup all

setup all-Optionen

Feedback

Zusätzliche Ressourcen

Agent 365 CLI-Befehlsreferenz `setup`

`setup requirements`

`requirements`-Optionen

`setup infrastructure`

`infrastructure`-Optionen

`setup blueprint`

`blueprint`-Optionen

`setup permissions`

`setup permissions mcp`

`permissions mcp`-Optionen

`setup permissions bot`

`permissions bot`-Optionen

`setup permissions custom`

`permissions custom`-Optionen

Integration mit `setup all`

`setup permissions copilotstudio`

`permissions copilotstudio`-Optionen

`setup all`

`setup all`-Optionen