Teams KI-Bibliothek – Schnellstartleitfaden

Erste Schritte mit der Teams KI-Bibliothek mithilfe des LightBot-Beispiels, das Sie beim Erstellen von Apps unterstützt, die Lichter steuern können, z. B. das Ein- und Ausschalten mithilfe der Teams KI-Bibliothek. 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- und Python-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 mit Apps für Chats, Besprechungen und Anrufe 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 Microsoft 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 BOT_IDBOT_PASSWORD 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 BOT_ID automatisch Ressourcen bereit.BOT_PASSWORD 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 Teams KI-Bibliothek mithilfe des LightBot-Beispiels. 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.

   

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> 03.ai-concepts> c.actionMapping-lightBot , und wählen Sie Ordner auswählen aus. Alle Dateien für das LightBot-Beispiel sind im Abschnitt EXPLORER in Visual Studio Code aufgeführt.

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

    OpenAI-Schlüssel

    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>
       

    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
           // }
       

    Azure OpenAI

    1. Wechseln Sie zum Ordner, env und aktualisieren Sie den folgenden Code in der ./env/.env.local.user Datei:

       SECRET_AZURE_OPENAI_KEY=<your Azure OpenAI key>
       SECRET_AZURE_OPENAI_ENDPOINT=<your Azure OpenAI Endpoint>
       

    2. Wechseln Sie zur teamsapp.local.yml Datei, und ändern Sie den letzten Schritt, um Azure OpenAI-Variablen zu verwenden:

          - uses: file/createOrUpdateEnvironmentFile
            with:
             target: ./.env
             envs:
             BOT_ID: ${{BOT_ID}}
             BOT_PASSWORD: ${{SECRET_BOT_PASSWORD}}
             #OPENAI_KEY: ${{SECRET_OPENAI_KEY}}
             AZURE_OPENAI_KEY: ${{SECRET_AZURE_OPENAI_KEY}}
             AZURE_OPENAI_ENDPOINT: ${{SECRET_AZURE_OPENAI_ENDPOINT}}
       

    3. Wechseln Sie zum infra Ordner, und stellen Sie sicher, dass die folgenden Zeilen in der azure.bicep Datei auskommentiert sind:

           // {
           //  name: 'OPENAI_KEY'
           //  value: openAIKey
           // }
       

    4. Wechseln Sie zu , infra>azure.parameters.json und ersetzen Sie die Zeilen von 20 bis 22 durch den folgenden Code:

          "azureOpenAIKey": {
          "value": "${{SECRET_AZURE_OPENAI_KEY}}"
          },
          "azureOpenAIEndpoint": {
          "value": "${{SECRET_AZURE_OPENAI_ENDPOINT}}"
          }
         ```
       

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

15. Melden Sie sich unter KONTEN bei Folgendem an:

    • Microsoft 365 Konto
    • Azure-Konto

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

17. Klicken Sie auf Hinzufügen.

    

    Ein Chatfenster wird geöffnet.

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

Voraussetzungen

Stellen Sie zunächst sicher, dass Sie über die folgenden Tools verfügen:

Installieren	Zum Benutzen...
Visual Studio	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.
Microsoft Teams	Um mit allen zusammenzuarbeiten, arbeiten Sie über Apps für Chats, Besprechungen und Anrufe 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 Microsoft 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

1. Wechseln Sie zum Beispiel.

2. Klonen Sie das Repository, um die Beispiel-App zu testen.

   git clone https://github.com/microsoft/teams-ai.git
   

3. Wechseln Sie zum Ordner dotnet .

   cd teams-ai/dotnet
   

4. Wechseln Sie zu dem Ordner, in dem Sie das Repository geklont haben, und wählen Sie 04.ai.c.actionMapping.lightBot aus.

5. Wählen Sie LightBot.sln aus. Die Projektmappe wird in Visual Studio geöffnet.

6. Aktualisieren Sie in Visual Studio ihre OpenAI-bezogenen Einstellungen in der appsettings.Development.json Datei.

   "Azure": {
   "OpenAIApiKey": "<your-azure-openai-api-key>",
   "OpenAIEndpoint": "<your-azure-openai-endpoint>"
   },
   

7. Wechseln Sie zu , Prompts/sequence/skprompt.txt und aktualisieren Sie den folgenden Code in der skprompt.txt Datei:

   The following is a conversation with an AI assistant. 
   The assistant can turn a light on or off.
   The assistant must return the following JSON structure:
   
   {"type":"plan","commands":[{"type":"DO","action":"<name>","entities":{"<name>":<value>}},{"type":"SAY","response":"<response>"}]}
   
   The following actions are supported:
   
   - LightsOn
   - LightsOff
   - Pause time=<duration in ms>
   - LightStatus
   
   The lights are currently {{getLightStatus}}.
   
   Always respond in the form of a JSON based plan. Stick with DO/SAY.
   

8. Wählen Sie im Dropdownmenü Debuggen die Option Dev Tunnels>Tunnel erstellen aus.

   

9. Wählen Sie das Konto aus, das zum Erstellen des Tunnels verwendet werden soll. Azure-, Microsoft-Konten (MSA) und GitHub-Konten werden unterstützt. Aktualisieren Sie die folgenden Optionen:

   1. Name: Geben Sie einen Namen für den Tunnel ein.
   2. Tunneltyp: Wählen Sie Persistent oder Temporär aus.
   3. Zugriff: Wählen Sie Öffentlich aus.
   4. Wählen Sie OK aus. Visual Studio zeigt eine Bestätigungsmeldung an, dass ein Tunnel erstellt wurde.

   Der von Ihnen erstellte Tunnel ist unter Dev Tunnels (Name des Tunnels > ) aufgeführt.

10. Wechseln Sie zu Projektmappen-Explorer, und wählen Sie Ihr Projekt aus.

11. Klicken Sie mit der rechten Maustaste auf das Menü, und wählen Sie Teams ToolkitPrepare Teams App Dependencies (Teams-App-Abhängigkeiten> vorbereiten) aus.

    

    Wenn Sie dazu aufgefordert werden, melden Sie sich bei Ihrem Microsoft 365-Konto an. Sie erhalten eine Meldung, dass Teams-App-Abhängigkeiten erfolgreich vorbereitet wurden.

12. Wählen Sie OK aus.

13. Wählen Sie F5 oder Debug>Start aus.

14. Klicken Sie auf Hinzufügen. Die App wird Teams hinzugefügt, und ein Chatfenster wird geöffnet.

    

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

    

Sie können die Beispiele auch mithilfe des Teams-Toolkits in Azure bereitstellen. Führen Sie zum Bereitstellen die folgenden Schritte aus:

1. Wechseln Sie in Visual Studio zu Projektmappen-Explorer, und wählen Sie Ihr Projekt aus.
2. Klicken Sie mit der rechten Maustaste auf das Menü, und wählen Sie Teams Toolkit-Bereitstellung>in der Cloud aus. Das Toolkit stellt Ihr Beispiel für Azure bereit.
3. Klicken Sie mit der rechten Maustaste auf das Menü, und wählen Sie Teams Toolkit>In der Cloud bereitstellen aus.

Voraussetzungen

Stellen Sie zunächst sicher, dass Sie über die folgenden Tools verfügen:

Installieren	Zum Benutzen...
Visual Studio Code	JavaScript-, TypeScript- und Python-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.
Python	Python ist eine interpretierte und objektorientierte Programmiersprache mit dynamischer Semantik. Verwenden Sie Versionen zwischen 3.8 und 4.0.
Poesie	Abhängigkeitsverwaltungs- und Paketerstellungstool für Python.
Python VSCode-Erweiterung	Bietet umfassende Unterstützung für Python in VSCode.
Git	Git ist ein Versionskontrollsystem, mit dem Sie verschiedene Versionen von Code innerhalb eines Repositorys verwalten können.
Microsoft Teams	Um mit allen zusammenzuarbeiten, arbeiten Sie über Apps für Chats, Besprechungen und Anrufe 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 Microsoft 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 BOT_IDBOT_PASSWORD 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 BOT_ID automatisch Ressourcen bereit.BOT_PASSWORD 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

1. Wechseln Sie zum Beispiel.

2. Klonen Sie das Repository, um die Beispiel-App zu testen.

   git clone https://github.com/microsoft/teams-ai.git
   

3. Wechseln Sie zum Python-Ordner .

   cd teams-ai/python
   

4. Wechseln Sie zu dem Ordner, in dem Sie das Repository geklont haben, und wählen Sie 04.ai.c.actionMapping.lightBot aus. Alle Dateien für das LightBot-Beispiel sind im Abschnitt EXPLORER in Visual Studio Code aufgeführt.

5. Duplizieren Sie unter EXPLORER die Datei sample.env , und aktualisieren Sie die doppelte Datei in .env.

   OpenAI-Schlüssel

   Wechseln Sie zum Ordner, env und aktualisieren Sie den folgenden Code in der ./env/.env.local.user Datei:

   SECRET_OPENAI_KEY=<your OpenAI key>
   
   

   Azure OpenAI

   Wechseln Sie zum Ordner, env und aktualisieren Sie den folgenden Code in der ./env/.env.local.user Datei:

   SECRET_AZURE_OPENAI_KEY=<your Azure OpenAI key>
   SECRET_AZURE_OPENAI_ENDPOINT=<your Azure OpenAI Endpoint>
   
   

6. Um die folgenden Abhängigkeiten zu installieren, wechseln Sie zu Terminal anzeigen>, und führen Sie die folgenden Befehle aus:

   Abhängigkeiten	Befehl
   python-dotenv	pip install python-dotenv
   load-dotenv	pip install load-dotenv
   teams-ai	pip install teams-ai
   botbuilder-core	pip install botbuilder-core

7. Aktualisieren Sie config.json und bot.py mit dem Namen Ihrer Modellbereitstellung.

8. Wechseln Sie zu Befehlspalette anzeigen>... oder drücken Sie STRG+UMSCHALT+P.

9. Geben Sie Python: Create Environment ein, um eine virtuelle Umgebung zu erstellen.

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

11. Klicken Sie auf Hinzufügen.

    

    Ein Chatfenster wird geöffnet.

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

    

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

Häufig gestellte Fragen zur Ki-Bibliothek von Teams