Erstellen von Bots für Teams

Artikel
10/17/2024

Ein Bot wird auch als Chatbot oder Unterhaltungsbot bezeichnet. Es handelt sich um eine App, die einfache und sich wiederholende Aufgaben von Benutzern ausführt, z. B. Kundendienst- oder Supportmitarbeiter. Die tägliche Verwendung von Bots umfasst Bots, die Informationen über das Wetter bereitstellen, Essensreservierungen durchführen oder Reiseinformationen bereitstellen. Interaktionen mit Bots können kurze Fragen und Antworten oder komplexe Unterhaltungen sein.

Es wird empfohlen, mit dem Erstellen Ihrer ersten Bot-App mit JavaScript oder dem Erstellen eines Benachrichtigungsbots mit JavaScript zu beginnen, indem Sie das Entwicklungstool der neuen Generation für Teams verwenden. Weitere Informationen finden Sie unter Übersicht über das Teams-Toolkit.

Wichtig

Bots sind in Den Umgebungen Government Community Cloud (GCC), GCC-High und Department of Defense (DOD) verfügbar. Botanwendungen in Microsoft Teams für GCC-High und DOD sind über Azure Bot Service verfügbar, und die Botkanalregistrierung muss in Azure Government Portal erfolgen.
Bild-URLs in adaptiven Karten werden in GCC-High- und DOD-Umgebungen nicht unterstützt. Sie können eine Bild-URL durch Base64-codierte DataUri ersetzen.
Wenn ein Benutzer das Teams-Design in einem Bot ändert, gilt das Design nicht für die Inhalte, die mit einer adaptiven Karte freigegeben wurden.

Unterhaltungsbots ermöglichen Benutzern die Interaktion mit Ihrem Webdienst mithilfe von Text, interaktiven Karten und Dialogen (in TeamsJS v1.x als Aufgabenmodule bezeichnet).

Unterhaltungsbots sind unglaublich flexibel. Bots können einige Basisbefehle verarbeiten oder komplexe Aufgaben, die künstliche Intelligenz und die Verarbeitung natürlicher Sprache erfordern. Bots können Teil einer größeren Anwendung oder eigenständig sein.

Verwenden Sie die richtige Mischung aus Karten, Text und Dialogen, um einen nützlichen Bot zu erstellen. Das folgende Bild zeigt einen Benutzer, der sich in einem 1:1-Chat mit einem Bot über Text und interaktive Karten unterhält.

Der Screenshot ist ein Beispiel, das einen Beispiel-Bot mit häufig gestellten Fragen zeigt.

Jede Interaktion zwischen dem Benutzer und dem Bot wird als eine Aktivität dargestellt. Wenn ein Bot eine Aktivität empfängt, übergibt er diese an seine Aktivitätshandler. Weitere Informationen finden Sie unter Bot-Aktivitätshandler.

Bots sind Apps, die über eine Unterhaltungsschnittstelle verfügen. Sie können mithilfe von Text, interaktiven Karten und Sprache mit einem Bot interagieren. Ein Bot verhält sich in einer Kanal- oder Gruppenchatunterhaltung anders als in einer 1:1-Unterhaltung. Unterhaltungen werden über den Bot Framework-Connector verarbeitet. Weitere Informationen finden Sie unter Grundlagen zu Unterhaltungen.

Ihr Bot benötigt Kontextinformationen, z. B. Benutzerprofildetails, um auf relevante Inhalte zuzugreifen und die Boterfahrung zu verbessern. Weitere Informationen finden Sie unter Teams-Kontext abrufen.

Sie können Dateien über den Bot mithilfe von Graph-APIs oder Teams-Bot-APIs senden und empfangen. Weitere Informationen finden Sie unter Senden und Empfangen von Dateien über den Bot.

Die Ratenbegrenzung wird verwendet, um Bots zu optimieren, die für Ihre Teams-Anwendung verwendet werden. Um Teams und seine Benutzer zu schützen, bieten die Bot-APIs eine Ratenbegrenzung für eingehende Anforderungen. Weitere Informationen finden Sie unter Optimieren eines Bots mit Ratenbegrenzung in Teams.

Mit Microsoft Graph-APIs für Anrufe und Onlinebesprechungen können Teams-Apps jetzt per Sprache und Video mit Benutzern interagieren. Weitere Informationen finden Sie unter Anruf- und Besprechungsbots.

Sie können die Teams-Bot-APIs verwenden, um Informationen für Mitglieder eines Chats oder Teams abzurufen. Weitere Informationen finden Sie unter Änderungen an Teams-Bot-APIs zum Abrufen von Team- oder Chatmitgliedern.

Botname und -symbol

Botname: Sie können den in der Teams-Umgebung angezeigten Botnamen ändern, indem Sie ihn in den folgenden Vorkommen aktualisieren:

Der Botname, der im Chatfenster als Titel angezeigt wird, wird in Ihrem App-Manifest (zuvor teams-App-Manifest genannt) aktualisiert und verwaltet.
Der Botname, der in Ihrer Teams-Chatliste und im Chatfenster mit jeder Nachricht angezeigt wird, wird in Microsoft Azure-Portal verwaltet. Für benutzerdefinierte hochgeladene Apps können Sie den Botnamen auf der Seite Botprofil in Azure-Portal aktualisieren.

Botsymbol: Sie können das Botsymbol für die Teams-App wie folgt hinzufügen oder aktualisieren. Das aktualisierte Botsymbol wird erst sichtbar, nachdem sich der Benutzer abgemeldet und sich wieder bei Teams anmeldet. Dies liegt daran, dass die Symbole zwischengespeichert werden:

Microsoft Teams Store-App: Für Teams Store-Apps werden Botsymbole aus dem App-Manifest abgerufen. Sie können das Botprofilsymbol aktualisieren, indem Sie es über das App-Manifest aktualisieren und die App erneut veröffentlichen.


{
  "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.16/MicrosoftTeams.schema.json",
  "manifestVersion": "1.17",
  "version": "1.0.0",
  "id": "%MICROSOFT-APP-ID%",
  "icons": {
     "outline": "A relative path to a transparent .png icon — 32px X 32px", // This icon is used for bot profile.
     "color": "A relative path to a full color .png icon — 192px X 192px"
  },
  "bots": [
  {
    "botId": "%MICROSOFT-APP-ID-REGISTERED-WITH-BOT-FRAMEWORK%",
    "scopes": [
      "team",
      "personal",
      "groupChat"
    ]
  }
  ]
...
}

Hochladen einer benutzerdefinierten App in Teams oder benutzerdefinierten Apps, die für Ihre Organisation (BRANCHEN-Apps) erstellt wurden:
- Azure-Portal: Sie können das Botsymbol ändern, indem Sie zu Azure-Portal navigieren.
- Bot Framework-Portal: Für Bots, die mit dem Bot Framework-Portal erstellt wurden, können Sie das Botsymbol auf der Seite EINSTELLUNGEN aktualisieren.

Angeben der Hostruntime-Anforderungen (Entwicklervorschau)

Um sicherzustellen, dass Ihre App Kunden immer hochwertige Erfahrungen bietet, können Sie das Verhalten Ihrer App in den entsprechenden Microsoft 365-Hosts anpassen oder sie in Kontexten auslassen, die Sie nicht unterstützen möchten. Verwenden Sie das App-Manifest, um Abhängigkeitsbeziehungen zwischen den Funktionen Ihrer App und bestimmte Laufzeitanforderungen Ihrer statischen Registerkarten, Nachrichtenerweiterungen und Bots anzugeben.

Weitere Informationen finden Sie unter Angeben von Microsoft 365-Hostruntime-Anforderungen in Ihrem App-Manifest.

Hinzufügen der SSO-Authentifizierung zu Ihren Konversationsbots

Mit den folgenden Schritten können Sie Ihrem Konversationsbot die Authentifizierung mit einmaligem Anmelden hinzufügen:

Botkonfigurationsoberfläche

Die Botkonfigurationserfahrung hilft Ihnen, die Boteinstellungen für Benutzer zu aktivieren, um ihren Bot während der Installation zu konfigurieren und den Bot aus dem Kanal- oder Gruppenchatbereich neu zu konfigurieren, in dem der Bot installiert ist. Die Botkonfiguration ist eine wichtige Funktion für Apps innerhalb der Teams-Plattform, die die Grundlage für deren operative Effektivität bildet. Weitere Informationen finden Sie unter Botkonfigurationserfahrung.

Codebeispiele

Beispielname	Beschreibung	.NET	Node.js	Manifest
Tägliche Aufgabenerinnerung des Bots	In diesem Beispiel wird gezeigt, wie Sie mithilfe des Bots eine wiederkehrende Aufgabe planen und zu einem geplanten Zeitpunkt eine Erinnerung erhalten.	View	View	View
Hello Weltbot	Dies ist eine einfache Hello World-Anwendung mit Bot- und Nachrichtenerweiterungsfunktionen.	–	View
Benachrichtigung über adaptive Karten	Dies ist ein Beispiel, das zeigt, wie Benachrichtigungen mit verschiedenen adaptiven Karten mithilfe von Bots gesendet werden.	–	View
Eingehende Webhookbenachrichtigung	Dies ist ein Beispiel, das zeigt, wie Sie Benachrichtigungen mithilfe eines eingehenden Webhooks in Microsoft Teams-Kanälen senden.	–	View

Nächster Schritt

Tools und SDKs

Teilen über