Agent lokal im Microsoft 365 Agents-Playground testen

Die Einzelheiten, wie Sie Ihren Agenten lokal testen, hängen davon ab, wie Sie Ihren Agenten erstellt haben.

Sie können einen Agenten 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 Sie ein Beispiel und öffnen Sie es in Ihrer IDE
  • Verwenden der Befehlszeilenschnittstelle

Starten Sie Ihr Projekt mit dem Toolkit

Wenn Sie mit dem Agents Toolkit starten, ist alles direkt eingerichtet, sodass Sie sofort im Agents Playground testen können. Sie können im Agents Playground entweder lokal oder in Microsoft 365 Copilot oder Microsoft Teams testen. Dieses Szenario wird behandelt in:

Starte dein Projekt, indem du das Repository klonst oder die CLI verwendest

Wenn du dein Projekt mit dem CLI startest oder ein Beispiel klonst und es in deiner IDE öffnest, kannst du das lokale Agents Playground zum Testen nutzen. Der Agents Playground verbindet sich mit deinem lokalen Code.

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

Option 1: Installieren Sie das Standalone-Binary

winget install agentsplayground

Option 2: Installieren mit NPM

  • Installiere Node.js (falls nicht schon installiert): Lade die neueste Node.js von nodejs.org herunter und installiere sie.

  • Installieren Sie das Agents Playground-Paket:

    Für die globale Installation (empfohlen):

    npm install -g @microsoft/m365agentsplayground

    Für die projektspezifische Installation:

    npm install -D @microsoft/m365agentsplayground

Agent testen

  1. Sobald Sie Ihren Quickstart-Agent erstellt oder ein Beispiel aus dem Repository geklont haben, können Sie ihn mit der Agents Playground verwenden.

  2. Der Agents Playground unterstützt sowohl anonyme als auch authentifizierte Modi. Für anonyme Tests ist keine weitere Konfiguration erforderlich. Wenn Sie mit Authentifizierung testen möchten, müssen Sie Microsoft Entra ID-App-Registrierungen sowohl für den Agents Playground (Optionen werden im folgenden Text erläutert) 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 korrekt in Ihrer App. Wählen Sie einen freien Port für Ihren Agenten aus (Standard ist 3978, aber Sie können jeden verfügbaren Port nutzen).

  4. Führen Sie Ihren Code aus.

  5. Öffnen Sie den Agents Playground und starten Sie mit dem Endpunkt Ihres Agenten:

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

    Konfigurieren Sie die Authentifizierung, falls dies von Ihrem Agenten erforderlich ist:

    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: Die Endpoint-URL Ihres Agenten (zum Beispiel http://localhost:3978/api/messages)
    • -c, --channel-id: Kanaltyp (zum Beispiel emulator, webchat, ). msteams Jeder Kanal bietet unterschiedliche Nutzererfahrungen und Aktivitätseigenschaften.
    • --client-idClient-ID für die Authentifizierung
    • --client-secretDer geheime Schlüssel für die Authentifizierung
    • --tenant-id: Mandanten-ID für die Authentifizierung

    Siehe agentsplayground --help die Vollständige Liste der öffentlichen Optionen anzuzeigen.

    Alternativ können Sie Umgebungsvariablen anstelle von CLI-Optionen verwenden. Wenn beide angegeben sind, hat die CLI-Option Vorrang.

    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"

    Sobald Ihr Agent gestartet ist, sollte er sich wie im folgenden Bild öffnen. Sie können Fragen stellen und Ihren Agenten in der Playground-Oberfläche testen.

    Microsoft 365 Agents Playground

Wo immer möglich, empfehlen wir, mit dem Microsoft 365-Agents-Toolkit zu beginnen. Das Toolkit erleichtert den Einstieg, das lokale Testen und die Bereitstellung und beschleunigt diese. Dies abstrahiert die manuelle Einrichtung des Azure Bot Service und der Azure-App-Registrierungen, sodass Sie sich nicht darum kümmern müssen. Wenn Sie manuell beginnen, 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, beginnend mit einer geklonten Probe aus dem GitHub-Repo oder aus der CLI.

  • Last updated on