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 du mit dem Agents Toolkit startest, hast du alles eingerichtet, um sofort den Agents Playground zu testen. Sie können im Agents Playground entweder lokal oder in Microsoft Copilot oder Microsoft Teams testen. Dieses Szenario wird in folgenden Themen behandelt:

Starten Sie Ihr Projekt durch Klonen oder mit der CLI

Wenn du dein Projekt startest, indem du die CLI nutzt oder ein Beispiel klonst und in deiner IDE öffnest, kannst du den lokalen Agents Playground zum Testen nutzen. Der Agents Playground verbindet sich mit Ihrem lokalen Code.

Du kannst 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 du deinen Quickstart-Agent erstellt oder ein Sample aus dem Repository geklont hast, verwende es mit dem Agents Playground.

  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ähle einen verfügbaren Port für deinen Agenten (standardmäßig ist 3978, aber du kannst 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"

    Wenn dein Agent startet, öffnet er sich, wie im folgenden Bild zu sehen ist. Sie können Fragen stellen und Ihren Agenten auf der Spielplatzschnittstelle testen.

    Microsoft 365 Agents Playground

Wo immer möglich, beginnen Sie mit dem Microsoft 365 Agents Toolkit. Das Toolkit erleichtert die ersten Schritte, das lokale Testen und die Bereitstellung, indem es einfacher und schneller ist. Es abstrahiert einen Großteil der manuellen Einrichtung von Azure Bot Service und Azure App-Registrierungen, sodass man das nicht tun muss. Durch manuelles Starten müssen Sie diese manuellen Schritte selbst ausführen.

Zusammenfassung

Sie haben Ihr Microsoft 365 Agents SDK lokal mit dem Microsoft 365 Agents Playground getestet. Du hast mit einem geklonten Sample aus dem GitHub-Repository oder aus der CLI begonnen.

  • Zuletzt aktualisiert um