Debuggen Ihres KI-Chatbots mithilfe von Microsoft 365 Agents Playground
Starten Sie die Entwicklung von Microsoft Teams-Apps mit Ihrer Teams KI-Chatbot-App, und debuggen Sie sie mit Microsoft 365 Agents Playground (früher als Teams App Test Tool bezeichnet). Agents Playground ermöglicht das mühelose Debuggen von botbasierten Apps. Sie benötigen kein Microsoft 365-Entwicklerkonto, kein Tunneling oder keine Teams-App- und Bot-Registrierung, um Agents Playground verwenden zu können.
Sie können mit Ihrem Bot chatten und die Nachrichten und adaptiven Karten so anzeigen, wie sie in Teams angezeigt werden. Sie können auch eine Aktivität in Agents Playground mithilfe von Aktivitätstriggern simulieren.
Hinweis
- Agents Playground ist nur in Version 5.4.0 des Microsoft 365 Agents Toolkit (früher als Teams Toolkit bezeichnet) verfügbar.
- Agents Playground wird nur für Desktop- und Webclients unterstützt.
Diese Schritt-für-Schritt-Anleitung hilft Ihnen beim Erstellen eines KI-Chatbots mithilfe des Agents Toolkits und beim Debuggen mit dem Testtool. Nach Abschluss dieses Leitfadens wird die folgende Ausgabe angezeigt, in der der Benutzer auf den KI-Chat-Bot zugreifen und diesen verwenden kann:
Voraussetzungen
Stellen Sie sicher, dass Sie die folgenden Tools zum Erstellen und Bereitstellen Ihrer Apps installieren.
| Installieren | Zum Benutzen... |
|---|---|
| Visual Studio Code oder Visual Studio | JavaScript-, TypeScript- oder C#-Buildumgebungen. Verwenden Sie die neueste Version. |
| Microsoft 365 Agents Toolkit | Microsoft Visual Studio Code-Erweiterung, die ein Projektgerüst für Ihre App erstellt. Verwenden Sie Agents Toolkit v5.4.0. Weitere Informationen finden Sie unter Installieren des Agents Toolkits. |
| Node.js | Back-End-JavaScript-Laufzeitumgebung. Weitere Informationen finden Sie unter Node.js Versionskompatibilitätstabelle für den Projekttyp. |
| OpenAI oder Azure OpenAI | Erstellen Sie zunächst Ihren OpenAI-API-Schlüssel, um das GPT von OpenAI zu verwenden. Wenn Sie Ihre App hosten oder auf Ressourcen in Azure zugreifen möchten, müssen Sie einen Azure OpenAI-Dienst erstellen. |
| Microsoft Edge (empfohlen) oder Google Chrome | Ein Browser mit Entwicklertools. |
Erstellen eines Projektarbeitsbereichs für Ihre KI-Chat-Bot-App
Lassen Sie uns Ihre KI-Chat-Bot-App erstellen.
Die Botfunktion einer Teams-App erstellt einen Chatbot oder einen Konversationsbot. Es kommuniziert mit einem Webdienst und erleichtert die Nutzung seiner Dienste. Der Bot kann einfache, automatisierte Aufgaben wie die Bereitstellung von Kundendienst ausführen. Sie können Wettervorhersagen erhalten, Reservierungen vornehmen oder andere Dienste, die mithilfe eines Konversationsbots angeboten werden.
Da Sie sich bereits auf die Erstellung dieser Apps vorbereitet haben, können Sie ein neues Teams-Projekt zum Erstellen der KI-Chatbot-App einrichten. In diesem Tutorial erfahren Sie Folgendes:
- Erstellen Sie Ihren Botprojektarbeitsbereich.
- Machen Sie sich einen Überblick über den Quellcode der Bot-App.
Erstellen Ihres Arbeitsbereichs für bot-Projekte
Wenn die Voraussetzungen erfüllt sind, fangen wir an!
Öffnen Sie Visual Studio Code.
Wählen Sie das Symbol Microsoft 365 Agents Toolkit
in der Visual Studio Code-Aktivitätsleiste aus.Wählen Sie Create a New Agent/App (Neuen Agent/neue App erstellen) aus.
Auswählen von Agents für Teams
Wählen Sie Grundlegende Agents für Teams aus. Wenn Sie eine andere Funktionalität für Ihren Bot benötigen, wählen Sie die erforderliche Option aus.
Wählen Sie Azure OpenAIInput Azure API service key now (Azure OpenAI > Input Azure API service key now) aus. JavaScript.
Wählen Sie Standardordneraus.
Führen Sie die folgenden Schritte aus, um den Standardspeicherort zu ändern:
Wählen Sie Durchsuchen aus.
Wählen Sie den Speicherort für den Projektarbeitsbereich aus.
Wählen Sie Ordner auswählen aus.
Geben Sie einen geeigneten Namen für Ihre App ein, und drücken Sie dann die EINGABETASTE .
Es wird ein Dialogfeld angezeigt, in dem Sie ja oder nein auswählen müssen, um den Autoren der Dateien in diesem Ordner zu vertrauen.
Nun haben Sie erfolgreich ihren Ki-Chat-Bot-Projektarbeitsbereich erstellt.
Machen Sie einen Überblick über den Quellcode der Bot-App
Nachdem Sie das Gerüst erstellt haben, erkunden Sie die Projektverzeichnisse und -dateien im Explorer-Abschnitt von Visual Studio Code.
| Ordner- oder Dateiname | Inhalt |
|---|---|
env/.env.playground |
Die Konfigurationsdatei mit Umgebungsvariablen, die an Git committet werden können. |
env/.env.playground.user |
Die Konfigurationsdatei mit Umgebungsvariablen, einschließlich Anmeldeinformationen, die standardmäßig nicht an Git committet werden. |
appPackage |
App-Manifestvorlagendateien und App-Symbole (color.png und outline.png). |
appPackage/manifest.json |
App-Manifest zum Ausführen der App in einer lokalen und Remoteumgebung. |
src/app.js |
Verarbeitet Geschäftslogiken für den KI-Chatbot. |
m365agents.yml |
Dies ist die Standard Agents Toolkit-Projektdatei. Die Projektdatei definiert zwei Hauptbegriffe: Eigenschaften und Konfigurations- und Phasendefinitionen. |
m365agents.local.yml |
Dies wird mit Aktionen überschrieben m365agents.yml , die die lokale Ausführung und das Debuggen ermöglichen. |
m365agents.playground.yml |
Dies überschreibt m365agents.yml Aktionen, die die lokale Ausführung und das Debuggen im Testtool ermöglichen. |
Erstellen und Ausführen Ihrer KI-Chat-Bot-App
Nachdem Sie Ihren Projektarbeitsbereich mit dem Agents Toolkit eingerichtet haben, erstellen Sie Ihr KI-Chatbotprojekt.
Erstellen eines Open KI-Schlüssels und -Endpunkts für Ihren KI-Chat-Bot
Navigieren Sie zum Azure-Portal.
Wählen Sie Ressource erstellen aus, und suchen Sie nach Azure Open AI.
Wählen Sie Azure Open AI und dann Erstellen aus.
Geben Sie die erforderlichen Details ein, und wählen Sie Weiter aus.
Wählen Sie Alle Netzwerke, einschließlich des Internets, können auf diese Ressource zugreifen aus, und wählen Sie dann Weiter aus.
Geben Sie die erforderlichen Details ein, und wählen Sie Weiter aus.
Wählen Sie Erstellen aus.
Sie haben erfolgreich Schlüssel und Endpunkt für Ihren KI-Chat-Bot erstellt.
Hinweis
Sie können auch den OpenAI-API-Schlüssel abrufen, um Ihren KI-Chat-Bot zu debuggen. Weitere Informationen finden Sie unter Einrichten Ihres API-Schlüssels.
Abrufen von Azure Open AI-Schlüsseln und -Endpunkten
Wählen Sie Zu Ressourcen wechseln aus.
Wählen Sie im linken Bereich Schlüssel und Endpunkt aus, und kopieren Sie den SCHLÜSSEL und den Endpunkt. Sie können entweder KEY 1 oder KEY 2 kopieren.
Speichern Sie den SCHLÜSSEL und den Endpunkt zur weiteren Verwendung.
Wählen Sie im linken Bereich Modellbereitstellungen und dann Bereitstellungen verwalten aus.
Das Fenster Azure Open AI Studio wird angezeigt.
Wählen Sie im linken Bereich Bereitstellungen und dann + Neue Bereitstellungen erstellen aus.
Wählen Sie die folgenden Details aus:
- Wählen Sie gpt-35-turbo aus der Dropdownliste Modell auswählen aus.
Hinweis
Für den KI-Chat-Bot wird nur das gpt-35-turbo-Modell unterstützt.
- Wählen Sie 0301 (Standard) aus der Dropdownliste Modellversion aus.
- Geben Sie Bereitstellungsname ein , und wählen Sie Erstellen aus.
- Wählen Sie gpt-35-turbo aus der Dropdownliste Modell auswählen aus.
Kopieren Und speichern Sie den Bereitstellungsnamen zur weiteren Verwendung.
Aktualisieren von Azure Open AI-Schlüsseln und -Endpunkten
Öffnen Sie Ihr Projekt in Visual Studio Code.
Wechseln Sie unter EXPLORER zur Datei env.env.playground.user>.
Geben Sie Ihre SECRET_AZURE_OPENAI_API_KEY und SECRET_AZURE_OPENAI_ENDPOINT ein.
... SECRET_AZURE_OPENAI_API_KEY=<azure-openai-api-key> SECRET_AZURE_OPENAI_ENDPOINT=<azure-openai-endpoint>Wechseln Sie zu src>app.js Datei.
Kommentieren Sie den
OpenAICode aus, und heben Sie die Auskommentierung des Codes aufAzure OpenAI.Geben Sie den Namen Ihrer Azure Open AI-Bereitstellung in ein
azureDefaultDeployment.... // Use OpenAI // apiKey: config.openAIKey, // defaultModel: "gpt-3.5-turbo", azureApiKey: config.azureOpenAIKey, azureDefaultDeployment: "gpt-35-turbo", azureEndpoint: config.azureOpenAIEndpoint, ...
Debuggen und Ausführen Ihrer KI-Chatbot-App
Wählen Sie im linken Bereich AUSFÜHREN und DEBUGGEN (STRG+UMSCHALT+D) und dann in der Dropdownliste Debuggen in Agents Playground aus.
Agents Playground öffnet Ihren KI-Chat-Bot auf einer Webseite.
Aktivitätstrigger
Sie können eine Aktivität im Agents Playground mithilfe von Aktivitätstriggern simulieren. Es gibt zwei Arten von Aktivitätstriggern:
Vordefinierte Aktivitätstrigger
Agents Playground bietet vordefinierte Aktivitätstrigger zum Testen der Funktionen Ihres Bots.
| Kategorie | Aktivität | Handler |
|---|---|---|
| Auslösen der Updateaktivität für die Installation | Installieren des Bots Deinstallieren des Bots |
onInstallationUpdate onInstallationUpdateAdded onInstallationUpdate onInstallationUpdateRemove |
| Auslösen der Konversationsaktualisierungsaktivität | Benutzer hinzufügen Bot hinzufügen Kanal hinzufügen |
onMembersAdded onTeamsMembersAddedEvent onMembersAdded onTeamsMembersAddedEvent onTeamsChannelCreatedEvent |
| Entfernen eines Benutzers Bot entfernen Kanal entfernen Team entfernen |
onMembersRemoved onTeamsMembersRemovedEvent onMembersRemoved onTeamsMembersRemovedEvent onTeamsChannelDeletedEvent onTeamsTeamDeletedEvent |
|
| Kanal umbenennen Team umbenennen |
onTeamsChannelRenamedEvent onTeamsTeamRenamedEvent |
Hinweis
Nicht alle Arten von Aktivitäten sind in allen Bereichen verfügbar. Sie können z. B. keinen Kanal in einem persönlichen Chat oder einem Gruppenchat hinzufügen oder entfernen.
Vordefinierte Aktivitätstrigger sind im Menü Aktivität simulieren im Agents Playground verfügbar.
Führen Sie die folgenden Schritte aus, um eine Benutzer hinzufügen-Aktivität zu simulieren:
Wechseln Sie in Agents Playground zu Simulieren einer Aktivität>Benutzer hinzufügen.
Ein Dialogfeld wird angezeigt, um eine Vorschau des Aktivitätshandlers anzuzeigen.
Wählen Sie Aktivität senden aus.
Der Bot sendet die folgende Antwort:
Benutzerdefinierte Aktivitätstrigger
Sie können die benutzerdefinierte Aktivität verwenden, um Aktivitätstrigger anzupassen, reactionsAdded um beispielsweise die Anforderungen Ihrer Bot-App zu erfüllen. Agents Playground füllt automatisch die erforderlichen Eigenschaften der Aktivität auf. Sie können auch den Aktivitätstyp ändern und weitere Eigenschaften hinzufügen.
Wählen SieBenutzerdefinierte Aktivität>simulieren aus.
Fügen Sie hinzu
messageReaction, um die Aktivität unter dertype-Eigenschaft anzupassen:{ "type": "messageReaction", "reactionsAdded": [ { "type": "like" } ], "replyToId": "d60fd1cb-3e8f-44ef-849c-404806ba1b47" }Wählen Sie Aktivität senden aus.
Der Bot sendet als Antwort einen
onReactionsAddedHandler.
Abschließen der Herausforderung
Haben Sie eine ausgabe wie diese?
Herzlichen Glückwunsch!
Sie haben erfolgreich eine KI-Chatbot-App erstellt. Nun haben Sie gelernt, ihre KI-Chat-Bot-App in Agents Playground zu debuggen.
Liegt ein Problem mit diesem Abschnitt vor? Wenn ja, senden Sie uns Feedback, damit wir den Abschnitt verbessern können.