Skip to content

Commit ec723b7

Browse files
authored
Merge pull request #112404 from diberry/diberry/0422-luis-limits
[Cogsvcs] LUIS - rename boundary to limit
2 parents fd9b223 + fb3ade4 commit ec723b7

16 files changed

+218
-214
lines changed

.openpublishing.redirection.json

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -727,7 +727,10 @@
727727
"redirect_url": "/azure/cognitive-services/personalizer/how-to-manage-model",
728728
"redirect_document_id": false
729729
},
730-
730+
{
731+
"source_path": "articles/cognitive-services/LUIS/luis-boundaries.md",
732+
"redirect_url": "/azure/cognitive-services/LUIS/luis-limits"
733+
},
731734
{
732735
"source_path": "articles/cognitive-services/LUIS/luis-migration-api-authoring.md",
733736
"redirect_url": "/azure/cognitive-services/LUIS/luis-migration-authoring-entities",

articles/cognitive-services/LUIS/index.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -129,7 +129,7 @@ landingContent:
129129
- text: Developer resources
130130
url: developer-reference-resource.md
131131
- text: App limitations
132-
url: luis-boundaries.md
132+
url: luis-limits.md
133133
- text: Prebuilt entities
134134
url: luis-reference-prebuilt-entities.md
135135
- text: Custom Entities

articles/cognitive-services/LUIS/luis-concept-data-conversion.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -16,11 +16,11 @@ ms.author: diberry
1616
# Convert data format of utterances
1717
LUIS provides the following conversions of a user utterance before prediction"
1818

19-
* Speech to text using [Cognitive Services Speech](../Speech-Service/overview.md) service.
19+
* Speech to text using [Cognitive Services Speech](../Speech-Service/overview.md) service.
2020

2121
## Speech to text
2222

23-
Speech to text is provided as an integration with LUIS.
23+
Speech to text is provided as an integration with LUIS.
2424

2525
### Intent conversion concepts
2626
Conversion of speech to text in LUIS allows you to send spoken utterances to an endpoint and receive a LUIS prediction response. The process is an integration of the [Speech](https://docs.microsoft.com/azure/cognitive-services/Speech) service with LUIS. Learn more about Speech to Intent with a [tutorial](../speech-service/how-to-recognize-intents-from-speech-csharp.md).
@@ -29,10 +29,10 @@ Conversion of speech to text in LUIS allows you to send spoken utterances to an
2929
You do not need to create a **Bing Speech API** key for this integration. A **Language Understanding** key created in the Azure portal works for this integration. Do not use the LUIS starter key.
3030

3131
### Pricing Tier
32-
This integration uses a different [pricing](luis-boundaries.md#key-limits) model than the usual Language Understanding pricing tiers.
32+
This integration uses a different [pricing](luis-limits.md#key-limits) model than the usual Language Understanding pricing tiers.
3333

3434
### Quota usage
35-
See [Key limits](luis-boundaries.md#key-limits) for information.
35+
See [Key limits](luis-limits.md#key-limits) for information.
3636

3737
## Next steps
3838

articles/cognitive-services/LUIS/luis-concept-data-extraction.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ Learn more about the [V3 prediction endpoint](luis-migration-api-v3.md).
2626

2727
* * *
2828

29-
The `appID` is available on the **Settings** page of your LUIS app as well as part of the URL (after `/apps/`) when you're editing that LUIS app. The `subscription-key` is the endpoint key used for querying your app. While you can use your free authoring/starter key while you're learning LUIS, it is important to change the endpoint key to a key that supports your [expected LUIS usage](luis-boundaries.md#key-limits). The `timezoneOffset` unit is minutes.
29+
The `appID` is available on the **Settings** page of your LUIS app as well as part of the URL (after `/apps/`) when you're editing that LUIS app. The `subscription-key` is the endpoint key used for querying your app. While you can use your free authoring/starter key while you're learning LUIS, it is important to change the endpoint key to a key that supports your [expected LUIS usage](luis-limits.md#key-limits). The `timezoneOffset` unit is minutes.
3030

3131
The **HTTPS response** contains all the intent and entity information LUIS can determine based on the current published model of either the staging or production endpoint. The endpoint URL is found on the [LUIS](luis-reference-regions.md) website, in the **Manage** section, on the **Keys and endpoints** page.
3232

articles/cognitive-services/LUIS/luis-concept-intent.md

Lines changed: 24 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -18,81 +18,81 @@ An intent represents a task or action the user wants to perform. It is a purpose
1818

1919
Define a set of intents that corresponds to actions users want to take in your application. For example, a travel app defines several intents:
2020

21-
Travel app intents | Example utterances |
21+
Travel app intents | Example utterances |
2222
------|------|
2323
BookFlight | "Book me a flight to Rio next week" <br/> "Fly me to Rio on the 24th" <br/> "I need a plane ticket next Sunday to Rio de Janeiro" |
2424
Greeting | "Hi" <br/>"Hello" <br/>"Good morning" |
2525
CheckWeather | "What's the weather like in Boston?" <br/> "Show me the forecast for this weekend" |
2626
None | "Get me a cookie recipe"<br>"Did the Lakers win?" |
2727

28-
All applications come with the predefined intent, "[None](#none-intent)", which is the fallback intent.
28+
All applications come with the predefined intent, "[None](#none-intent)", which is the fallback intent.
2929

3030
## Prebuilt domains provide intents
31-
In addition to intents that you define, you can use prebuilt intents from one of the [prebuilt domains](luis-how-to-use-prebuilt-domains.md).
31+
In addition to intents that you define, you can use prebuilt intents from one of the [prebuilt domains](luis-how-to-use-prebuilt-domains.md).
3232

3333
## Return all intents' scores
34-
You assign an utterance to a single intent. When LUIS receives an utterance on the endpoint, by default, it returns the top intent for that utterance.
34+
You assign an utterance to a single intent. When LUIS receives an utterance on the endpoint, by default, it returns the top intent for that utterance.
3535

36-
If you want the scores for all intents for the utterance, you can provide a flag on the query string of the prediction API.
36+
If you want the scores for all intents for the utterance, you can provide a flag on the query string of the prediction API.
3737

3838
|Prediction API version|Flag|
3939
|--|--|
4040
|V2|`verbose=true`|
4141
|V3|`show-all-intents=true`|
4242

4343
## Intent compared to entity
44-
The intent represents action the application should take for the user and is based on the entire utterance. An utterance can have only one top scoring intent but it can have many entities.
44+
The intent represents action the application should take for the user and is based on the entire utterance. An utterance can have only one top scoring intent but it can have many entities.
4545

4646
<a name="how-do-intents-relate-to-entities"></a>
4747

48-
Create an intent when the user's _intention_ would trigger an action in your client application, like a call to the checkweather() function. Then create entities to represent parameters required to execute the action.
48+
Create an intent when the user's _intention_ would trigger an action in your client application, like a call to the checkweather() function. Then create entities to represent parameters required to execute the action.
4949

50-
|Intent | Entity | Example utterance |
50+
|Intent | Entity | Example utterance |
5151
|------------------|------------------------------|------------------------------|
5252
| CheckWeather | { "type": "location", "entity": "seattle" }<br>{ "type": "builtin.datetimeV2.date","entity": "tomorrow","resolution":"2018-05-23" } | What's the weather like in `Seattle` `tomorrow`? |
53-
| CheckWeather | { "type": "date_range", "entity": "this weekend" } | Show me the forecast for `this weekend` |
53+
| CheckWeather | { "type": "date_range", "entity": "this weekend" } | Show me the forecast for `this weekend` |
5454
||||
5555

5656
## Prebuilt domain intents
5757

58-
[Prebuilt domains](luis-how-to-use-prebuilt-domains.md) provide intents with utterances.
58+
[Prebuilt domains](luis-how-to-use-prebuilt-domains.md) provide intents with utterances.
5959

6060
## None intent
6161

6262
The **None** intent is created but left empty on purpose. The **None** intent is a required intent and can't be deleted or renamed. Fill it with utterances that are outside of your domain.
6363

64-
The **None** intent is the fallback intent, important in every app, and should have 10% of the total utterances. It is used to teach LUIS utterances that are not important in the app domain (subject area). If you do not add any utterances for the **None** intent, LUIS forces an utterance that is outside the domain into one of the domain intents. This will skew the prediction scores by teaching LUIS the wrong intent for the utterance.
64+
The **None** intent is the fallback intent, important in every app, and should have 10% of the total utterances. It is used to teach LUIS utterances that are not important in the app domain (subject area). If you do not add any utterances for the **None** intent, LUIS forces an utterance that is outside the domain into one of the domain intents. This will skew the prediction scores by teaching LUIS the wrong intent for the utterance.
6565

66-
When an utterance is predicted as the None intent, the client application can ask more questions or provide a menu to direct the user to valid choices.
66+
When an utterance is predicted as the None intent, the client application can ask more questions or provide a menu to direct the user to valid choices.
6767

68-
## Negative intentions
69-
If you want to determine negative and positive intentions, such as "I **want** a car" and "I **don't** want a car", you can create two intents (one positive, and one negative) and add appropriate utterances for each. Or you can create a single intent and mark the two different positive and negative terms as an entity.
68+
## Negative intentions
69+
If you want to determine negative and positive intentions, such as "I **want** a car" and "I **don't** want a car", you can create two intents (one positive, and one negative) and add appropriate utterances for each. Or you can create a single intent and mark the two different positive and negative terms as an entity.
7070

7171
## Intents and patterns
7272

73-
If you have example utterances, which can be defined in part or whole as a regular expression, consider using the [regular expression entity](luis-concept-entity-types.md#regular-expression-entity) paired with a [pattern](luis-concept-patterns.md).
73+
If you have example utterances, which can be defined in part or whole as a regular expression, consider using the [regular expression entity](luis-concept-entity-types.md#regular-expression-entity) paired with a [pattern](luis-concept-patterns.md).
7474

75-
Using a regular expression entity guarantees the data extraction so that the pattern is matched. The pattern matching guarantees an exact intent is returned.
75+
Using a regular expression entity guarantees the data extraction so that the pattern is matched. The pattern matching guarantees an exact intent is returned.
7676

7777
## Intent balance
78-
The app domain intents should have a balance of utterances across each intent. Do not have one intent with 10 utterances and another intent with 500 utterances. This is not balanced. If you have this situation, review the intent with 500 utterances to see if many of the intents can be reorganized into a [pattern](luis-concept-patterns.md).
78+
The app domain intents should have a balance of utterances across each intent. Do not have one intent with 10 utterances and another intent with 500 utterances. This is not balanced. If you have this situation, review the intent with 500 utterances to see if many of the intents can be reorganized into a [pattern](luis-concept-patterns.md).
7979

8080
The **None** intent is not included in the balance. That intent should contain 10% of the total utterances in the app.
8181

8282
## Intent limits
83-
Review [limits](luis-boundaries.md#model-boundaries) to understand how many intents you can add to a model.
83+
Review [limits](luis-limits.md#model-boundaries) to understand how many intents you can add to a model.
8484

85-
### If you need more than the maximum number of intents
86-
First, consider whether your system is using too many intents.
85+
### If you need more than the maximum number of intents
86+
First, consider whether your system is using too many intents.
8787

88-
### Can multiple intents be combined into single intent with entities
89-
Intents that are too similar can make it more difficult for LUIS to distinguish between them. Intents should be varied enough to capture the main tasks that the user is asking for, but they don't need to capture every path your code takes. For example, BookFlight and FlightCustomerService might be separate intents in a travel app, but BookInternationalFlight and BookDomesticFlight are too similar. If your system needs to distinguish them, use entities or other logic rather than intents.
88+
### Can multiple intents be combined into single intent with entities
89+
Intents that are too similar can make it more difficult for LUIS to distinguish between them. Intents should be varied enough to capture the main tasks that the user is asking for, but they don't need to capture every path your code takes. For example, BookFlight and FlightCustomerService might be separate intents in a travel app, but BookInternationalFlight and BookDomesticFlight are too similar. If your system needs to distinguish them, use entities or other logic rather than intents.
9090

9191
### Dispatcher model
92-
Learn more about combining LUIS and QnA maker apps with the [dispatch model](luis-concept-enterprise.md#when-you-need-to-combine-several-luis-and-qna-maker-apps).
92+
Learn more about combining LUIS and QnA maker apps with the [dispatch model](luis-concept-enterprise.md#when-you-need-to-combine-several-luis-and-qna-maker-apps).
9393

9494
### Request help for apps with significant number of intents
95-
If reducing the number of intents or dividing your intents into multiple apps doesn't work for you, contact support. If your Azure subscription includes support services, contact [Azure technical support](https://azure.microsoft.com/support/options/).
95+
If reducing the number of intents or dividing your intents into multiple apps doesn't work for you, contact support. If your Azure subscription includes support services, contact [Azure technical support](https://azure.microsoft.com/support/options/).
9696

9797
## Next steps
9898

0 commit comments

Comments
 (0)