Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Wichtig
Dieser Artikel basiert auf dem v3 Bot Framework SDK.
- Wenn Sie einen KI-Bot erstellen möchten, lesen Sie Erstellen eines KI-Bots.
- Wenn Sie einen einfachen Bot erstellen möchten, lesen Sie Erste Schritte, und wenn Sie nach der aktuellen Dokumentationsversion 4.6 oder höher des SDK suchen möchten, lesen Sie Unterhaltungs-Bots.
Erstellen und verbinden Sie intelligente Bots, um mit Benutzern von Microsoft Teams auf natürliche Weise per Chat zu interagieren. Oder stellen Sie einen einfachen befehlsbasierten Bot bereit, der als "Befehlszeilen"-Schnittstelle für Ihre umfassendere Teams-App-Erfahrung verwendet werden kann. Sie können einen Benachrichtigungs-Bot erstellen, der Informationen, die für Ihre Benutzer relevant sind, in einem Kanal oder in einer Direktnachricht direkt an sie weitergeben kann. Sie können sogar Ihren vorhandenen Bot Framework-basierten Bot verwenden und Teams-spezifischen Support hinzufügen, um Ihre Erfahrung zu verbessern.
Wichtig
Bots sind in Government Community Cloud (GCC), GCC High, Department of Defense (DoD) und Teams, die von 21Vianet-Umgebungen betrieben werden, verfügbar.
Was Sie wissen müssen: Bots
Ein Bot wird wie jedes andere Teammitglied angezeigt, mit dem Sie in einer Unterhaltung interagieren, mit dem Unterschied, dass er ein sechseckiges Avatarsymbol hat und immer online ist.
Ein Bot verhält sich anders, je nachdem, an welcher Art von Konversation er beteiligt ist. Bots in Teams unterstützen verschiedene Arten von Unterhaltungen, die im App-Manifest als Bereiche bezeichnet werden.
-
teamsAuch Kanalunterhaltungen genannt. -
personalUnterhaltungen zwischen einem Bot und einem einzelnen Benutzer. -
groupChatEine Unterhaltung zwischen einem Bot und zwei oder mehr Benutzern.
Weitere Informationen finden Sie unter Unterhaltung mit einem Microsoft Teams-Bot.
Mit Teams-Apps können Sie den Bot zum Star Ihrer Erfahrung oder einfach nur zu einem Helfer machen. Bots werden als Teil Ihres umfassenderen App-Pakets veröffentlicht, das andere Funktionen wie Registerkarten oder Nachrichtenerweiterungen umfassen kann.
Bot-APIs
Teams unterstützt den größten Teil des Microsoft Bot Framework. (Wenn Sie bereits über einen Bot verfügen, der auf dem Botframework basiert, können Sie ihn ganz einfach an die Arbeit in Teams anpassen.) Wir empfehlen Ihnen, entweder C# oder Node.js zu verwenden, um unsere SDKs zu nutzen. Diese Pakete erweitern die grundlegenden Klassen und Methoden des Bot Builder SDK:
- Verwenden spezieller Kartentypen wie der Connector-Karte für Microsoft 365-Gruppen.
- Nutzung und Festlegen von Teams-spezifischen Kanaldaten zu Aktivitäten.
- Processing message extension requests. (Verarbeitung von Nachrichtenerweiterungsanforderungen)
Die SDK-Erweiterungen installieren Abhängigkeiten, einschließlich des Bot Builder SDK.
- .NET Um die Microsoft Teams-Erweiterungen für das Bot Builder SDK für .NET zu verwenden, installieren Sie das NuGet-Paket Microsoft.Bot.Connector.Teams in Ihrem Visual Studio-Projekt. Für Node.js Entwicklung wurde die BotBuilder für Microsoft Teams-Funktionalität ab v4.6 in das Bot Framework SDK integriert.
Wichtig
Sie können Teams-Apps in jeder anderen Webprogrammiertechnologie entwickeln und die Bot Framework-REST-APIs direkt aufrufen, aber Sie müssen die gesamte Tokenbehandlung selbst durchführen.
Das Entwicklerportal für Teams hilft Ihnen beim Erstellen und Konfigurieren Ihres App-Manifests und kann Ihren Bot Framework-Bot für Sie erstellen. Es enthält auch eine React-Kontrollbibliothek und einen interaktiven Karten-Builder.
Ausgehende Webhooks
Ausgehende Webhooks ermöglichen es Ihnen, einen einfachen Bot für grundlegende Interaktionen zu erstellen, z. B. zum Starten eines Workflows oder anderer einfacher Befehle, die Sie möglicherweise benötigen. Ausgehende Webhooks befinden sich nur in dem Team, in dem Sie sie erstellen, und sind für einfache Prozesse gedacht, die für den Workflow Ihres Unternehmens spezifisch sind. Weitere Informationen finden Sie unter Ausgehende Webhooks.
Erstellen eines großartigen Teams-Bots
Die folgenden Artikel führen Sie durch den Prozess der Erstellung eines großartigen Bots für Teams:
- Erstellen eines Bots: Profitieren Sie von den großartigen Tools, der Dokumentation und der Community, die vom Bot Framework-Team bereitgestellt werden.
- Sprechen Sie mit Ihrem Bot: Fügen Sie einen grundlegenden Unterhaltungsfluss hinzu, und verwenden Sie kanalspezifische Funktionen. Wenn Sie in .NET oder Node.js entwickeln, verwenden Sie unsere Erweiterungen für das Bot Builder SDK, um Ihre Arbeit zu vereinfachen.
- Verwenden von Karten in Ihrem Bot: Entwerfen Sie Karten, um zu kommunizieren und Benutzerreaktionen zu akzeptieren.
- Reagieren auf Bot-Ereignisse
- Bots nur für Benachrichtigungen: Verwenden von Bots zum Senden von Benachrichtigungen für Ihre App.
- Kontext abrufen: Abrufen von Informationen über den Benutzer.
- Bot-Menüs: Verwenden von Menüs in Bots.
- Bots und Dateien: Senden und Empfangen von Dateien von Bots.
- Verwenden von Registerkarten mit Bots: Erstellen der Zusammenarbeit von Registerkarten und Bots.
- Testen Sie Ihren Bot: Fügen Sie Ihren Bot für persönliche Unterhaltungen oder für Teamunterhaltungen hinzu, um ihn in Aktion zu sehen.
Bots SDK V3
Wichtig
Dieser Artikel basiert auf dem v3 Bot Framework SDK.
- Wenn Sie einen KI-Bot erstellen möchten, lesen Sie Erstellen eines KI-Bots.
- Wenn Sie einen einfachen Bot erstellen möchten, lesen Sie Erste Schritte, und wenn Sie nach der aktuellen Dokumentationsversion 4.6 oder höher des SDK suchen möchten, lesen Sie Unterhaltungs-Bots.
Das Teams-Entwicklerportal für Teams ist ein Tool, das Ihnen beim Erstellen Ihres Bots helfen kann, und ein App-Paket, das auf Ihren Bot verweist. Es enthält auch eine React-Kontrollbibliothek und konfigurierbare Samples für Karten. Weitere Informationen finden Sie unter Erste Schritte mit dem Teams-Entwicklerportal für Teams. Bei den folgenden Schritten wird davon ausgegangen, dass Sie Ihren Bot manuell konfigurieren und nicht das Teams-Entwicklerportal für Teams verwenden:
Erstellen Sie den Bot mithilfe von Bot Framework. Stellen Sie sicher, dass Sie Microsoft Teams nach der Erstellung Ihres Bots aus der Liste der empfohlenen Kanäle als Kanal hinzufügen. Sie können jede von Ihnen generierte Microsoft-App-ID wiederverwenden, wenn Sie Ihr App-Paket/Manifest bereits erstellt haben.
Hinweis
Wenn Sie Ihren Bot nicht in Azure erstellen möchten, müssen Sie diesen Link verwenden, um einen neuen Bot zu erstellen: Bot Framework. Wenn Sie stattdessen im Bot Framework-Portal die Option Bot erstellen auswählen, erstellen Sie Ihren Bot stattdessen in Microsoft Azure.
Erstellen Sie den Bot mithilfe des NuGet-Pakets Microsoft.Bot.Connector.Teams , des Bot Framework SDK oder der Bot Connector-API.
Testen Sie den Bot mit dem Bot Framework Emulator.
Stellen Sie den Bot für einen Clouddienst bereit, z. B. Microsoft Azure. Alternativ können Sie Ihre App lokal ausführen und einen Tunnelingdienst wie ngrok verwenden, um einen https:// Endpunkt für Ihren Bot verfügbar zu machen, z. B
https://45az0eb1.ngrok-free.app/api/messages. .
Hinweis
Bots und Microsoft Azure
Das Bot Framework-Portal ist für die Registrierung von Bots in Microsoft Azure optimiert. Hier sind einige Dinge, die Sie wissen müssen:
- Der Microsoft Teams-Kanal für in Azure registrierte Bots ist kostenlos. Nachrichten, die über den Teams-Kanal gesendet werden, werden nicht zu den für den Bot konsumierten Nachrichten gezählt.
- Es ist zwar möglich, einen neuen Bot zu erstellen, ohne Azure zu verwenden, aber Sie müssen einen neuen Bot Framework-Bot erstellen, der nicht mehr im Bot Framework-Portal verfügbar gemacht wird.
- Wenn Sie die Eigenschaften eines vorhandenen Bots in der Liste Ihrer Bots im Bot Framework bearbeiten, z. B. seinen "Messagingendpunkt", was bei der ersten Entwicklung eines Bots üblich ist, insbesondere wenn Sie ngrok verwenden, sehen Sie die Spalte "Status der Migration" und eine blaue Schaltfläche "Migrieren", die Sie zum Microsoft Azure-Portal führt. Wählen Sie nicht die Schaltfläche "Migrieren", es sei denn, Sie möchten dies tun. Wählen Sie stattdessen den Namen des Bots aus, und Sie können seine Eigenschaften bearbeiten:
- Wenn Sie Ihren Bot mit Microsoft Azure registrieren, muss Ihr Bot-Code nicht auf Microsoft Azure gehostet werden.
- Wenn Sie einen Bot über das Azure-Portal registrieren, müssen Sie über ein Microsoft Azure-Konto verfügen. Sie können kostenlos eine erstellen. Um Ihre Identität beim Erstellen zu bestätigen, müssen Sie eine Guthaben-Karte angeben, die jedoch nicht in Rechnung gestellt wird. Das Erstellen und Verwenden von Bots mit Teams ist immer kostenlos.
- Sie können jetzt das Entwicklerportal für Teams verwenden, um App- und Botinformationen direkt in Teams zu registrieren/zu aktualisieren. Sie müssen das Azure-Portal nur zum Hinzufügen oder Konfigurieren anderer Bot Framework-Kanäle wie Direct Line, Webchat, Skype und Facebook Messenger verwenden.