Agent 365 CLI-Befehlsreferenz deploy

Bereitstellen von Agent 365-Anwendungsbinärdateien in den konfigurierten Azure App Service und Aktualisieren der Agent 365-Toolberechtigungen Der Befehl deploy bietet Optionen zum Erstellen von Agent 365-Bereitstellungen. Verwenden Sie diesen Befehl, um Anwendungsbinärdateien in Ihrer Azure Infrastruktur bereitzustellen und Agent 365 Tools Berechtigungen zu erteilen.

Minimum role required: Azure Contributor + Global Administrator

Informationen zur Verwendung dieses Befehls finden Sie unter Deploy agent to Azure.

Syntax

a365 deploy [command] [options]

Options

Bemerkungen

Wird a365 deploy ohne Unterbefehl ausgeführt, wird eine zweistufige Bereitstellung ausgeführt:

• Phase 1 – Anwendungsbinärdateien: Erstellt und stellt Ihre Anwendung für Azure App Service bereit.
• Phase 2 – MCP-Berechtigungen: Liest die erforderlichen Bereiche aus toolingManifest.json und aktualisiert den Agent-Blueprint mit den erforderlichen Berechtigungen.

Beide Phasen werden auch mit --dry-run. Die Trockenlaufausgabe ist in zwei beschriftete Abschnitte unterteilt, sodass Sie überprüfen können, was jede Phase tun würde.

Preflight-Prüfungen

Vor der Bereitstellung überprüft die CLI Folgendes:

• Azure Authentifizierung und Abonnement: Ihre Azure CLI Sitzung und Ihr Abonnement müssen gültig sein. Wenn nicht, wird die Bereitstellung mit einem Fehler beendet. Korrigieren mit az login --tenant <TENANT_ID> und az account set --subscription <SUBSCRIPTION_ID>.
• Azure App Service existenz: Die Zielweb-App muss vorhanden sein, bevor die Bereitstellung fortgesetzt wird. Wenn die App nicht gefunden wird, führen Sie die App aus, oder korrigieren a365 setupwebAppName Sie sie in resourceGroupa365.config.json.

Konfiguration

Die CLI liest aus zwei Konfigurationsdateien:

• a365.config.json — Ihre Projektkonfiguration (vom Benutzer verwaltet).
• a365.generated.config.json — dynamischer Zustand, der von Setupbefehlen generiert wird.

MCP-Toolbereiche werden aus Ihrem Bereitstellungsprojektverzeichnis gelesen toolingManifest.json .

Die CLI speichert außerdem eine globale Kopie der Konfiguration und des Zustands unter:

• Windows: %LocalAppData%\Microsoft.Agents.A365.DevTools.Cli
• Linux/macOS: ~/.config/a365

Kennzeichnungsverhalten

--restart: Überspringt den Buildschritt und beginnt direkt mit der Komprimierung des vorhandenen publish/ Ordners. Falls publish/ nicht vorhanden, schlägt die Bereitstellung fehl. Führen Sie zuerst eine vollständige Bereitstellung (ohne --restart) aus, um den publish/ Ordner zu erstellen.

--inspect: Hält vor dem Uploadschritt an, damit Sie den publish/ Ordner und die generierte ZIP-Datei überprüfen können. Nur für die App-Phase verfügbar.

--dry-run: Druckt alles, was ohne Änderungen geschehen würde. Bei ausführung a365 deploy (zwei phasenweiser Ausführung) wird die Ausgabe in:

• Teil 1 – Bereitstellen von Anwendungsbinärdateien
• Teil 2 – Berechtigungen für das Bereitstellen/Aktualisieren des Agent 365-Tools

deploy app

Stellt Ihren Agentcode in der Azure Web App bereit, die während des Setups erstellt wurde.

a365 deploy app [options]

Stellen Sie Binärdateien von Microsoft Agent 365-Anwendungen auf dem konfigurierten Azure App Service bereit. Mit diesem Befehl werden Anwendungsbinärdateien in ihrem konfigurierten Azure App-Dienst in Azure bereitgestellt.

app-Optionen

deploy mcp

Aktualisiert MCP-Serverberechtigungen für Ihren Agent-Blueprint.

a365 deploy mcp [options]

mcp-Optionen

Verwendungshinweise

Aktualisieren Sie MCP-Serverbereiche und Berechtigungen für vorhandene Agent-Blueprints. Mit diesem Befehl werden dem Agent-Blueprint Berechtigungen für Agent 365-Tools hinzugefügt.

Wenn Sie MCP-Server in Ihrem Agentcode hinzufügen oder ändern, verwenden Sie diesen Befehl, um die Berechtigungen für Ihren Agent-Blueprint zu aktualisieren.

Dieser Befehl:

• Liest Ihre MCP-Serverkonfiguration aus Ihrem Code.
• Aktualisiert den Agent-Blueprint mit den erforderlichen Berechtigungen.
• Gewährt erforderliche API-Berechtigungen für die MCP-Server.

Das Berechtigungsupdate gilt in der folgenden Reihenfolge:

1. OAuth2-Berechtigungserteilung (Blueprint-Dienstprinzipal → MCP-Plattform)
2. Vererbbare Berechtigungen (Agent-Blueprint → MCP-Ressource)
3. Administratorzustimmung (Agentidentität → MCP-Plattform)

Wann verwendet werden soll deploy mcp:

• Nachdem Sie Ihrem Agent neue MCP-Server hinzugefügt haben.
• Nach dem Ändern der MCP-Serverkonfigurationen.
• Wenn auf MCP-Tools nicht für Ihren Agent zugegriffen werden kann.

Sie müssen nicht ausführen deploy mcp:

• Bei der erstbereitstellung. Dies wird während des Setups automatisch behandelt.
• Wenn nur die Agentlogik ohne MCP-Änderungen geändert wird.
• Nach Routinecodeaktualisierungen, die sich nicht auf die Toolerstellung auswirken.

Problembehandlung

Verwenden Sie die folgenden Abschnitte, um potenzielle Probleme mit dem deploy Befehl zu beheben.

• Not logged in Azure or wrong subscription
• Web App nicht gefunden
• Fehler bei der Berechtigungsaktualisierung
• --restart Fehlschlägt

Nicht bei Azure oder falschem Abonnement angemeldet

Führen Sie az login --tenant <TENANT_ID> und az account set --subscription <SUBSCRIPTION_ID> aus.

Web App nicht gefunden

Stellen Sie sicher, dass ausgeführt wurde, oder stellen Sie sicher a365 setup , dass webAppName sie resourceGroup korrekt a365.config.jsonsind.

Fehler bei der Berechtigungsaktualisierung

• Bestätigen AgentBlueprintId, , AgenticAppId, und Umgebung sind festgelegt in a365.config.json.
• Stellen Sie sicher, dass Ihr Konto über Berechtigungen zum Verwalten von Dienstprinzipalen und Zuschüssen verfügt.
• Überprüfen Sie, ob toolingManifest.json es in Ihrem Bereitstellungsprojektverzeichnis vorhanden ist und gültige Bereiche enthält.

--restart funktioniert nicht

Führen Sie eine vollständige Bereitstellung aus, ohne --restart den publish/ Ordner zu erstellen, und verwenden Sie --restart dann für nachfolgende Iterationen.

Logs

CLI-Protokolldateien werden unter:

• Windows: %LocalAppData%\Microsoft.Agents.A365.DevTools.Cli\logs\
• Linux/macOS: ~/.config/a365/logs/

Um die letzten 80 Zeilen der neuesten Bereitstellungsprotokolldatei anzuzeigen, verwenden Sie Get-Content auf Windows oder tail unter Linux/macOS:

# Windows
Get-Content $env:LOCALAPPDATA\Microsoft.Agents.A365.DevTools.Cli\logs\a365.deploy.log -Tail 80

# Linux/macOS
tail -80 ~/.config/a365/logs/a365.deploy.log

Verwenden Sie für Laufzeitanwendungsprotokolle Log Stream im Azure-Portal für stdout/stderr aus Ihrem App Service.