Herstellen einer Verbindung mit Direct Line Speech für einen BotConnect a bot to Direct Line Speech

gilt für: SDK v4APPLIES TO: SDK v4

In diesem Artikel wird beschrieben, wie Sie einen Bot mit dem Direct Line Speech verbinden.This article describes how to connect a bot to the Direct Line Speech channel. Verwenden Sie diesen Kanal, um Benutzern die Interaktion mit einem Bot per Stimme zu ermöglichen.Use this channel to allow users to interact with a bot via voice.

Nachdem Sie Ihren Bot erstellt haben, ermöglicht das Onboarding mit Direct Line Speech verbindung mit Clientanwendungen mit geringer Latenz und hoher Zuverlässigkeit mithilfe des Speech SDK.Once you've built your bot, onboarding it with Direct Line Speech will enable low latency, high reliability connection with client applications using the Speech SDK. Diese Verbindungen sind für Voice-In- und Voice-Out-Konversationserfahrungen optimiert.These connections are optimized for voice in and voice out conversational experiences. Weitere Informationen zu Direct Line Speech und zur Entwicklung von Clientanwendungen finden Sie auf der Seite Informationen zu virtuellen Voice-First-Assistenten (Vorschauversion).For more information on Direct Line Speech and how to build client applications, visit the custom voice-first virtual assistant page.

VoraussetzungenPrerequisites

Der Direct Line Speech-Kanal erfordert eine Cognitive Services Ressource, insbesondere eine Cognitive Services-Ressource für Die Spracherkennung.The Direct Line Speech channel requires a Cognitive Services resource, specifically a speech cognitive service resource. Sie können entweder eine bereits vorhandene Ressource verwenden oder eine neue Ressource erstellen.You can either use an existing resource or create a new one. Wenn Sie eine neue Speech-Ressource erstellen möchten, gehen Sie wie folgt vor:To create a new speech resource follow these steps:

  1. Wechseln Sie zum Azure-Portal, um Ressourcen zu erstellen.Go to the Azure portal to create resources.

  2. Geben Sie im rechten Bereich Sprache in das Suchfeld ein.In the right pane, enter speech in the search box.

  3. Wählen Sie in der Dropdownliste Speech aus.In the the drop-down list select Speech. Es wird eine Seite geöffnet, die diesen Ressourcentyp beschreibt.It will open a page describing this resource type.

    Erstellen einer Cognitive-Ressource vom Typ „Speech“create speech cognitive resource

  4. Wählen Sie Erstellen aus, und führen Sie die Schritte des Assistenten aus.Select Create and follow the wizard steps.

    Weitere Informationen finden Sie unter Erstellen einer Cognitive Services-Ressource mithilfe des Azure-Portals.For additional information, see Create a Cognitive Services resource.

Hinzufügen des Direct Line Speech-KanalsAdd the Direct Line Speech channel

  1. Navigieren Sie in Ihrem Browser zum Azure-Portal.In your browser, navigate to the Azure Portal.

  2. Wählen Sie in Ihren Ressourcen die Ressource Botkanalregistrierung oder Web-App-Bot aus, je nachdem, wie Sie den Bot bereitgestellt haben.From your resources, select the Bot Channel Registration or Web App Bot resource, depending on how you deployed the bot.

  3. Wählen Sie im linken Bereich Kanäle aus.In the left panel, select Channels.

    Auswählen von Kanälenselecting channels

  4. Klicken Sie im rechten Bereich auf Direct Line Speech Symbol.In right panel, click the Direct Line Speech icon.

    Auswählen des Direct Line Speech-Kanalsselecting direct line speech channel

  5. Konfigurieren Sie Direct Line Speech gemäß der folgenden Abbildung:Configure the Direct Line Speech as shown in the picture below. Fügen Sie insbesondere das Cognitive Service-Konto (Spracherkennungsdienst) hinzu, das im Abschnitt Voraussetzungen erwähnt wurde.Specifically, add the Cognitive service account (speech service) mentioned in the Prerequisites section.

    Konfigurieren des Direct Line Speech-Kanalsconfigure direct line speech channel

  6. Klicken Sie nach dem Lesen der Nutzungsbedingungen auf Save, um Ihre Kanalauswahl zu bestätigen.Once you've reviewed the terms of use, click Save to confirm your channel selection. Dadurch wird der Kanal zum Bot hinzugefügt.This will add the channel to the bot.

    Speichern des aktivierten Direct Line Speech Kanalssaving the enabled of Direct Line Speech channel

Aktivieren der Bot Framework-ProtokollstreamingerweiterungenEnable the Bot Framework Protocol Streaming Extensions

Nachdem der Direct Line Speech-Kanal jetzt mit Ihrem Bot verbunden ist, müssen Sie nun die Unterstützung der Bot Framework-Protokollstreamingerweiterungen aktivieren, um eine optimale Interaktion mit geringer Latenz zu erzielen.With the Direct Line Speech channel connected to your bot, you now need to enable Bot Framework Protocol Streaming Extensions support for optimal, low-latency interaction.

  1. Klicken Sie im linken Bereich auf Settings (Einstellungen).In the left pane, select Settings.

  2. Wählen Sie im rechten Bereich das Kontrollkästchen unter Streamingendpunkt aktivieren aus.In the right pane, select the box by the Enable Streaming Endpoint.

    Aktivieren des Streamingprotokollsenable the streaming protocol

  3. Klicken Sie am oberen Rand der Seite auf Speichern.At the top of the page, select Save.

  4. Navigieren Sie zum Bot-App-Dienst.Navigate to the bot app service.

  5. Wählen Sie im linken Bereich in der Kategorie App Service Einstellungen die Option Konfiguration aus.In the left pane, in the App Service Settings category, select Configuration.

    Navigieren zu den App Service-Einstellungennavigate to app service settings

  6. Wählen Sie im rechten Bereich die General settings Registerkarte aus.In the right pane, select the General settings tab.

  7. Legen Sie Web sockets auf Ein fest.Set Web sockets to On.

    Aktivieren von WebSockets für App Serviceenable websockets for the app service

  8. Wählen Sie Save oben auf der Konfigurationsseite aus.Select Save at the top of the configuration page.

Die Bot Framework-Protokollstreamingerweiterungen sind jetzt für Ihren Bot aktiviert.The Bot Framework Protocol Streaming Extensions are now enabled for your bot. Sie können nun Ihren Botcode aktualisieren und die Unterstützung von Streamingerweiterungen in ein vorhandenes Botprojekt integrieren.You are now ready to update your bot code and integrate Streaming Extensions support to an existing bot project.

BeispielExample

Wenn Sie alle beschriebenen Schritte ausgeführt haben, können Sie mit dem Bot kommunizieren, indem Sie die Clientanwendung verwenden, die an diesem Speicherort herunterladbar ist: Windows Voice Assistant Client.If you have followed all the steps described, you can talk to the bot using the client application downloadable at this location: Windows Voice Assistant Client.

Die folgende Abbildung zeigt die Clientanwendungsschnittstelle bei der Kommunikation mit einem einfachen Echobot.The following picture shows the client application interface when communicating with a simple echo bot. Siehe auch Voice-enable your bot using the Speech SDK (Sprach-Aktivierung Ihres Bots mit dem Speech SDK).See also Voice-enable your bot using the Speech SDK.

Sprachassistent-Clientvoice assistant client

Hinzufügen von Protokollunterstützung zu Ihrem BotAdding protocol support to your bot

Hinweis

Der folgende Schritt ist nur für Bots erforderlich, die vor der Version 4.8 SDK erstellt wurden.The following step is only needed for bots built before the the v4.8 SDK release.

Nachdem die Verbindung mit dem Direct Line Speech-Kanal hergestellt und die Unterstützung für die Bot Framework-Protokollstreamingerweiterungen aktiviert wurde, müssen Sie Ihrem Bot nur noch Code hinzufügen, um die optimierte Kommunikation zu unterstützen.With the Direct Line Speech channel connected and support for the Bot Framework Protocol Streaming Extensions enabled, all that's left is to add code to your bot to support the optimized communication. Befolgen Sie die Anleitung auf der Seite mit den Informationen zum Hinzufügen der Unterstützung für Streamingerweiterungen in Ihrem Bot, um die vollständige Kompatibilität mit Direct Line Speech sicherzustellen.Follow the instructions on adding Streaming Extensions support to your bot to ensure full compatibility with Direct Line Speech.