Schlüsselkonzepte in Direct Line API 3.0

  • Artikel

Sie können die Kommunikation zwischen Ihrem Bot und Ihrer eigenen Clientanwendung mithilfe der Direct Line-API aktivieren. In diesem Artikel werden die Schlüsselkonzepte in Direct Line API 3.0 eingeführt und Informationen zu den relevanten Entwicklerressourcen bereitgestellt. Sie können einen Client mit dem SDK, der REST-API oder dem Webchat erstellen.

Authentifizierung

Direct Line API 3.0-Anforderungen können entweder mithilfe eines Geheimnisses authentifiziert werden, das Sie von der Direct Line Kanalkonfigurationsseite im Azure-Portal abrufen, oder mithilfe eines Tokens, das Sie zur Laufzeit abrufen. Weitere Informationen finden Sie unter Authentifizierung.

Starten einer Konversation

Direct Line-Unterhaltungen werden explizit von Clients geöffnet und können solange ausgeführt werden, wie Bot und Client daran teilnehmen und gültige Anmeldeinformationen aufweisen. Weitere Informationen finden Sie unter Starten einer Konversation.

Senden von Nachrichten

Ein Client kann unter Verwendung von Direct Line API 3.0 Nachrichten an Ihren Bot senden, indem er HTTP POST-Anforderungen ausgibt. Ein Client kann eine einzelne Nachricht pro Anforderung senden. Weitere Informationen finden Sie unter Senden einer Aktivität an den Bot.

Empfangen von Nachrichten

Ein Client kann unter Verwendung von Direct Line API 3.0 Nachrichten von Ihrem Bot entweder über WebSocket-Stream oder durch Ausgeben von HTTP GET-Anforderungen empfangen. Mithilfe einer dieser beiden Techniken kann ein Client möglicherweise gleichzeitig mehrere Nachrichten vom Bot als Teil eines ActivitySet empfangen. Weitere Informationen finden Sie unter Empfangen von Aktivitäten vom Bot.

Entwicklerressourcen

Clientbibliotheken

Bot Framework stellt Clientbibliotheken bereit, die den Zugriff auf Direct Line API 3.0 über C# und Node.js erleichtern.

  • Um die .NET-Clientbibliothek in einem Visual Studio-Projekt zu verwenden, installieren Sie das Microsoft.Bot.Connector.DirectLineNuGet-Paket.s

  • Um die Node.js-Clientbibliothek zu verwenden, installieren Sie die Bibliothek mithilfe von botframework-directlinejsNPM (oder laden Sie die Quelle herunter).

Webchat-Steuerelement

Bot Framework stellt ein Steuerelement bereit, mit dem Sie einen Direct Line-gestützten Bot in Ihre Clientanwendung einbetten können. Weitere Informationen finden Sie unter Microsoft Bot Framework, WebChat-Steuerelement.