From 11100fda3fc28ed5b1c1e99acee50d469eed1ba8 Mon Sep 17 00:00:00 2001
From: Ryan Lengel Isgrig <43043272+ryanlengel@users.noreply.github.com>
Date: Wed, 25 Mar 2020 11:05:57 -0700
Subject: [PATCH] Various doc enhancements from bug bash (#3228)
* Close #3208 resolving Customise VA doc for csharp/typescript
* Close #3211 DLS tutorial adds BF Emulator and updates Cognitive Services client
* Sync Calendar Skill doc with latest from next branch
* Close #3221 clarifying running the meeting room script
---
.../4-integrate-speech-channel.md | 12 +++++---
docs/_docs/skills/samples/calendar.md | 27 ++++++++++++------
.../csharp/2-edit-your-greeting.md | 6 ++--
.../csharp/3-edit-responses.md | 7 +++--
.../csharp/4-edit-your-cognitive-models.md | 8 +++---
.../4-edit-your-cognitive-models.md | 6 ++--
.../images/calendar-meeting-room-script.png | Bin 0 -> 52724 bytes
docs/assets/images/dlspeech_emulator.png | Bin 0 -> 91724 bytes
docs/assets/images/dlspeechclient.png | Bin 31178 -> 61795 bytes
docs/assets/images/dlspeechclientsettings.png | Bin 20691 -> 48065 bytes
10 files changed, 41 insertions(+), 25 deletions(-)
create mode 100644 docs/assets/images/calendar-meeting-room-script.png
create mode 100644 docs/assets/images/dlspeech_emulator.png
diff --git a/docs/_docs/clients-and-channels/tutorials/enable-speech/4-integrate-speech-channel.md b/docs/_docs/clients-and-channels/tutorials/enable-speech/4-integrate-speech-channel.md
index 1fc4639f23..1a90760848 100644
--- a/docs/_docs/clients-and-channels/tutorials/enable-speech/4-integrate-speech-channel.md
+++ b/docs/_docs/clients-and-channels/tutorials/enable-speech/4-integrate-speech-channel.md
@@ -2,15 +2,19 @@
layout: tutorial
category: Clients and Channels
subcategory: Extend to Direct Line Speech
-title: Build speech sample app
+title: Select a Direct Line Speech client
order: 4
---
# Tutorial: {{page.subcategory}}
-## Integrating with the Speech Channel
+## Option A: Using the Bot Framework
+1. Download the [latest release from the Bot Framework Emulator repository](https://github.com/Microsoft/botframework-emulator/).
+
-1. Download the [latest release from the Direct Line Speech Client repository](https://github.com/Azure-Samples/Cognitive-Services-Direct-Line-Speech-Client/releases).
-1. Follow the [quickstart instructions](https://github.com/Azure-Samples/Cognitive-Services-Direct-Line-Speech-Client#quickstart) to set up your environment and connect to your Virtual Assistant.
+
+## Option B: Using a sample Cognitive Services Voice Assistant client
+1. Download the [latest release from the Cognitive Services Voice Assistant repository](https://github.com/Azure-Samples/Cognitive-Services-Voice-Assistant/releases).
+1. Follow the [instructions on getting started](https://github.com/Azure-Samples/Cognitive-Services-Voice-Assistant/tree/master/samples/clients/csharp-wpf#getting-started) to set up your environment and connect to your Virtual Assistant.
\ No newline at end of file
diff --git a/docs/_docs/skills/samples/calendar.md b/docs/_docs/skills/samples/calendar.md
index c1c490e999..55bfcf8e43 100644
--- a/docs/_docs/skills/samples/calendar.md
+++ b/docs/_docs/skills/samples/calendar.md
@@ -172,9 +172,9 @@ To use a Google account follow these steps:
The Calendar skill provides additional support to search and book meeting rooms. Due to search limitations in Microsoft Graph limiting the experience we leverage Azure Search to provide fuzzy meeting room name matching, floor level, etc.
-1. To simplify the process of extracting your meeting room data and inserting into Azure Search we have provided an example PowerShell script. However, you should ensure that `displayName`, `emailAddress`, `building` and `floorNumber` are populated within your Office 365 tenant (example below)). You can do this through the [Graph Explorer]() using the query shown below, this information is required for the Meeting Room booking expeirence.
+1. To simplify the process of extracting your meeting room data and inserting into Azure Search we have provided an example PowerShell script. However, you should ensure that `displayName`, `emailAddress`, `building` and `floorNumber` are populated within your Office 365 tenant (example below)). You can do this through the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer/preview) using the query shown below, this information is required for the Meeting Room booking experience.
-`https://graph.microsoft.com/beta/me/findrooms`
+`https://graph.microsoft.com/beta/places/microsoft.graph.room`
```json
{
"value": [
@@ -196,16 +196,26 @@ The Calendar skill provides additional support to search and book meeting rooms.
}
```
-2. Configure the settings of your registered app in Azure App Registration portal
- - Make sure your account has permission to access your tenant's meeting room data, testing the previous query will validate this.
- - In Authentication, set "Treat application as a public client" as "Yes"
- - In API Permissions, add Scope: **Place.Read.All**
+1. In the **Azure Portal**, Configure the settings of your registered Calendar Skill app at **Azure Active Directory** > **App registrations**
+ - This app will request the permission for **Place.Read.All** scope. There are two ways to grant the consent:
+ 1. In the **API permissions** tab, add a permission for **Place.Read.All** scope, and grant admin consent for your organization.
+ 2. Make sure your account has permission to access your tenant's meeting room data so that you can consent on behalf of your organization in the login step, testing the previous query will validate this.
+ - In the **Authentication** tab
+ - Toggle **Default client type** > **Treat application as a public client** to "Yes"
+ - Set **Supported account types** according to your own requirements
+
+1. Run the following command to install the module:
+```powershell
+ Install-Module -Name CosmosDB
+```
-3. Run the following command:
+1. Run the following command:
```powershell
./Deployment/Scripts/enable_findmeetingroom.ps1
```
+
+
### What do these parameters mean?
|Parameter|Description|Required|
@@ -214,6 +224,7 @@ The Calendar skill provides additional support to search and book meeting rooms.
|cosmosDbAccount | The account name of an existing CosmosDb deployment where the meeting room data will be stored, this will then be used as a data source by Azure Search. | Yes |
|primaryKey | The primary key of the CosmosDB deployment | Yes |
|appId | AppId of an authorised Azure AD application which can access Meeting room data | Yes |
+|tenantId | The tenantId corresponding to the application. If you have set "Supported account types" as "Multitenant" and your account has a differet tenant, please use "common"| Yes|
You can access all the required parameters from the [Deployment](#deployment) step.
**Note:** When running the script, you will be asked to sign in with your account which can access the meeting room data in the MSGraph.
@@ -227,4 +238,4 @@ Learn how to use [events]({{site.baseurl}}/virtual-assistant/handbook/events) to
## Download a transcript
{:.toc}
-Download
+Download
\ No newline at end of file
diff --git a/docs/_docs/virtual-assistant/tutorials/customize-assistant/csharp/2-edit-your-greeting.md b/docs/_docs/virtual-assistant/tutorials/customize-assistant/csharp/2-edit-your-greeting.md
index 428ef54402..949828021b 100644
--- a/docs/_docs/virtual-assistant/tutorials/customize-assistant/csharp/2-edit-your-greeting.md
+++ b/docs/_docs/virtual-assistant/tutorials/customize-assistant/csharp/2-edit-your-greeting.md
@@ -13,7 +13,7 @@ order: 2
The assistant's greeting uses an [Adaptive Card](https://adaptivecards.io/), an open framework that lets you describe your content as you see fit and deliver it beautifully wherever your customers are.
-1. Copy and paste the following JSON payload to demonstrate how you can start customizing the look and feel of your Assistant. Note the inline references (`@{NewUserIntroCardTitle()}`) to other LG elements to further adapt the contents at runtime.
+1. Copy and paste the following JSON payload to demonstrate how you can start customizing the look and feel of your Assistant. Note the inline references (`${NewUserIntroCardTitle()}`) to other LG elements to further adapt the contents at runtime.
```json
{
@@ -43,7 +43,7 @@ The assistant's greeting uses an [Adaptive Card](https://adaptivecards.io/), an
"size": "Large",
"weight": "Bolder",
"color": "Light",
- "text": "@{NewUserIntroCardTitle()}",
+ "text": "${NewUserIntroCardTitle()}",
"wrap": true
},
{
@@ -78,7 +78,7 @@ The assistant's greeting uses an [Adaptive Card](https://adaptivecards.io/), an
],
"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
"version": "1.0",
- "speak": "@{NewUserIntroCardTitle()}"
+ "speak": "${NewUserIntroCardTitle()}"
}
```
diff --git a/docs/_docs/virtual-assistant/tutorials/customize-assistant/csharp/3-edit-responses.md b/docs/_docs/virtual-assistant/tutorials/customize-assistant/csharp/3-edit-responses.md
index 0c8f9f12b6..e04946f6b6 100644
--- a/docs/_docs/virtual-assistant/tutorials/customize-assistant/csharp/3-edit-responses.md
+++ b/docs/_docs/virtual-assistant/tutorials/customize-assistant/csharp/3-edit-responses.md
@@ -25,6 +25,7 @@ Within `Startup.cs` in your project root directory add the newly created LG file
var localizedTemplates = new Dictionary>();
var templateFiles = new List() { "MainResponses", "OnboardingResponses" };
var supportedLocales = new List() { "en-us", "de-de", "es-es", "fr-fr", "it-it", "zh-cn" };
+```
## Multiple Responses
@@ -38,12 +39,12 @@ Within MainResponses we provide an example of occasionally using the Users name
# ConfusedMessage
- I'm sorry, I didn’t understand that. Can you give me some more information?
- Sorry, I didn't get that. Can you tell me more?
-- Sorry@{RandomName()}, I didn't get that. Can you tell me more?
+- Sorry ${RandomName()}, I didn't get that. Can you tell me more?
- Apologies, I didn't quite understand. Can you give me more information?
# RandomName
-- IF: @{Name && rand(0, 1000) > 500}
- - @{concat(' ', Name)}
+- IF: ${Name && rand(0, 1000) > 500}
+ - ${concat(' ', Name)}
- ELSE:
-
```
diff --git a/docs/_docs/virtual-assistant/tutorials/customize-assistant/csharp/4-edit-your-cognitive-models.md b/docs/_docs/virtual-assistant/tutorials/customize-assistant/csharp/4-edit-your-cognitive-models.md
index 051a1790e6..78def9900b 100644
--- a/docs/_docs/virtual-assistant/tutorials/customize-assistant/csharp/4-edit-your-cognitive-models.md
+++ b/docs/_docs/virtual-assistant/tutorials/customize-assistant/csharp/4-edit-your-cognitive-models.md
@@ -39,7 +39,7 @@ You may wish to add an additional [QnA Maker](https://www.qnamaker.ai/) knowledg
}
```
- The `kbID`, `hostName` and `endpoint key` can all be found within the **Publish** page on the [QnA Maker portal](https://qnamaker.ai). The subscription key is available from your QnA resource in the Azure Portal.
+ The `kbID`, `hostname` and `endpointKey` can all be found within the **Publish** page on the [QnA Maker portal](https://qnamaker.ai). The subscription key is available from your QnA resource in the Azure Portal.
1. The final step is to update your dispatch model and associated strongly typed class (LuisGen). We have provided the `update_cognitive_models.ps1` script to simplify this for you. The optional `-RemoteToLocal` parameter will generate the matching LU file on disk for your new knowledgebase (if you created using portal). The script will then refresh the dispatcher.
@@ -59,6 +59,6 @@ As you build out your assistant you will likely update the LUIS models and QnA M
Run the following command from within Powershell (pwsh.exe) within your **project directory**.
- ```shell
- ./Deployment/Scripts/update_cognitive_models.ps1 -RemoteToLocal
- ```
+```shell
+ ./Deployment/Scripts/update_cognitive_models.ps1 -RemoteToLocal
+```
\ No newline at end of file
diff --git a/docs/_docs/virtual-assistant/tutorials/customize-assistant/typescript/4-edit-your-cognitive-models.md b/docs/_docs/virtual-assistant/tutorials/customize-assistant/typescript/4-edit-your-cognitive-models.md
index acf5fbc91b..0f63de636e 100644
--- a/docs/_docs/virtual-assistant/tutorials/customize-assistant/typescript/4-edit-your-cognitive-models.md
+++ b/docs/_docs/virtual-assistant/tutorials/customize-assistant/typescript/4-edit-your-cognitive-models.md
@@ -28,14 +28,14 @@ You may wish to add an additional [QnA Maker](https://www.qnamaker.ai/) knowledg
}
```
- The `kbID`, `hostName` and `endpoint key` can all be found within the Publish page on the [QnAMaker portal](https://qnamaker.ai). Subscription Key is available from your QnA resource in the Azure Portal.
+ The `kbID`, `hostname` and `endpointKey` can all be found within the Publish page on the [QnAMaker portal](https://qnamaker.ai). Subscription Key is available from your QnA resource in the Azure Portal.
1. The final step is to update your Dispatcher and associated strongly typed class (LuisGen). We have provided the `update_cognitive_models.ps1` script to simplify this for you. The optional `-RemoteToLocal` parameter will generate the matching LU file on disk for your new knowledgebase (if you created using portal). The script will then refresh the dispatcher.
Run the following command from within Powershell (pwsh.exe) within your **project directory**.
```shell
- .\Deployment\Scripts\update_cognitive_models.ps1 -RemoteToLocal
+ ./Deployment/Scripts/update_cognitive_models.ps1 -RemoteToLocal
```
1. Update the `./src/dialogs/mainDialog.ts` file to include the corresponding Dispatch intent for your new QnA source following the example provided.
@@ -47,5 +47,5 @@ As you build out your assistant you will likely update the LUIS models and QnAMa
Run the following command from within Powershell (pwsh.exe) within your **project directory**.
```shell
-.\Deployment\Scripts\update_cognitive_models.ps1 -RemoteToLocal
+./Deployment/Scripts/update_cognitive_models.ps1 -RemoteToLocal
```
\ No newline at end of file
diff --git a/docs/assets/images/calendar-meeting-room-script.png b/docs/assets/images/calendar-meeting-room-script.png
new file mode 100644
index 0000000000000000000000000000000000000000..ee7a2104c1a836ce6dc60c0841c41a5ef60556de
GIT binary patch
literal 52724
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