Schnellstartleitfaden für die Verwendung der Assistenten-API mit der Teams KI-Bibliothek
Erste Schritte mit der OpenAI- oder Azure OpenAI-Assistenten-API mit der Teams KI-Bibliothek im Mathe-Tutor Assistent Beispiel. In diesem Leitfaden wird das OpenAI-Codeinterpretertool verwendet, um eine Assistent zu erstellen, die auf Mathematik spezialisiert ist. Der Bot verwendet das gpt-3.5-turbo-Modell, um mit Microsoft Teams-Benutzern zu chatten und höflich und respektvoll zu antworten, wobei er im Rahmen der Unterhaltung bleibt.
Voraussetzungen
Stellen Sie zunächst sicher, dass Sie über die folgenden Tools verfügen:
Installieren | Zum Benutzen... |
---|---|
Visual Studio Code | JavaScript-, TypeScript- oder C Sharp-Buildumgebungen. Verwenden Sie die neueste Version. |
Teams Toolkit | Microsoft Visual Studio Code-Erweiterung, die ein Projektgerüst für Ihre App erstellt. Verwenden Sie die neueste Version. |
Git | Git ist ein Versionskontrollsystem, mit dem Sie verschiedene Versionen von Code innerhalb eines Repositorys verwalten können. |
Node.js | Back-End-JavaScript-Laufzeitumgebung. Weitere Informationen finden Sie unter Node.js Versionskompatibilitätstabelle für den Projekttyp. |
Microsoft Teams | Um mit allen zusammenzuarbeiten, arbeiten Sie über Apps für Chat, Besprechungen und Anruf an einem Ort. |
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. |
Microsoft 365-Entwicklerkonto | Zugriff auf ein Teams-Konto mit den entsprechenden Berechtigungen, um eine App zu installieren und benutzerdefinierte Teams-Apps zu aktivieren und das Hochladen benutzerdefinierter Apps zu aktivieren. |
Wenn Sie die Beispiele bereits ausgeführt haben oder ein Laufzeitfehler aufgetreten ist, führen Sie die folgenden Schritte aus, um neu zu beginnen:
- Überprüfen Sie alle
.env
Dateien undenv/.env.*.*
im Beispiel, und löschen Sie alle automatisch aufgefüllten Werte, um sicherzustellen, dass Teams Toolkit neue Ressourcen für Sie generiert. - Wenn Teams Toolkit die App-ID und das Kennwort nicht generieren soll, aktualisieren Sie und
MicrosoftAppId
MicrosoftAppPassword
in der.env
Datei mit Ihren eigenen Werten. - Entfernen Sie Werte, oder lassen Sie die Werte für SECRET_BOT_PASSWORD und TEAMS_APP_UPDATE_TIME in der
.env
Datei leer, um Konflikte zu vermeiden.
Teams Toolkit stellt MicrosoftAppId
automatisch Ressourcen bereit.MicrosoftAppPassword
Wenn Sie Ihre eigenen Ressourcen verwenden möchten, müssen Sie sie .env
der Datei manuell hinzufügen. Das Teams-Toolkit generiert die folgenden Ressourcen nicht automatisch:
- Ein Azure OpenAI- oder OpenAI-Schlüssel
- Eine Datenbank oder ähnliche Speicheroptionen
Erstellen und Ausführen der Beispiel-App
Erste Schritte mit der Ki-Bibliothek von Teams mithilfe des Beispiels für mathematische Tutoren Assistent. Es ermöglicht dem localhost Ihres Computers, schnell ein Teams KI-bibliotheksbasiertes Beispiel auszuführen.
Wechseln Sie zum Beispiel.
Führen Sie den folgenden Befehl aus, um das Repository zu klonen:
git clone https://github.com/microsoft/teams-ai.git
Wechseln Sie zu Visual Studio Code.
Wählen Sie Datei>Ordner öffnen aus.
Wechseln Sie zu dem Speicherort, an dem Sie das Repository teams-ai geklont haben, und wählen Sie den Ordner teams-ai aus.
Wählen Sie Ordner auswählen aus.
Wählen Sie Terminal anzeigen> aus. Ein Terminalfenster wird geöffnet.
Führen Sie im Terminalfenster den folgenden Befehl aus, um zum Ordner js zu wechseln:
cd .\js\
Führen Sie den folgenden Befehl aus, um Abhängigkeiten zu installieren:
yarn install
Führen Sie den folgenden Befehl aus, um Abhängigkeiten zu erstellen:
yarn build
Nachdem die Abhängigkeiten installiert wurden, wählen Sie Datei>Ordner öffnen aus.
Wechseln Sie zu teams-ai > js > samples > 04.ai-apps > d.assistants-mathBot , und wählen Sie Ordner auswählen aus. Alle Dateien für den Mathe-Tutor Assistent Beispiel sind im Explorer-Abschnitt in Visual Studio Code aufgeführt.
Duplizieren Sie unter EXPLORER die
sample.env
Datei, und aktualisieren Sie die doppelte Datei auf.env
.Aktualisieren Sie die folgenden Schritte basierend auf den von Ihnen ausgewählten KI-Diensten.
Wechseln Sie zum Ordner,
env
und aktualisieren Sie den folgenden Code in der./env/.env.local.user
Datei:SECRET_OPENAI_KEY=<your OpenAI key> ASSISTANT_ID=<your Assistant ID>
Wechseln Sie zum
infra
Ordner, und stellen Sie sicher, dass die folgenden Zeilen in derazure.bicep
Datei auskommentiert sind:// { // name: 'AZURE_OPENAI_KEY' // value: azureOpenAIKey // } // { // name: 'AZURE_OPENAI_ENDPOINT' // value: azureOpenAIEndpoint // }
Kopieren Sie das Beispiel in ein neues Verzeichnis, das kein Unterverzeichnis von
teams-ai
ist.Wählen Sie im linken Bereich Teams Toolkitaus.
Melden Sie sich unter KONTEN bei Folgendem an:
- Microsoft 365 Konto
- Azure-Konto
Um Ihre App zu debuggen, drücken Sie die Taste F5 .
Eine Browserregisterkarte öffnet einen Teams-Webclient, der das Hinzufügen des Bots zu Ihrem Mandanten anfordert.
Klicken Sie auf Hinzufügen.
Ein Chatfenster wird geöffnet.
Senden Sie im Nachrichtenerstellungsbereich eine Nachricht, um den Bot aufzurufen.
Hinweis
Wenn Sie einen Bot zum ersten Mal erstellen, wird empfohlen, die Teams Toolkit-Erweiterung für Visual Studio Code zum Erstellen eines Bots zu verwenden. Weitere Informationen finden Sie unter Erstellen Ihrer ersten Bot-App mit JavaScript.
Zusätzliche Tools
Sie können auch die folgenden Tools verwenden, um ein Beispiel auszuführen und einzurichten:
Teams Toolkit CLI: Sie können die Teams Toolkit CLI verwenden, um Microsoft Teams-Apps über die Befehlszeile zu erstellen und zu verwalten. Weitere Informationen finden Sie unter Anweisungen zum Einrichten der Teams-Toolkit-CLI.
Bot Framework Emulator: Die Bot Framework Emulator ist eine Desktopanwendung, mit der Sie Ihren Bot lokal testen und debuggen können. Sie können eine Verbindung mit Ihrem Bot herstellen, indem Sie die Endpunkt-URL des Bots sowie die Microsoft-App-ID und das Kennwort eingeben. Anschließend können Sie Nachrichten an Ihren Bot senden und dessen Antworten in Echtzeit anzeigen. Weitere Informationen finden Sie unter Bot Framework Emulator Einrichtungsanweisungen.
Manuelle Einrichtung: Wenn Sie Ihre Ressourcen lieber manuell einrichten möchten, können Sie dies tun, indem Sie die Anweisungen der jeweiligen Dienste befolgen. Weitere Informationen finden Sie in den Anweisungen zur manuellen Einrichtung.