Freigeben über

Testen Ihres Agents lokal in Microsoft 365 Agents Playground

Die Details zum lokalen Testen Ihres Agents hängen davon ab, wie Sie Ihren Agent erstellt haben.

Sie können einen Agent mit dem Microsoft 365 Agents SDK auf drei Arten erstellen:

  • Klonen aus einem Beispiel und Öffnen in Ihrer IDE
  • Beginnen Sie mit dem Microsoft 365 Agents Toolkit in C#, JS oder Python mit Visual Studio oder Visual Studio Code
  • Verwenden Sie die CLI, wie in der Schnellstartanleitung gezeigt

Verwenden des Microsoft 365 Agents Playground

Sie haben Ihr Projekt mit dem Toolkit gestartet.

Wenn Sie mit dem Toolkit beginnen, haben Sie alles eingerichtet, um den Agents-Playground sofort zu testen. Sie können entweder lokal oder in Microsoft 365 Copilot oder Microsoft Teams im Agents-Playground testen. Dieses Szenario wird sowohl in der Anleitung von Visual Studio Code als auch in der von Visual Studio behandelt.

Sie haben Ihr Projekt durch Klonen oder CLI gestartet

Wenn Sie Ihr Projekt mit der CLI beginnen oder ein Beispiel klonen und das Beispiel in Ihrer IDE öffnen, können Sie den lokalen Agents-Playground zum Testen verwenden. Der Agents Playground verbindet sich mit Ihrem lokalen Code.

Sie können den Agents-Playground mit einer der folgenden Methoden installieren:

Option 1: Installieren der eigenständigen Binärdatei
winget install agentsplayground
Option 2: Installieren mit npm

  • Installieren Sie Node.js (sofern noch nicht installiert): Laden Sie die neuesten Node.js von nodejs.org herunter, und installieren Sie sie.

  • Installieren Sie das Agents Playground-Paket:

    Für die globale Installation (empfohlen):

    npm install -g @microsoft/m365agentsplayground

    Für projektspezifische Installation:

    npm install -D @microsoft/m365agentsplayground

  1. Sobald Ihr Schnellstart-Agent erstellt wurde oder ein Beispiel aus dem Repository geklont wird, können Sie ihn mit dem Agents-Playground verwenden.

  2. Der Agents-Playground unterstützt sowohl anonyme als auch authentifizierte Modi. Für anonyme Tests ist keine zusätzliche Konfiguration erforderlich. Wenn Sie die Authentifizierung testen möchten, müssen Sie Microsoft Entra ID-App-Registrierungen sowohl für den Agents-Playground konfigurieren (Optionen sind unten angegeben) als auch Für Ihre Anwendung. Weitere Informationen finden Sie unter Bereitstellen eines Azure Bots für die Verwendung mit Agents SDK.

  3. Konfigurieren Sie Ihre Ports ordnungsgemäß in Ihrer App. Wählen Sie einen verfügbaren Port für Ihren Agent aus (Der Standardwert ist 3978, kann aber ein beliebiger verfügbarer Port sein).

  4. Führen Sie Ihren Code aus.

  5. Öffnen Sie den Agents-Playground, und beginnen Sie mit dem Endpunkt Ihres Agents:

    agentsplayground -e "http://localhost:<your-agent-port>/api/messages" -c "emulator"

    Konfigurieren Sie die Authentifizierung, falls von Ihrem Agenten erforderlich.

    agentsplayground -e "http://localhost:<your-agent-port>/api/messages" -c "emulator" --client-id "your-client-id" --client-secret "your-client-secret" --tenant-id "your-tenant-id"

    Wichtige Optionen:

    • -e, --app-endpoint: Endpunkt-URL Ihres Agents (z. B. http://localhost:3978/api/messages)
    • -c, --channel-id: Kanaltyp (z. B. , emulator, webchat). msteams Jeder Kanal bietet unterschiedliche Benutzerfreundlichkeits- und Aktivitätseigenschaften.
    • --client-id: Client-ID für die Authentifizierung
    • --client-secret: Geheimer Clientschlüssel für die Authentifizierung
    • --tenant-id: Mandanten-ID für die Authentifizierung

    Verwenden Sie agentsplayground --help, um die vollständige Liste der verfügbaren Optionen anzuzeigen.

    Alternativ können Sie Umgebungsvariablen anstelle von CLI-Optionen verwenden. Wenn beides angegeben ist, hat die CLI-Option eine höhere Priorität.

    export BOT_ENDPOINT="http://localhost:<your-agent-port>/api/messages"
export DEFAULT_CHANNEL_ID="emulator"
export AUTH_CLIENT_ID="your-client-id"
export AUTH_CLIENT_SECRET="your-client-secret"
export AUTH_TENANT_ID="your-tenant-id"

    Nachdem sie gestartet wurde, sollte sie geöffnet werden, wie in der folgenden Abbildung zu sehen ist. Sie können Fragen stellen und Ihren Agenten auf der Spielplatzschnittstelle testen.

    Microsoft 365 Agents Playground

Wo immer möglich, empfehlen wir, mit dem Microsoft 365 Agents Toolkit zu beginnen. Das Toolkit erleichtert die ersten Schritte, das lokale Testen und die Bereitstellung, indem es einfacher und schneller ist. Es vereinfacht die manuelle Einrichtung des Azure-Bot-Dienstes und der Azure-App-Registrierungen, sodass Sie sich darum nicht kümmern müssen. Durch manuelles Starten müssen Sie diese manuellen Schritte selbst ausführen.

Summary

Sie haben Ihr Microsoft 365 Agents SDK erfolgreich mithilfe des Microsoft 365 Agents Playground lokal getestet, wenn Sie mit einem geklonten Beispiel aus dem GitHub-Repository oder der CLI beginnen.

  • Last updated on