Freigeben über


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 und env/.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 MicrosoftAppIdMicrosoftAppPassword 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.

  1. Wechseln Sie zum Beispiel.

  2. Führen Sie den folgenden Befehl aus, um das Repository zu klonen:

    git clone https://github.com/microsoft/teams-ai.git
    
  3. Wechseln Sie zu Visual Studio Code.

  4. Wählen Sie Datei>Ordner öffnen aus.

  5. Wechseln Sie zu dem Speicherort, an dem Sie das Repository teams-ai geklont haben, und wählen Sie den Ordner teams-ai aus.

  6. Wählen Sie Ordner auswählen aus.

    Screenshot: Ordner

  7. Wählen Sie Terminal anzeigen> aus. Ein Terminalfenster wird geöffnet.

  8. Führen Sie im Terminalfenster den folgenden Befehl aus, um zum Ordner js zu wechseln:

    cd .\js\
    
  9. Führen Sie den folgenden Befehl aus, um Abhängigkeiten zu installieren:

    yarn install
    
  10. Führen Sie den folgenden Befehl aus, um Abhängigkeiten zu erstellen:

    yarn build
    
  11. Nachdem die Abhängigkeiten installiert wurden, wählen Sie Datei>Ordner öffnen aus.

  12. 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.

  13. Duplizieren Sie unter EXPLORER die sample.env Datei, und aktualisieren Sie die doppelte Datei auf .env.

  14. Aktualisieren Sie die folgenden Schritte basierend auf den von Ihnen ausgewählten KI-Diensten.

    1. 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>
      
    2. Wechseln Sie zum infra Ordner, und stellen Sie sicher, dass die folgenden Zeilen in der azure.bicep Datei auskommentiert sind:

          // {
          //  name: 'AZURE_OPENAI_KEY'
          //  value: azureOpenAIKey
          // }
          // {
          //  name: 'AZURE_OPENAI_ENDPOINT'
          //  value: azureOpenAIEndpoint
          // }
      
  15. Kopieren Sie das Beispiel in ein neues Verzeichnis, das kein Unterverzeichnis von teams-aiist.

  16. Wählen Sie im linken Bereich Teams Toolkitaus.

  17. Melden Sie sich unter KONTEN bei Folgendem an:

    • Microsoft 365 Konto
    • Azure-Konto
  18. 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.

  19. Klicken Sie auf Hinzufügen.

    Screenshot: Option zum Hinzufügen der App im Teams-Webclient

    Ein Chatfenster wird geöffnet.

  20. Senden Sie im Nachrichtenerstellungsbereich eine Nachricht, um den Bot aufzurufen.

    Screenshot: Beispiel für die Mathbot-Ausgabe

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:

  1. 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.

  2. 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.

  3. 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.

Nächster Schritt