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:

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

Starten Des Projekts mit dem Toolkit

Wenn Sie mit dem Agents 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 in folgenden Themen behandelt:

Starten Sie Ihr Projekt durch Klonen oder mit der CLI

Wenn Sie Ihr Projekt mit der CLI starten oder ein Beispiel klonen und 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

Testen Sie Ihren Agenten

  1. Nachdem Sie Ihren Schnellstart-Agent erstellt oder ein Beispiel aus dem Repository geklont haben, können Sie es mit dem Agents-Playground verwenden.

  2. Der Agents-Playground unterstützt sowohl anonyme als auch authentifizierte Modi. Für anonyme Tests ist keine andere Konfiguration erforderlich. Wenn Sie die Authentifizierung testen möchten, müssen Sie Microsoft Entra ID-App-Registrierungen sowohl für den Agents-Playground (Optionen werden im folgenden Text bereitgestellt) als auch für Ihre Anwendung konfigurieren. 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 (Standard ist 3978, Sie können jedoch jeden verfügbaren Port verwenden).

  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"

    Schlüsseloptionen:

    • -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 beide angegeben sind, 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 Ihr Agent gestartet wird, wird er sich wie in der folgenden Abbildung öffnen. 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 lokal mit dem Microsoft 365 Agents Playground getestet, beginnend mit einem geklonten Beispiel aus dem GitHub-Repository oder der CLI.

  • Last updated on