You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
description: In this article, you create and test a hosted Custom Commands application.
4
+
description: In this article, you'll create and test a hosted Custom Commands Preview application. The application will process utterances.
5
5
services: cognitive-services
6
6
author: don-d-kim
7
7
manager: yetian
@@ -12,134 +12,136 @@ ms.date: 04/30/2020
12
12
ms.author: donkim
13
13
---
14
14
15
-
# Quickstart: Create a Custom Commands app (Preview)
15
+
# Quickstart: Create a Custom Commands Preview app
16
16
17
-
In this quickstart, you will learn how to create and test a Custom Commands application.
18
-
The created application will process utterances like "turn on the tv" and reply with a simple message "Ok, turning on the tv".
17
+
In this quickstart, you'll learn how to create and test a Custom Commands application.
18
+
The application will process utterances like "turn on the tv" and reply with a simple message like "Ok, turning on the tv."
19
19
20
20
## Prerequisites
21
21
22
22
> [!div class="checklist"]
23
23
> * <ahref="https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesSpeechServices"target="_blank">Create an Azure Speech resource <spanclass="docon docon-navigate-external x-hidden-focus"></span></a>
24
24
25
25
> [!NOTE]
26
-
> At this time, Custom Commands only supports speech subscriptions in westus, westus2 and neur regions.
26
+
> At this time, Custom Commands only supports Speech subscriptions in the westus, westus2, and neur regions.
27
27
28
28
## Go to the Speech Studio for Custom Commands
29
29
30
-
1.Open your web browser, and navigate to the [Speech Studio](https://speech.microsoft.com/)
30
+
1.In a web browser, go to [Speech Studio](https://speech.microsoft.com/).
31
31
1. Enter your credentials to sign in to the portal.
32
32
33
-
-The default view is your list of Speech subscriptions.
34
-
> [!NOTE]
35
-
> If you don't see the select subscription page, you can navigate there by choosing "Speech resources" from the settings menu on the top bar.
33
+
The default view is your list of Speech subscriptions.
34
+
> [!NOTE]
35
+
> If you don't see the select subscription page, you can get there by selecting **Speech resources** in the settings menu at the top of the screen.
36
36
37
-
1. Select your Speech subscription, then select **Go to Studio**.
37
+
1. Select your Speech subscription, and then select **Go to Studio**.
38
38
1. Select **Custom Commands**.
39
39
40
-
-The default view is a list of the Custom Commands applications you have under your selected subscription.
40
+
The default view is a list of the Custom Commands applications that you have in the selected subscription.
41
41
42
42
## Create a Custom Commands project
43
43
44
-
1. Select **New project** to create a new project.
44
+
1. Select **New project** to create a project.
45
45
46
46
> [!div class="mx-imgBorder"]
47
47
> 
48
48
49
-
1.Enter the project name.
50
-
1.Select language from the drop-down.
51
-
1.Select an authoring resource from the drop-down. If there are no valid authoring resources, create one by clicking on**Create new LUIS authoring resource**.
49
+
1.In the**Name** box, enter a project name.
50
+
1.In the **Language** list, select a language.
51
+
1.In the **LUIS authoring resource** list, select an authoring resource. If there are no valid authoring resources, create one by selecting**Create new LUIS authoring resource**.
52
52
53
53
> [!div class="mx-imgBorder"]
54
54
> 
55
55
56
-
- Enter the Resource Name, Resource Group.
57
-
- Choose value for Location, and Pricing Tier from the drop-down.
56
+
1. In the **Resource Name** box, enter the name of the resource.
57
+
1. In the **Resource Group** list, select a resource group.
58
+
1. In the **Location** list, select a location.
59
+
1. In the **Pricing Tier** list, select a tier.
58
60
59
61
> [!NOTE]
60
-
> You can create resource groups by entering the desired resource group name into the "Resource Group" field. The resource group will be created when **Create** is selected.
62
+
> You can create a resource group by entering a resource group name in the **Resource Group** box. The resource group will be created when you select **Create**.
61
63
62
-
1.Next, select **Create** to create your project.
63
-
1.Once created, select your project.
64
+
1.Select **Create**.
65
+
1.After the project is created, select it.
64
66
65
-
- Your view should now be an overview of your newly created Custom Commands application.
67
+
You should now see an overview of your new Custom Commands application.
66
68
67
-
## Update LUIS Resources (Optional)
69
+
## Update LUIS resources (optional)
68
70
69
-
You can update the authoring resource that was set in the new project window, and set a prediction resource. Prediction resource is used for recognition once your Custom Commands application is published. You don't need a prediction resource for the development and testing phases.
71
+
You can update the authoring resource that you selected in the **New project** window and set a prediction resource. The prediction resource is used for recognition when your Custom Commands application is published. You don't need a prediction resource during the development and testing phases.
70
72
71
-
1. Select **Settings**from the left pane and then navigate to the **LUIS resources** section in the middle pane.
73
+
1. Select **Settings**in the left pane and then select **LUIS resources** in the middle pane.
72
74
1. Select a prediction resource, or create one by selecting **Create new resource**.
73
75
1. Select **Save**.
74
76
75
77
> [!div class="mx-imgBorder"]
76
-
> 
78
+
> 
77
79
78
80
79
81
> [!NOTE]
80
-
> Since the authoring resource supports only 1,000 prediction endpoint requests per month, you will mandatorily need to set a LUIS prediction resource before publishing your Custom Commands application.
82
+
> Because the authoring resource supports only 1,000 prediction endpoint requests per month, you'll need to set a LUIS prediction resource before you publish your Custom Commands application.
81
83
82
84
83
-
## Create a new Command
85
+
## Create a command
84
86
85
87
Let's create a simple command that will take a single utterance, `turn on the tv`, and respond with the message `Ok, turning on the tv`.
86
88
87
-
1. Create a new Command by selecting the `+ New command` icon present on top of the left most pane. A new pop-up appears titled **New command**.
88
-
1.Provide value for the **Name**field as `TurnOn`.
89
+
1. Create a command by selecting **New command** at the top of the left pane. The **New command** window opens.
90
+
1.In the **Name**box, enter **TurnOn**.
89
91
1. Select **Create**.
90
92
91
-
The middle pane enlists the different properties of a command:
93
+
The middle pane lists the properties of the command:
| Example sentences |Example utterances the user can say to trigger this Command|
97
-
| Parameters | Information required to complete the Command|
98
-
| Completion rules |The actions to be taken to fulfill the Command. For example, to respond to the user or communicate with another web service. |
99
-
| Interaction rules | Additional rules to handle more specific or complex situations |
98
+
|**Example sentences**|Examples of utterances the user can say to trigger the command.|
99
+
|**Parameters**| Information required to complete the command.|
100
+
|**Completion rules**|Actions that will be taken to fulfill the command. For example, responding to the user or communicating with another web service. |
101
+
|**Interaction rules**| Additional rules to handle more specific or complex situations.|
100
102
101
103
102
104
> [!div class="mx-imgBorder"]
103
105
> 
104
106
105
107
106
-
### Add Example sentences
108
+
### Add example sentences
107
109
108
-
Let's start with Example sentences section, and provide an example of what the user can say.
110
+
Let's start with **Example sentences** section. We'll provide an example of what the user can say.
109
111
110
-
1. Select **Example sentences** section from the middle pane and in the right most pane, add examples:
112
+
1. Select **Example sentences** in the middle pane.
113
+
1. In the right pane, add examples:
111
114
112
115
```
113
116
turn on the tv
114
117
```
115
118
116
-
1. Select `Save` icon present on top of this pane.
119
+
1. Select **Save** at the top of the pane.
117
120
118
-
For now, we have no parameters so we can move on to **Completion rules** section.
121
+
For now, we don't have parameters, so we can move to the **Completion rules** section.
119
122
120
-
### Add a Completion rule
123
+
### Add a completion rule
121
124
122
-
Now add a Completion rule with the following configuration. This rule indicates user that a fulfillment action is being taken.
125
+
Now add a completion rule that has the following configuration. This rule tells the user that a fulfillment action is being taken.
0 commit comments