Registrieren eines Bots mit der Cloudkommunikations-API
Sie können die Cloudkommunikations-API in Microsoft Graph verwenden, um Bots zu erstellen, um auf die Anforderungen Ihrer Kunden zu reagieren und die Zusammenarbeit zu erleichtern. In diesem Artikel wird beschrieben, wie Sie Ihren Bot registrieren und dann den Status Ihres Bots verwalten.
Voraussetzungen
Bevor Sie beginnen, machen Sie sich mit den folgenden Themen vertraut:
- Microsoft Entra ID (Microsoft Entra ID) und wie der Dienst Mitarbeitern hilft, sich anzumelden und auf Ressourcen zuzugreifen.
- Die Azure Bot Service und ihre Funktionen.
Registrieren eines Bots
Die Begriffe "Dienstanwendung" und "Bot" können synonym verwendet werden. Sie können einen Bot entweder direkt über die Azure-Portal erstellen oder einen Bot registrieren, der nicht in Azure gehostet wird. Weitere Informationen finden Sie unter Registrieren eines aufrufenden Bots.
Um die Dinge später zu vereinfachen, ist es hilfreich, die verschiedenen Arten von Berechtigungen in Microsoft Entra ID zu verstehen. Apps mit delegierten Berechtigungen erfordern einen angemeldeten Benutzer. Anwendungsbasierte Berechtigungen benötigen keinen angemeldeten Benutzer und können häufig als Hintergrunddienst ausgeführt werden.
Wenn Sie Ihren Bot nach der Registrierung zu Microsoft Teams hinzufügen möchten, stellen Sie sicher, dass Sie verstehen, wie Sie das Entwicklerportal für Teams verwenden und die erforderlichen Metadaten definieren.
Verwalten des Zustands des Bots
Nachdem Sie Ihren Bot registriert haben, entscheiden Sie, ob Ihre audio- und videobasierten Medien anwendungsgehostet oder vom Dienst gehostet werden sollen. Auf hoher Ebene umfasst dies die Entscheidung, ob Sie auf einen Livestream von Rohmedien zugreifen möchten oder nicht.
Als Nächstes können Sie entscheiden, ob Ihr Bot zustandsbehaftet oder zustandslos sein soll.
Zustandslose Bots
Jeder virtuelle Computer kann jeden Bot instance verarbeiten, d. h., wenn ein Computer ausfällt, kann sich ein anderer darum kümmern. Dies sorgt für eine resiliente Lösung.
Auf der anderen Seite muss auf einen freigegebenen Cache wie REDIS für alle virtuellen Computer zugegriffen werden können.
Zustandsbehaftete Bots
Ein virtueller Computer kann jeweils nur einen Bot instance verarbeiten. Da sich alle Zustände auf einem Computer befinden, gibt es keine zusätzlichen Arbeitsspeicher- oder REDIS-Cacheüberprüfungen.
Der Nachteil ist, dass er nicht so resilient ist, da sich der Bot instance nur auf einem Computer befindet.
Hinweis
Vom Dienst gehostete Medienbots können zustandsbehaftet oder zustandslos sein. Anwendungsgehostete Medienbots müssen zustandsbehaftet sein, um das Bot Media SDK verwenden zu können.
SDKs verwenden
Die folgenden SDKs sind in C# verfügbar. Wir werden in Zukunft Unterstützung für andere Sprachen bereitstellen.
- Wenn Sie zustandslose Bots verwenden, installieren Sie das Graph Communications Core SDK.
- Wenn Sie zustandsbehaftete Bots verwenden, installieren Sie das Graph Communications Calling SDK.
Beispiele
Erfahren Sie, wie Sie verschiedene Szenarien mit zustandsbehafteten Bots implementieren, z. B. das Annehmen eines eingehenden Anrufs mit von der Anwendung gehosteten oder vom Dienst gehosteten Medien.
Weitere Beispiele finden Sie im Repository für Kommunikationsbeispiele.
Datenschutz und Compliance
In den Anforderungen an unsere APIs sollten vertrauliche Daten nicht in clientseitigen generierten IDs (z. B. Szenario-IDs, Anforderungs-IDs oder andere Korrelations-IDs) in Headern oder im Anforderungstext gesendet werden. Diese IDs werden serverseitig für Diagnose protokolliert.