Skip to content

Commit 6e57577

Browse files
authored
Merge pull request #82328 from nt-7/patch-3
Update tutorial-voice-enable-your-bot-speech-sdk.md due to deprecated
2 parents 704eea2 + 28b5336 commit 6e57577

File tree

1 file changed

+27
-24
lines changed

1 file changed

+27
-24
lines changed

articles/cognitive-services/Speech-Service/tutorial-voice-enable-your-bot-speech-sdk.md

Lines changed: 27 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -231,66 +231,69 @@ You'll need to make a small configuration change so that your bot can communicat
231231
232232
## Create a channel registration
233233

234-
Now that you've created an Azure App Service to host your bot, the next step is to create a **Bot Channels Registration**. Creating a channel registration is a prerequisite for registering your bot with Bot Framework channels, including Direct Line Speech channel. If you'd like to learn more about how bots use channels, see [Connect a bot to channels](/azure/bot-service/bot-service-manage-channels).
234+
Now that you've created an Azure App Service to host your bot, the next step is to create an **Azure Bot**. Creating a channel registration is a prerequisite for registering your bot with Bot Framework channels, including Direct Line Speech channel. If you'd like to learn more about how bots use channels, see [Connect a bot to channels](/azure/bot-service/bot-service-manage-channels).
235235

236-
1. <a href="https://ms.portal.azure.com/#create/Microsoft.BotServiceConnectivityGalleryPackage" target="_blank">Create an Azure Bot Channels Registration </a>
237-
2. You'll be prompted to provide some information:
236+
1. <a href="https://ms.portal.azure.com/#create/Microsoft.AzureBot" target="_blank">Create an Azure Bot</a>
237+
1. You'll be prompted to provide some information:
238238
* For **Bot handle**, enter **SpeechEchoBotTutorial-BotRegistration-####** and replace **####** with your a number of your choice. Note that Bot handle must be globally unique. If you enter a Bot handle but get the error message _The requested bot ID is not available_, then pick a different number. In the examples below we used 8726
239239
* For **Subscription**, select **Free Trial**.
240240
* For **Resource group**, select **SpeechEchoBotTutorial-ResourceGroup**.
241-
* For **Location**, select **West US**.
242-
* For **Pricing tier**, select **F0**.
243-
* For **Messaging endpoint**, enter the URL for your web app with the `/api/messages` path appended at the end. For example: if your globally unique App Name was **EchoBot20190805125647**, your messaging endpoint would be: `https://EchoBot20190805125647.azurewebsites.net/api/messages/`.
244-
* For **Application insights**, you can set this to **Off**. For more information, see [Bot analytics](/azure/bot-service/bot-service-manage-analytics).
245-
* Ignore **Auto create App ID and password**.
246-
5. At the bottom of the **Bot Channels Registration** blade, click **Create**.
241+
* For **Location**, select **West US**.
242+
* For **Pricing tier**, select **F0**.
243+
* Ignore **Auto create App ID and password**.
244+
1. At the bottom of the **Azure Bot** blade, select **Create**.
245+
1. After you create the resource, open your **SpeechEchoBotTutorial-BotRegistration-####** resource in the Azure portal.
246+
1. From the **Settings** navigation, select **Configuration**.
247+
1. For **Messaging endpoint**, enter the URL for your web app with the `/api/messages` path appended. For example, if your globally unique app name was **EchoBot20190805125647**, your messaging endpoint would be `https://EchoBot20190805125647.azurewebsites.net/api/messages/`.
247248

248249
At this point, check your Resource Group **SpeechEchoBotTutorial-ResourceGroup** in the Azure portal. It should now show at least four resources:
249250

250251
| Name | Type | Location |
251252
|------|-------|----------|
252253
| EchoBot20190805125647 | App Service | West US |
253254
| SpeechEchoBotTutorial-AppServicePlan | App Service plan | West US |
254-
| SpeechEchoBotTutorial-BotRegistration-8726 | Bot Channels Registration | Global |
255+
| SpeechEchoBotTutorial-BotRegistration-8726 | Azure Bot | Global |
255256
| SpeechEchoBotTutorial-Speech | Cognitive Services | West US |
256257

257258
> [!IMPORTANT]
258-
> The Bot Channels Registration resource will show the Global region even though you selected West US. This is expected.
259+
> The Azure Bot resource will show the Global region, even though you selected West US. This is expected.
259260
260261
## Optional: Test in web chat
261262

262-
The Azure Bot Channels Registration page has a **Test in Web Chat** option under **Bot Management**. It will not work by default with your bot, since web chat needs to authenticate against your bot. If you would like to test your deployed bot with text input, follow the steps below. Note that these steps are optional, and are not required in order to continue with the next steps of the tutorial.
263+
The Azure Bot page has a **Test in Web Chat** option under **Settings**. It will not work by default with your bot because web chat needs to authenticate against your bot. If you would like to test your deployed bot with text input, follow the steps below. Note that these steps are optional and are not required for you to continue with the next steps of the tutorial.
263264

264265
1. Locate and open your **EchoBotTutorial-BotRegistration-####** resource in the [Azure portal](https://portal.azure.com)
265-
1. From the **Bot management** navigation, select **Settings**. Copy the value under **Microsoft App ID**
266+
1. From the **Settings** navigation, select **Configuration**. Copy the value under **Microsoft App ID**
266267
1. Open the Visual Studio EchoBot solution. In the solution explorer, locate and double click on **appsettings.json**
267268
1. Replace the empty string next to **MicrosoftAppId** in the JSON file with the copied ID value
268-
1. Got back to the Azure portal, in **Bot management** navigation, select **Settings**, and click on **(Manage)** next to **Microsoft App ID**
269+
1. Got back to the Azure portal, in **Settings** navigation, select **Configuration**, and click on **(Manage)** next to **Microsoft App ID**
269270
1. Click on **New client secret**. Add a description (e.g. "web chat") and click **Add**. Copy the new secret
270271
1. Replace the empty string next to **MicrosoftAppPassword** in the JSON file with the copied secret value
271272
1. Save the JSON file. It should look something like this:
272-
```json
273-
{
274-
"MicrosoftAppId": "3be0abc2-ca07-475e-b6c3-90c4476c4370",
275-
"MicrosoftAppPassword": "-zRhJZ~1cnc7ZIlj4Qozs_eKN.8Cq~U38G"
276-
}
277-
```
278-
9. Re-publish the app (right-click on **EchoBot** project in Visual Studio solution explorer, select **Publish...** and click on the **Publish** button)
279-
10. Now you are ready to test the bot in web chat!
273+
274+
```json
275+
{
276+
"MicrosoftAppId": "3be0abc2-ca07-475e-b6c3-90c4476c4370",
277+
"MicrosoftAppPassword": "-zRhJZ~1cnc7ZIlj4Qozs_eKN.8Cq~U38G"
278+
}
279+
```
280+
281+
1. Republish the app (right-click on **EchoBot** project in Visual Studio Solution Explorer, select **Publish...** and click on the **Publish** button)
282+
1. Now you are ready to test the bot in web chat!
280283

281284
## Register the Direct Line Speech channel
282285

283286
Now it's time to register your bot with the Direct Line Speech channel. This channel creates a connection between your bot and a client app compiled with the Speech SDK.
284287

285288
1. Locate and open your **SpeechEchoBotTutorial-BotRegistration-####** resource in the [Azure portal](https://portal.azure.com).
286-
1. From the **Bot management** navigation, select **Channels**.
289+
1. From the **Settings** navigation, select **Channels**.
287290
* Under **More channels**, click **Direct Line Speech**.
288291
* Review the text on the page titled **Configure Direct line Speech**, then expand the **Cognitive service account** drop-down menu.
289292
* Select the speech resource you created earlier (e.g., **SpeechEchoBotTutorial-Speech**) from the menu to associate your bot to your speech subscription key.
290293
* Ignore the rest of the optional fields.
291294
* Click **Save**.
292295

293-
1. From the **Bot management** navigation, click **Settings**.
296+
1. From the **Settings** navigation, click **Configuration**.
294297
* Check the box labeled **Enable Streaming Endpoint**. This is needed to create a communication protocol built on web sockets between your bot and the Direct Line Speech channel.
295298
* Click **Save**.
296299

0 commit comments

Comments
 (0)