Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Agent 365 CLI ist ein plattformübergreifendes Befehlszeilentool zum Bereitstellen und Verwalten von Agent 365-Anwendungen auf Azure.
Du musst die CLI nicht manuell installieren.Agent 365 Skills prüfen die CLI, installieren oder aktualisieren sie automatisch und führen alle erforderlichen Befehle in Ihrem Namen aus. Dieser Artikel ist eine Referenz für Entwickler, die die CLI direkt installieren oder nutzen müssen – zum Beispiel beim Bau von CI/CD-Automatisierung, bei der Fehlersuche eines bestimmten Schrittes oder bei der Arbeit ohne KI-Codieragenten.
Note
Der vollständige Entwicklerworkflow – einschließlich KI-geführter Setup, Rollenleitfaden und Schritte nach der Bereitstellung – befindet sich in "Erste Schritte mit der Agent 365-Entwicklung". Diese Seite ist die CLI-Referenz: Installation, Update, Deinstallation, verfügbare Befehle und Problembehandlung.
Voraussetzungen
Die CLI erfordert .NET 8,0 oder höher. Für alle anderen Voraussetzungen – Azure-Abonnement, erforderliche Entra-Rollen und Registrierung für benutzerdefinierte Client-Apps – siehe Quickstart: Verbinden Sie einen bestehenden Agent mit Agent 365.
Agent 365 CLI installieren
Führen Sie die folgenden Schritte aus, um die Agent 365 CLI global auf Ihrem Betriebssystem zu installieren.
Voraussetzungen
Sie müssen .NET installiert haben. (.NET 8.0 wird empfohlen.)
Verwenden Sie dotnet tool install
Installieren Sie die Agent 365 CLI mithilfe des folgenden Befehls:
dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli
Die neuesten Anweisungen und verfügbaren Versionen finden Sie auf der offiziellen NuGet-Seite: Microsoft.Agents.A365.DevTools.Cli auf NuGet.org
Überprüfen der Installation
Nach der Installation der Agent 365 CLI überprüfen Sie, ob sie korrekt installiert ist, indem Sie den Befehl --help ausführen:
a365 -h
Mit diesem Befehl werden die Hilfeinformationen angezeigt und bestätigt, dass die CLI einsatzbereit ist.
Update
Aktualisieren Sie die Agent 365-CLI mit dem dotnet-Tool-Update-Befehl :
dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli
Note
Um Agent 365 CLI zu aktualisieren, benötigen Sie eine Internetverbindung, um auf das neueste NuGet-Paket zugreifen zu können: Microsoft.Agents.A365.DevTools.Cli.
Uninstall
Deinstallieren Sie die Agent 365-CLI mit dem dotnet-Tool-uninstall-Befehl:
dotnet tool uninstall --global Microsoft.Agents.A365.DevTools.Cli
Dateispeicherorte
Der Standardspeicherort für die ausführbare Datei eines Tools hängt vom Betriebssystem ab:
| OS | Pfad |
|---|---|
| Linux/macOS | $HOME/.dotnet/tools |
| Windows | %USERPROFILE%\.dotnet\tools |
Das SDK fügt diesen Standort zu deinem Pfad hinzu, wenn du ihn zum ersten Mal startest. Du kannst also globale Werkzeuge aus jedem Verzeichnis aufrufen, ohne den Tool-Standort anzugeben.
Der Toolzugriff ist benutzerspezifisch und nicht global für Computer. Ein globales Tool steht nur dem Benutzer zur Verfügung, der das Tool installiert.
Verfügbare Befehle
Für die vollständige Liste der verfügbaren Befehle verwenden Sie den --help Befehl oder siehe Agent 365 CLI Reference.
Tip
Sie müssen CLI-Befehle nicht manuell ausführen. Agent 365 Skills automatisieren den gesamten Arbeitsablauf – CLI-Installation, Konfiguration, Blueprint-Einrichtung, Bereitstellung und Veröffentlichung – mithilfe eines KI-Coding-Agenten. Verwenden Sie die CLI-Referenz hier, wenn Sie CI/CD-Automatisierung entwickeln, einen bestimmten Schritt beheben oder ohne einen KI-Codierungs-Agent arbeiten.
Vollständige Anweisungen zum Einrichten eines Agent 365-Agents mithilfe der CLI finden Sie unter Erste Schritte mit der Agent 365-Entwicklung.
Troubleshooting
Dieser Abschnitt bietet Informationen darüber, wie man Fehler mit Agent 365 CLI behebt.
Tip
Der Agent 365 Troubleshooting Guide enthält übergeordnete Empfehlungen zur Fehlerbehebung, Best Practices und Links zu Inhalten zur Fehlerbehebung für jeden Teil des Entwicklungszyklus von Agent 365.
CLI-spezifische Themen, die in diesem Abschnitt behandelt werden:
Agent erscheint nicht in Teams
Fehlerbehebung bei der Erstellung von Agenteninstanzen: Agent erscheint nicht in Teams
Kann keine Agenteninstanz in Teams erstellen
Probleme mit Agenteninstanzen beheben: Kann keine Agenteninstanz in Microsoft Teams erstellen