Teilen über

Agent 365 CLI

Wichtig

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-Vorschauversionen unterliegen den bestehenden Vorschauversionsbedingungen Ihrer Kundenvereinbarungen. Da sich diese Funktionen noch in der Entwicklung befinden, können sich ihre Verfügbarkeit und Merkmale im Laufe der Zeit ändern.

Agent 365 CLI ist ein plattformübergreifendes Befehlszeilentool zum Bereitstellen und Verwalten von Agent 365-Anwendungen in Azure.

Voraussetzungen

Bevor Sie beginnen, stellen Sie folgendes sicher:

  • Registrierung einer benutzerdefinierten Client-App – Die CLI erfordert eine benutzerdefinierte Client-App in Ihrem Microsoft Entra-ID-Tenant zur Authentifizierung. Siehe Custom Client App Registrierung für detaillierte Einrichtungsanweisungen. Du brauchst die Anwendungs-(Client-)ID während der Konfiguration.
  • Azure-Abonnement – Zugang zu einem Azure-Abonnement, mit dem Sie Ressourcen erstellen können.
  • Erforderliche Berechtigungen – Ihr Konto muss eine der folgenden Rollen haben:

Anmerkung

Während des Schrittes (nach der a365 config init Installation) validiert die CLI automatisch die Registrierung deiner benutzerdefinierten Client-App, prüft, ob die App existiert, die erforderlichen Berechtigungen hat und die Zustimmung des Administrators erteilt wurde.

Tipp

Verschiedene CLI-Befehle können unterschiedliche Rollen oder Berechtigungen erfordern. Jede Befehlsreferenzseite gibt die erforderliche Mindestrolle an. Siehe zum Beispiel die setup Kommandoreferenz für die spezifischen Anforderungen.

Installieren der Agent 365 CLI

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.)

Dotnet Tool-Installation verwenden

Installieren Sie die Agent 365 CLI mit folgendem Befehl und dem Parameter --prerelease :

dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease

Wichtig

Die Agent 365 CLI befindet sich noch in der Vorschau. Bis die Agent 365 CLI allgemein verfügbar ist, verwenden Sie immer den Parameter, --prerelease um die neueste Version mit den neuesten Fixes und Funktionen zu erhalten. Wenn die Agent 365 CLI allgemein verfügbar wird, wird der Parameter --prerelease nicht mehr notwendig sein.

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

Überprüfen Sie nach der Installation der Agent 365 CLI, ob sie ordnungsgemäß installiert ist, indem Sie Folgendes ausführen:

a365 -h

Mit diesem Befehl werden die Hilfeinformationen angezeigt und bestätigt, dass die CLI einsatzbereit ist.

Aktualisieren

Aktualisieren Sie Agent 365 CLI, indem Sie den Update-Befehl dotnet tool mit folgendem --prerelease Parameter verwenden:

dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli --prerelease

Anmerkung

Alle Updates für Agent 365 CLI erfordern 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

Datei-Lagerplätze

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

Dieser Speicherort wird dem Benutzerpfad hinzugefügt, wenn das SDK zum ersten Mal ausgeführt wird. Daher können globale Tools von jedem Verzeichnis aus aufgerufen werden, ohne den Speicherort des Tools 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 hat.

Verfügbare Befehle

Die vollständige Liste der verfügbaren Befehle finden Sie unter --helpAgent 365 CLI-Referenz

Wichtige Neuigkeiten

Entfernter Befehl: Das Kommando create-instance wurde aus der CLI entfernt. Es umging die erforderlichen Registrierungsschritte, was die Funktionalität des Agenten einschränkte. Dieser Befehl kann in einer späteren Version wieder eingeführt werden, sobald er dem empfohlenen Workflow entspricht.

Siehe Agent 365 Development Lifecycle für vollständige Anweisungen, wie man einen Agent 365-Agenten mit der CLI einrichtet.

Problembehandlung

Dieser Abschnitt enthält Informationen zum Troubleshooting von Fehlern mit Agent 365 CLI.

Installation, Aktualisierung oder Deinstallation der CLI fehlschlägt mit Not found in NuGet feeds

Wenn Sie einen microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json Fehler erhalten, stellen Sie sicher, dass Sie den Parameter --prerelease verwenden. Alle aktuellen Versionen der CLI sind Vorabversionen.

Solution:

# For installation
dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease

# For updates
dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli --prerelease

Die neuesten Anweisungen und verfügbaren Versionen finden Sie auf der offiziellen NuGet-Seite: Microsoft.Agents.A365.DevTools.Cli auf NuGet.org

Befehl create-instance nicht gefunden

Symptom:

Error: Command 'create-instance' not found

Verursachen: Das Kommando create-instance wurde aus der CLI entfernt. Es umging die erforderlichen Registrierungsschritte, was die Funktionalität des Agenten einschränkte. Dieser Befehl kann in einer späteren Version wieder eingeführt werden, sobald er dem empfohlenen Workflow entspricht.

Solution:

Nutzen Sie den aktualisierten Workflow:

  1. Veröffentlichen Sie Ihren Agenten:

    a365 publish

  2. Agenten-Blueprint im Developer Portal konfigurieren:

    Erfahren Sie, wie man einen Agenten-Blueprint im Teams Developer Portal konfiguriert

  3. Deploy to Azure (optional):

    # Only if hosting on Azure Web App
a365 deploy

  4. Erstellen Sie eine Agenteninstanz über Microsoft Teams:

    • Öffne Microsoft Teams
    • Navigiere zu Apps
    • Suche nach deinem Makler
    • Klicken Sie auf "Add", um eine Agenteninstanz zu erstellen.

Für detaillierte Anweisungen siehe Onboard-Agenten.

Agent erscheint nicht in Teams

Symptom: Nach Ausführung der Befehle erscheint der Agent nicht mehr in Microsoft Teams.

Verursachen: Vielleicht hast du den publish Schritt übersprungen oder versucht, den entfernten create-instance Befehl zu verwenden.

Solution:

  1. Überprüfen Sie, dass Sie erfolgreich gelaufen sind a365 publish
  2. Warten Sie 5-10 Minuten auf die Weiterleitung
  3. Überprüfen Sie das Microsoft 365 Admin Center: https://admin.cloud.microsoft/#/agents/all
  4. Erstelle eine Agent-Instanz im Bereich Teams Apps

Agent-Instanz in Teams kann nicht erstellt werden

Symptom: Der Agent erscheint in Teams, aber du kannst keine Agenteninstanz erstellen (du kannst den Agenten nicht hinzufügen).

Verursachen: Die Lizenz "Microsoft Agent 365 Frontier" wird nicht Ihrem Benutzerkonto zugewiesen.

  • Last updated on