Tools und SDKs

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

• Microsoft Bot Framework SDK
• Microsoft Entra-ID
• Entwicklerportal
• Power Virtual Agents
• Virtual Assistant
• Webhooks und Connectors
• Bot Framework Composer

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 .

In den Fällen, in denen Bots 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:

  • Bei Microsoft 365-Lizenzen, bei denen das App-Registrierungslimit 250 Apps pro Benutzer beträgt, stellen Sie sicher, dass der Mandantenadministrator einem Benutzer mit den folgenden Rollen Microsoft Entra ID hinzufügt:

    • Anwendungsadministrator
    • Anwendungsentwickler
    • Cloudanwendungsadministrator

    Informationen zum Zuweisen von Rollen finden Sie unter Zuweisen Microsoft Entra Rollen zu Benutzern.

  • Stellen Sie bei Microsoft 365-Lizenzen (P1, P2, E3 oder E5-Plan), bei denen das App-Registrierungslimit standardmäßig auf mandantenlimit (mehr als 300.000) pro Benutzer festgelegt ist, sicher, dass der Mandantenadministrator einem Benutzer Microsoft Entra ID hinzufügt und dem Benutzer eine benutzerdefinierte Rolle mit den folgenden Berechtigungen zuweist:

    • microsoft.directory/applications/create
    • microsoft.directory/applications/createAsOwner

Codeausschnitte

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

C#

• SDK-Referenz

• Beispielcodereferenz

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);
}

Node.js

• SDK-Referenz

• Beispielcodereferenz

this.onMessage(async (turnContext, next) => {
    const mention = {
        mentioned: turnContext.activity.from,

        // TextEncoder().encode(): Encodes the supplied characters.
        text: `<at>${ new TextEncoder().encode(turnContext.activity.from.name) }</at>`,
    } as Mention;

    // MessageFactory.text(): Specifies the type of text data in a message attachment.
    const replyActivity = MessageFactory.text(`Hello ${mention.text}`);
    replyActivity.entities = [mention];

    await turnContext.sendActivity(replyActivity);

    // By calling next() you ensure that the next BotHandler is run.
    await next();
});

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

C#

• SDK-Referenz

• Beispielcodereferenz

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

Node.js

• SDK-Referenz
• Beispielcodereferenz

this.onMessage(async (context, next) => {
    // MessageFactory.text(): Specifies the type of text data in a message attachment.
    await context.sendActivity(MessageFactory.text("Your message is:" + context.activity.text));
    await next();
});

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	Anzeigen

Nächster Schritt

Bot-Aktivitätenhandler

Siehe auch

• Erstellen von Bots für Teams
• Erstellen von benutzerdefinierten Triggern in Bot Framework Composer
• API-Referenz für den Bot Framework Connector-Dienst
• Veröffentlichen Ihres Bots in Azure
• Authentifizierungsfluss für Bots in Microsoft Teams
• Kanal- und Gruppenchatunterhaltungen mit einem Bot