Freigeben ü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 Agent 365 CLI mit dem folgenden Befehl.:

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

Wenn du einen microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json Fehler erhältst, verwende den Parameter --prerelease , da dieses Paket möglicherweise trotzdem als Prerelease markiert ist.

dotnet tool install --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

Ü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 die Agent 365-CLI mit dem dotnet-Tool-Update-Befehl :

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

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.

Verwenden Sie stattdessen diesen Workflow:

  1. a365 publish - Agent veröffentlichen im Microsoft 365 Admin Center
  2. Agent Blueprint im Developer Portal konfigurieren – siehe Agent Blueprint konfigurieren im Developer Portal
  3. a365 deploy - Deploy in Azure (optional, nur bei Verwendung von Azure-Hosting)
  4. Erstellen einer Agentinstanz über Microsoft Teams

Siehe Onboard-Agenten für vollständige Anweisungen.

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 du einen microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json Fehler erhältst, verwende den Parameter --prerelease , da dieses Paket möglicherweise trotzdem als Prerelease markiert ist.

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:

    Siehe Agent Blueprint konfigurieren im Developer Portal für detaillierte Anweisungen.

  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