Teilen über

Tools und SDKs

  • Artikel

Mit den folgenden Tools oder Funktionen können Sie einen Bot für die Verwendung in Microsoft Teams erstellen:

Bots mit Microsoft Bot Framework

Ihr Teams-Bot besteht aus folgenden Komponenten:

  • Einem öffentlich zugänglichen von Ihnen gehosteten Webdienst.
  • Eine Microsoft Bot Framework-Registrierung für Ihren Webdienst.
  • Ihrem Teams App-Paket, das den Teams-Client mit Ihrem Webdienst verbindet.

Tipp

Verwenden Sie das Entwicklerportal, um Ihren Webdienst bei Microsoft Bot Framework zu registrieren und Ihre App-Konfigurationen anzugeben. Weitere Informationen finden Sie unter Verwalten Ihrer Apps mit dem Entwicklerportal für Microsoft Teams.

Microsoft Bot Framework ist ein umfangreiches SDK zur Erstellung von Bots mit C#, Java, Python und JavaScript. Wenn Sie bereits über einen Bot verfügen, der auf Microsoft Bot Framework basiert, können Sie ihn mühelos zur Verwendung in Microsoft Teams ändern. Microsoft empfiehlt die Verwendung von C# oder Node.js, um unsere SDKs nutzen zu können. Diese Pakete erweitern die grundlegenden Klassen und Methoden des Bot Builder-SDKs folgendermaßen:

  • Verwenden Sie spezielle Karte-Typen wie den Connector-Karte für Microsoft 365-Gruppen.
  • Sie können Teams-spezifische Kanaldaten zu Aktivitäten festlegen.
  • Sie können Nachrichtenerweiterungsanforderungen verarbeiten.

Sie können Teams-Apps in jeder Beliebigen Webprogrammiertechnologie entwickeln und die Bot Framework-REST-APIs direkt aufrufen. Sie müssen die Tokenverarbeitung in allen Fällen durchführen.

Bots mit Power Virtual Agents

Power Virtual Agents ist ein Chatbotdienst, der auf Microsoft Power Platform und Microsoft Bot Framework aufbaut. Der Power Virtual Agent-Entwicklungsprozess verwendet einen geführten Ansatz ohne Code mit einer grafischen Schnittstelle, um Ihre Teammitglieder in die Lage zu versetzen, mühelos einen intelligenten virtuellen Agent zu erstellen und zu pflegen. Sobald Sie Ihr Chatbot im Power Virtual Agents-Portal erstellt haben, können Sie ihn mühelos in Microsoft Teams integrieren. Weitere Informationen zu den ersten Schritten finden Sie in der Power Virtual Agents-Dokumentation.

Hinweis

Sie dürfen Microsoft Power Platform nicht verwenden, um Apps zu erstellen, die im Microsoft Teams Store veröffentlicht werden sollen. Microsoft Power Platform-Apps können nur im App Store einer Organisation veröffentlicht werden.

Bots mit Webhooks und Connectors

Webhooks und Connectors verbinden Ihren Bot mit Ihren Webdiensten. Mit Webhooks und Connectors können Sie einen Bot für grundlegende Interaktionen erstellen, wie das Erstellen eines Workflows oder andere einfache Befehle. Sie sind nur in dem Team verfügbar, in dem Sie sie erstellen, und sind für einfache Prozesse vorgesehen, die für den Workflow Ihres Unternehmens spezifisch sind. Unter Was sind Webhooks und Connectors? finden Sie weitere Informationen.

Vorteile von Bots

Bots in Microsoft Teams können Teil einer 1:1-Unterhaltung, eines Gruppenchats oder eines Kanals in einem Team sein. Jeder Bereich bietet für Ihren Unterhaltungs-Bot besondere Chancen und Herausforderungen.

In einem Kanal In einem Gruppenchat In einem 1:1-Chat.
Massive Reichweite Weniger Mitglieder Traditionelle Art und Weise
Präzise individuelle Interaktionen @mention zum Bot F&A-Bots
@mention zum Bot Ähnlich wie Kanal Bots, die Witze erzählen und Notizen machen

In einem Kanal

Kanäle enthalten Threadunterhaltungen zwischen mehreren Personen sogar bis zu 2000. Dadurch erhält Ihr Bot potenziell eine enorme Reichweite, die einzelnen Interaktionen müssen aber präzise sein. Herkömmliche Multi-Turn-Interaktionen funktionieren nicht. Stattdessen müssen Sie interaktive Karten oder Dialoge (in TeamsJS v1.x als Aufgabenmodule bezeichnet) verwenden oder die Unterhaltung in eine 1:1-Unterhaltung verschieben, um viele Informationen zu sammeln. Ihr Bot hat nur Zugriff auf Nachrichten, bei denen es sich um handelt @mentioned. Mithilfe von Microsoft Graph und Berechtigungen auf Organisationsebene können Sie zusätzliche Nachrichten aus der Unterhaltung abrufen.

Bots funktionieren in einem Kanal in den folgenden Fällen besser:

  • Benachrichtigungen, wenn Sie eine interaktive Karte für die Benutzer bereitstellen, die weitere Informationen aufnimmt.
  • Feedbackszenarien wie Abstimmungen und Umfragen.
  • Ein einzelner Anforderungs- oder Antwortzyklus löst Interaktionen auf, und die Ergebnisse sind für mehrere Mitglieder der Unterhaltung nützlich.
  • Soziale/Spaß-Bots, bei denen Sie tolle Katzenbilder erhalten, zufällig einen Gewinner auswählen, usw.

In einem Gruppenchat

Gruppenchats sind Unterhaltungen ohne Threading zwischen drei oder mehr Personen. Sie weisen tendenziell weniger Mitglieder auf als ein Kanal und sind kurzlebiger. Ähnlich wie bei einem Kanal hat Ihr Bot nur Zugriff auf Nachrichten, bei denen er sich direkt befindet @mentioned .

Bots, die in einem Kanal besser funktionieren, funktionieren auch in einem Gruppenchat besser.

In einem 1:1-Chat.

Ein 1:1-Chat ist ein herkömmliches Interaktionsverfahren eines Unterhaltungs-Bots mit einem Benutzer. Einige Beispiele für 1:1-Unterhaltungs-Bots sind:

  • F&A-Bots
  • Bots, die Workflows in anderen Systemen initiieren.
  • Bots, die Witze erzählen.
  • Bots, die Notizen erstellen. Überlegen Sie vor dem Erstellen von 1:1-Chatbots, ob eine konversationsbasierte Schnittstelle die beste Möglichkeit ist, Ihre Funktionalität darzustellen.

Nachteile von Bots

Ein umfangreicher Dialog zwischen Ihrem Bot und dem Benutzer ist ein langsamer und übermäßig komplexer Weg, um eine Aufgabe zu erledigen. Ein Bot, der übermäßige Befehle unterstützt, insbesondere eine breite Palette von Befehlen, wird von Benutzern nicht erfolgreich oder positiv angesehen.

Komplexe Aufgaben im Chat

Ein umfangreiches Dialogfeld erfordert, dass der Entwickler den Status beibehält. Um diesen Zustand zu beenden, muss ein Benutzer entweder ein Timeout ausführen oder Abbrechen auswählen. Auch der Prozess ist mühsam. Sehen Sie sich beispielsweise das folgende Unterhaltungsszenario an:

BENUTZER: Plane eine Besprechung mit Marie.

BOT: Ich habe 200 Ergebnisse gefunden, einschließlich eines Vor- und Nachnamens.

BENUTZER: Plane eine Besprechung mit Marie Krause.

BOT: OK, Wann möchten Sie sich mit Marie Krause treffen?

BENUTZER: um 13:00 Uhr.

BOT: An welchem Tag?

Unterstützung zu vieler Befehle

Da es im aktuellen Bot-Menü nur sechs sichtbare Befehle gibt, wird alles andere wahrscheinlich nicht häufig verwendet. Bots, die detailliert auf einen bestimmten Bereich eingehen, anstatt zu versuchen, ein allgemeiner Assistent zu sein, werden besser funktionieren und besser abschneiden.

Verwalten eines großen Wissensdatenbank

Einer der Nachteile von Bots besteht darin, dass es schwierig ist, eine große Abruf-Wissensdatenbank mit antworten ohne Rangfolge aufrechtzuerhalten. Bots sind am besten für kurze, schnelle Interaktionen geeignet, nicht für das Durchsuchen langer Listen auf der Suche nach einer Antwort.

Einschränkungen und bekannte Probleme

Wenn Sie im Entwicklerportal keinen Bot erstellen können, stellen Sie Folgendes sicher:

  • App-Registrierung ist für Benutzer aktiviert: Wenn eine App-Registrierung organisationsweit deaktiviert ist, können Benutzer (mit Ausnahme von Benutzern mit Microsoft Entra Administratorzugriff) keine neuen Apps registrieren. Damit Benutzer Apps registrieren können, müssen Administratoren benutzer können Anwendungen registrieren im Microsoft Entra Admin Center auf Ja festlegen.

  • Erteilen Sie bestimmten Benutzern Berechtigungen zum Registrieren neuer Apps:

Codeausschnitte

Der folgende Code enthält ein Beispiel für eine Botaktivität für einen Kanalteambereich:


protected override async Task OnMessageActivityAsync(ITurnContext<IMessageActivity> turnContext, CancellationToken cancellationToken)
{
    var mention = new Mention
    {
        Mentioned = turnContext.Activity.From,
        // EncodeName: Converts the name to a valid XML name.
        Text = $"<at>{XmlConvert.EncodeName(turnContext.Activity.From.Name)}</at>",
    };
    
    // MessageFactory.Text(): Specifies the type of text data in a message attachment.
    var replyActivity = MessageFactory.Text($"Hello {mention.Text}.");
    replyActivity.Entities = new List<Entity> { mention };

    // Sends a message activity to the sender of the incoming activity.
    await turnContext.SendActivityAsync(replyActivity, cancellationToken);
}

Der folgende Code enthält ein Beispiel für Bot-Aktivitäten für einen 1:1-Chat:


// Handle message activity
protected override async Task OnMessageActivityAsync(ITurnContext<IMessageActivity> turnContext, CancellationToken cancellationToken)
{
    // Remove recipient mention text from Text property.
    // Use with caution because this function is altering the text on the Activity.
    turnContext.Activity.RemoveRecipientMention();
    var text = turnContext.Activity.Text.Trim().ToLower();

    // Sends a message activity to the sender of the incoming activity.
    await turnContext.SendActivityAsync(MessageFactory.Text($"Your message is {text}."), cancellationToken);
}

Codebeispiel

Beispielname Beschreibung .NETCore Node.js Python Manifest
Teams-Unterhaltungsbot In dieser Beispiel-App wird gezeigt, wie verschiedene Botunterhaltungsereignisse verwendet werden, die in Bot Framework v4 verfügbar sind. View View View Anzeigen
Bot-Beispiele Eine Reihe von Bot Framework v4-Beispielen. View View View

Nächster Schritt

Bot-Aktivitätenhandler

Siehe auch