App Service-Erweiterung für Direct LineDirect Line App Service Extension

gilt für: SDK v4APPLIES TO: SDK v4

Mit der App Service-Erweiterung für Direct Line können Clients eine direkte Verbindung mit dem Host herstellen, auf dem sich der Bot befindet.The Direct Line App Service Extension allows clients to connect directly with the host, where the bot is located. Sie wird innerhalb desselben Abonnements, App Service und Azure-Netzwerks wie Ihr bot ausgeführt und bietet Netzwerk Isolation und in einigen Fällen eine bessere Leistung.It runs inside the same subscription, App Service, and Azure network as your bot and provides network isolation and, in some cases, improved performance. Die Client Anwendung verwendet das WebSocket-Protokoll für die Kommunikation mit dem bot.The client application uses WebSocket protocol to communicate with the bot. Die folgende Abbildung zeigt die allgemeine Architektur:The following picture shows the overall architecture:

Direct Line App Service-Erweiterungs ArchitekturDirect line app service extension architecture

Hinweis

Wenn Sie keine Netzwerk Isolation benötigen und den Standard Kanal über das HTTPS-Protokoll verwenden möchten, finden Sie unter Verbinden eines Bots mit einer direkten LeitungWeitere Informationen.If you do not require network isolation and want to use the standard channel over the HTTPS protocol, refer to Connect a bot to Direct Line.

Die DirectLine-App Service Erweiterung fügt dem bot Framework-Protokoll einen neuen Satz von streamingerweiterungen hinzu, durch die HTTP zum Austauschen von Nachrichten mit einem Transport ersetzt wird, mit dem bidirektionale Anforderungen über einen persistenten WebSocket gesendet werden können.The Direct Line App Service Extension adds a new set of streaming extensions to the Bot Framework protocol, which replace HTTP for exchanging messages with a transport that allows bidirectional requests to be sent over a persistent WebSocket.

Vor der Verfügbarkeit von Streamingerweiterungen bot die Direct Line-API eine einzelne Methode, mit der ein Client Aktivitäten an Direct Line senden konnte, und zwei Methoden, mit denen ein Client Aktivitäten von Direct Line abrufen konnte.Before streaming extensions, the Direct Line API offered one way for a client to send Activities to Direct Line and two ways for a client to retrieve Activities from Direct Line. Die Nachrichten wurden über einen HTTP POST-Vorgang gesendet und entweder per HTTP GET (Abruf) oder durch Öffnen eines Websockets für den Empfang von Aktivitätssätzen empfangen.The messages were sent via an HTTP POST, and received by either an HTTP GET (polling) or by opening a WebSocket to receive ActivitySets. Streamingerweiterungen bauen auf der Verwendung des Websockets auf und ermöglichen es, die gesamte Messagingkommunikation an diesen Websocket zu senden.Streaming extensions expand on the use of the WebSocket an allows all messaging communication to be sent on that WebSocket. Streamingerweiterungen können auch zwischen Kanaldiensten und dem Bot verwendet werden.Streaming extensions can also be used between channel services and the bot.

Die direkt linienApp Service Erweiterung ist auf allen Instanzen Azure-App Dienste in jedem Rechenzentrum weltweit vorinstalliert.The Direct Line App Service Extension is pre-installed on all instances of Azure App Services in every data center around the world. Sie wird von Microsoft gepflegt und verwaltet, sodass für den Kunden keinerlei zusätzlicher Bereitstellungsaufwand anfällt.It is maintained and managed by Microsoft without additional deployment work for the customer. Sie ist in Azure App Services standardmäßig deaktiviert, kann jedoch ganz einfach aktiviert werden, um eine Verbindung mit Ihrem gehosteten Bot herstellen zu können.It is disabled on Azure App Services by default, but it can be easily turned on so that it can connect to your hosted bot.

Weitere InformationenSee Also

NameName BESCHREIBUNGDescription
Konfigurieren eines .NET-Bots für die ErweiterungConfigure .NET bot for extension Aktualisieren Sie einen .NET-Bot für die Verwendung von Named Pipes, und aktivieren Sie die App Service-Erweiterung für Direct Line in der Azure App Service-Ressource, in der der Bot gehostet wird.Update a .NET bot to work with named pipes, and enable the Direct Line App Service Extension in the Azure App Service resource where the bot is hosted.
Konfigurieren eines Node.js-Bots für die ErweiterungConfigure Node.js bot for extension Aktualisieren Sie einen Node.js-Bot für die Verwendung von Named Pipes, und aktivieren Sie die App Service-Erweiterung für Direct Line in der Azure App Service-Ressource, in der der Bot gehostet wird.Update a Node.js bot to work with named pipes and enable the Direct Line App Service Extension in the Azure App Service resource where the bot is hosted.
Erstellen eines .NET-Clients mit ErweiterungCreate .NET client with Extension Erstellen Sie einen .NET-Client in c#, der eine Verbindung mit der direkten Zeile App Service Erweiterung herstellt.Create a .NET client in C# which connects to the Direct Line App Service Extension.
Erweiterung mit Webchat verwendenUse extension with Web Chat Verwenden Sie den Webchat mit der Direct Line App Service-Erweiterung.Use Web Chat with the Direct Line App Service Extension.
Verwenden der Erweiterung innerhalb eines VNETUse extension within VNET Verwenden Sie die direkte Zeilen App Service Erweiterung mit einem Azure Virtual Network (vnet).Use the Direct Line App Service Extension with an Azure Virtual Network (VNET).

Zusätzliche RessourcenAdditional resources