App Service-Erweiterung für Direct Line

Ab dem 1. September 2023 wird dringend empfohlen, die Azure Service Tag-Methode für dieNetzwerkisolation zu verwenden. Die Verwendung von DL-ASE sollte auf hochspezifische Szenarien beschränkt sein. Vor der Implementierung dieser Lösung in einer Produktionsumgebung empfehlen wir Ihnen, Ihr Supportteam um Anleitungen zu bitten.

GILT FÜR: 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. Sie wird unter demselben Abonnement, App Service-Instanz und Azure-Netzwerk wie Ihr Bot ausgeführt und ermöglicht die Netzwerkisolation und, in manchen Fällen, verbesserte Leistung. Die Clientanwendung verwendet das WebSocket-Protokoll für die Kommunikation mit dem Bot.

Die Direct Line App Service-Erweiterung wird nur in einem Windows-App-Dienst unterstützt und wird derzeit nicht in einem Linux-App-Dienst unterstützt.

Die folgende Abbildung zeigt die allgemeine Architektur:

Diagram illustrating the Direct Line App Service extension architecture.

Hinweis

Wenn Sie keine Netzwerkisolation benötigen und den Standardkanal über das HTTPS-Protokoll verwenden möchten, lesen Sie Einen Bot mit Direct Line verbinden.

Die App Service-Erweiterung für Direct Line fügt dem Bot Framework-Protokoll einen neuen Satz von Streamingerweiterungen hinzu. Diese Erweiterungen ersetzen HTTP für den Nachrichtenaustausch durch eine Transportmethode, die die Übermittlung bidirektionaler Anforderungen über einen persistenten Websocket ermöglicht.

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. 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. Streamingerweiterungen bauen auf der Verwendung des Websockets auf und ermöglichen es, die gesamte Messagingkommunikation an diesen Websocket zu senden. Streamingerweiterungen können auch zwischen Kanaldiensten und dem Bot verwendet werden.

Die App Service-Erweiterung für Direct Line ist in allen Instanzen von Azure App Services in jedem Rechenzentrum weltweit vorinstalliert. Sie wird von Microsoft gepflegt und verwaltet, sodass für den Kunden keinerlei zusätzlicher Bereitstellungsaufwand anfällt. 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.

Weitere Informationen

Name Beschreibung
Konfigurieren eines .NET-Bots für die Erweiterung 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.
Konfigurieren eines Node.js-Bots für die Erweiterung 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.
Erstellen eines .NET-Clients mit Erweiterung Erstellen Sie einen .NET-Client in C#, der eine Verbindung mit der App Service-Erweiterung für Direct Line herstellt.
Verwenden der Erweiterung mit WebChat Verwenden von Web Chat mit der App Service-Erweiterung für Direct Line
Verwenden der Erweiterung innerhalb eines VNET Verwenden Sie die App Service-Erweiterung für Direct Line mit einem virtuellen Azure-Netzwerk (Virtual Network, VNET).

Zusätzliche Ressourcen