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.
Sie müssen die CLI nicht manuell installieren. Das KI-geführte Setup überprüft die CLI, installiert oder aktualisiert sie automatisch und führt alle erforderlichen Befehle in Ihrem Auftrag aus. Diese Seite ist ein Verweis für Entwickler, die die CLI direkt installieren oder verwenden müssen , z. B. beim Erstellen der CI/CD-Automatisierung, beim Beheben eines bestimmten Schritts oder beim Arbeiten ohne KI-Codierungs-Agent.
Hinweis
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. Alle anderen Voraussetzungen – Azure Abonnement, erforderliche Entra-Rollen und benutzerdefinierte Client-App-Registrierung – finden Sie unter AI-guided setup.
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.
Buchen
Aktualisieren Sie die Agent 365-CLI mit dem dotnet-Tool-Update-Befehl :
dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli
Hinweis
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.
Deinstallieren
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:
| BS | 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.
Tipp
Sie müssen CLI-Befehle nicht manuell ausführen. Das KI-geführte Setup automatisiert den vollständigen Workflow – CLI-Installation, Konfiguration, Blueprint-Einrichtung, Bereitstellung und Veröffentlichung – mit einem KI-Codierungs-Agent. 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.
Problembehandlung
Dieser Abschnitt bietet Informationen darüber, wie man Fehler mit Agent 365 CLI behebt.
Tipp
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