Skip to content

Commit a3055f1

Browse files
author
Jill Grant
authored
Merge pull request #281795 from mohitp930/mp7242024-validation
Bulk update: Global effort to fix validation errors
2 parents adb5582 + 0f1f196 commit a3055f1

File tree

105 files changed

+202
-224
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

105 files changed

+202
-224
lines changed

articles/ai-services/LUIS/app-schema-definition.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ When you import and export the app, choose either `.json` or `.lu`.
3535
* Review labels
3636
* Suggest endpoint queries for entities
3737
* Suggest endpoint queries for intents
38-
For more information, see the [LUIS reference documentation](/rest/api/cognitiveservices-luis/authoring/features?view=rest-cognitiveservices-luis-authoring-v3.0-preview&tabs=HTTP&preserve-view=true).
38+
For more information, see the [LUIS reference documentation](/rest/api/luis/operation-groups).
3939
```json
4040
{
4141
"luis_schema_version": "7.0.0",

articles/ai-services/LUIS/concepts/utterances.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,7 @@ If you turn on a normalization setting, scores in the **Test** pane, batch tes
7878

7979
When you clone a version in the LUIS portal, the version settings are kept in the new cloned version.
8080

81-
Set your app's version settings using the LUIS portal by selecting **Manage** from the top navigation menu, in the **Application Settings** page. You can also use the [Update Version Settings API](/rest/api/cognitiveservices-luis/authoring/versions/update?view=rest-cognitiveservices-luis-authoring-v3.0-preview&tabs=HTTP&preserve-view=true). See the [Reference](../luis-reference-application-settings.md) documentation for more information.
81+
Set your app's version settings using the LUIS portal by selecting **Manage** from the top navigation menu, in the **Application Settings** page. You can also use the [Update Version Settings API](/rest/api/luis/settings/update). See the [Reference](../luis-reference-application-settings.md) documentation for more information.
8282

8383
## Word forms
8484

@@ -108,7 +108,7 @@ If you want to ignore specific words or punctuation in patterns, use a [pattern]
108108

109109
## Training with all utterances
110110

111-
Training is nondeterministic: utterance prediction can vary slightly across versions or apps. You can remove nondeterministic training by updating the [version settings](/rest/api/cognitiveservices-luis/authoring/settings/update?view=rest-cognitiveservices-luis-authoring-v3.0-preview&tabs=HTTP&preserve-view=true) API with the UseAllTrainingData name/value pair to use all training data.
111+
Training is nondeterministic: utterance prediction can vary slightly across versions or apps. You can remove nondeterministic training by updating the [version settings](/rest/api/luis/settings/update) API with the UseAllTrainingData name/value pair to use all training data.
112112

113113
## Testing utterances
114114

articles/ai-services/LUIS/developer-reference-resource.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -50,8 +50,8 @@ Both authoring and prediction endpoint APIS are available from REST APIs:
5050

5151
|Type|Version|
5252
|--|--|
53-
|Authoring|[V2](https://go.microsoft.com/fwlink/?linkid=2092087)<br>[preview V3](/rest/api/cognitiveservices-luis/authoring/operation-groups)|
54-
|Prediction|[V2](https://go.microsoft.com/fwlink/?linkid=2092356)<br>[V3](/rest/api/cognitiveservices-luis/runtime/operation-groups?view=rest-cognitiveservices-luis-authoring-v3.0-preview&tabs=HTTP&preserve-view=true)|
53+
|Authoring|[V2](/rest/api/luis/operation-groups?view=rest-luis-v2.0)<br>[preview V3](/rest/api/luis/operation-groups?view=rest-luis-v3.0-preview)|
54+
|Prediction|[V2](/rest/api/luis/operation-groups?view=rest-luis-v2.0)<br>[V3](/rest/api/luis/prediction?view=rest-luis-v3.0)|
5555

5656
### REST Endpoints
5757

articles/ai-services/LUIS/faq.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@ Yes, it is good to train your **None** intent with utterances, especially as y
5959

6060
## How do I edit my LUIS app programmatically?
6161

62-
To edit your LUIS app programmatically, use the [Authoring API](https://go.microsoft.com/fwlink/?linkid=2092087). See [Call LUIS authoring API](get-started-get-model-rest-apis.md) and [Build a LUIS app programmatically using Node.js](luis-tutorial-node-import-utterances-csv.md) for examples of how to call the Authoring API. The Authoring API requires that you use an [authoring key](luis-how-to-azure-subscription.md) rather than an endpoint key. Programmatic authoring allows up to 1,000,000 calls per month and five transactions per second. For more info on the keys you use with LUIS, see [Manage keys](luis-how-to-azure-subscription.md).
62+
To edit your LUIS app programmatically, use the [Authoring API](/rest/api/luis/operation-groups). See [Call LUIS authoring API](get-started-get-model-rest-apis.md) and [Build a LUIS app programmatically using Node.js](luis-tutorial-node-import-utterances-csv.md) for examples of how to call the Authoring API. The Authoring API requires that you use an [authoring key](luis-how-to-azure-subscription.md) rather than an endpoint key. Programmatic authoring allows up to 1,000,000 calls per month and five transactions per second. For more info on the keys you use with LUIS, see [Manage keys](luis-how-to-azure-subscription.md).
6363

6464
## Should variations of an example utterance include punctuation?
6565

@@ -115,7 +115,7 @@ To get the same top intent between all the apps, make sure the intent prediction
115115

116116
When training these apps, make sure to [train with all data](how-to/train-test.md).
117117

118-
Designate a single main app. Any utterances that are suggested for review should be added to the main app, then moved back to all the other apps. This is either a full export of the app, or loading the labeled utterances from the main app to the other apps. Loading can be done from either the [LUIS](./luis-reference-regions.md?view=rest-cognitiveservices-luis-authoring-v3.0-preview&tabs=HTTP&preserve-view=true) website or the authoring API for a [single utterance](/rest/api/cognitiveservices-luis/authoring/examples/add) or for a [batch](/rest/api/cognitiveservices-luis/authoring/examples/batch?view=rest-cognitiveservices-luis-authoring-v3.0-preview&tabs=HTTP&preserve-view=true).
118+
Designate a single main app. Any utterances that are suggested for review should be added to the main app, then moved back to all the other apps. This is either a full export of the app, or loading the labeled utterances from the main app to the other apps. Loading can be done from either the [LUIS](./luis-reference-regions.md?view=rest-cognitiveservices-luis-authoring-v3.0-preview&tabs=HTTP&preserve-view=true) website or the authoring API for a [single utterance](/rest/api/luis/examples/add) or for a [batch](/rest/api/luis/examples/batch?).
119119

120120
Schedule a periodic review, such as every two weeks, of [endpoint utterances](how-to/improve-application.md) for active learning, then retrain and republish the app.
121121

articles/ai-services/LUIS/how-to/sign-in.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -55,8 +55,8 @@ There are a couple of ways to create a LUIS app. You can create a LUIS app in th
5555
* Import a LUIS app from a .lu or .json file that already contains intents, utterances, and entities.
5656

5757
**Using the authoring APIs** You can create a new app with the authoring APIs in a couple of ways:
58-
* [Add application](/rest/api/cognitiveservices-luis/authoring/apps/add?view=rest-cognitiveservices-luis-authoring-v3.0-preview&tabs=HTTP&preserve-view=true) - start with an empty app and create intents, utterances, and entities.
59-
* [Add prebuilt application](/rest/api/cognitiveservices-luis/authoring/apps/add-custom-prebuilt-domain?view=rest-cognitiveservices-luis-authoring-v3.0-preview&tabs=HTTP&preserve-view=true) - start with a prebuilt domain, including intents, utterances, and entities.
58+
* [Add application](/rest/api/luis/apps/add) - start with an empty app and create intents, utterances, and entities.
59+
* [Add prebuilt application](/rest/api/luis/apps/add-custom-prebuilt-domain) - start with a prebuilt domain, including intents, utterances, and entities.
6060

6161
## Create new app in LUIS using portal
6262
1. On **My Apps** page, select your **Subscription** , and **Authoring resource** then select **+ New App**.

articles/ai-services/LUIS/how-to/train-test.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -41,8 +41,8 @@ To train your app in the LUIS portal, you only need to select the **Train** butt
4141

4242
Training with the REST APIs is a two-step process.
4343

44-
1. Send an HTTP POST [request for training](/rest/api/cognitiveservices-luis/authoring/train/train-version?view=rest-cognitiveservices-luis-authoring-v3.0-preview&tabs=HTTP&preserve-view=true).
45-
2. Request the [training status](/rest/api/cognitiveservices-luis/authoring/train/get-status?view=rest-cognitiveservices-luis-authoring-v3.0-preview&tabs=HTTP&preserve-view=true) with an HTTP GET request.
44+
1. Send an HTTP POST [request for training](/rest/api/luis/train/train-version).
45+
2. Request the [training status](/rest/api/luis/train/get-status) with an HTTP GET request.
4646

4747
In order to know when training is complete, you must poll the status until all models are successfully trained.
4848

@@ -87,7 +87,7 @@ Inspect the test result details in the **Inspect** panel.
8787
8888
## Change deterministic training settings using the version settings API
8989

90-
Use the [Version settings API](/rest/api/cognitiveservices-luis/authoring/settings/update?view=rest-cognitiveservices-luis-authoring-v3.0-preview&tabs=HTTP&preserve-view=true) with the UseAllTrainingData set to *true* to turn off deterministic training.
90+
Use the [Version settings API](/rest/api/luis/settings/update) with the UseAllTrainingData set to *true* to turn off deterministic training.
9191

9292
## Change deterministic training settings using the LUIS portal
9393

articles/ai-services/LUIS/includes/app-settings.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ ms.custom: include file
55
ms.date: 01/19/2024
66
---
77

8-
Use [app](/rest/api/cognitiveservices-luis/authoring/settings/update?view=rest-cognitiveservices-luis-authoring-v3.0-preview&tabs=HTTP&preserve-view=true) APIs to update settings or use the LUIS portal's **Manage** section, **Settings** page.
8+
Use [app](/rest/api/luis/settings/update) APIs to update settings or use the LUIS portal's **Manage** section, **Settings** page.
99

1010

1111
|UI setting|API setting|Information|

articles/ai-services/LUIS/includes/app-version-settings.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ ms.custom: include file
44
ms.date: 01/19/2024
55
---
66

7-
Learn [concepts](../concepts/utterances.md#utterance-normalization) of normalization and how to use [version](/rest/api/cognitiveservices-luis/authoring/versions?view=rest-cognitiveservices-luis-authoring-v3.0-preview&preserve-view=true) APIs to update these settings or use the LUIS portal's **Manage** section, **Settings** page.
7+
Learn [concepts](../concepts/utterances.md#utterance-normalization) of normalization and how to use [version](/rest/api/luis/versions) APIs to update these settings or use the LUIS portal's **Manage** section, **Settings** page.
88

99

1010
|UI setting|API setting|Information|

articles/ai-services/LUIS/includes/rest-api.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,11 +9,11 @@ ms.topic: include
99

1010
By following this quickstart, you will perform three REST calls in sequence.
1111

12-
- First, you will upload a batch of example utterances, which will be used to train the Pizza app model, using the [REST Batch add labels](/rest/api/cognitiveservices-luis/authoring/examples/batch?view=rest-cognitiveservices-luis-authoring-v3.0-preview&tabs=HTTP&preserve-view=true) call.
13-
- Next, you will begin a training session for the Pizza app, using the [REST Train application version](/rest/api/cognitiveservices-luis/authoring/train/train-version?view=rest-cognitiveservices-luis-authoring-v3.0-preview&tabs=HTTP&preserve-view=true) call.
14-
- Lastly, you will get the status of the training session for the Pizza app, using the [REST Get version training status](/rest/api/cognitiveservices-luis/authoring/train/get-status?view=rest-cognitiveservices-luis-authoring-v3.0-preview&tabs=HTTP&preserve-view=true) call.
12+
- First, you will upload a batch of example utterances, which will be used to train the Pizza app model, using the [REST Batch add labels](/rest/api/luis/examples/batch) call.
13+
- Next, you will begin a training session for the Pizza app, using the [REST Train application version](/rest/api/luis/train/train-version) call.
14+
- Lastly, you will get the status of the training session for the Pizza app, using the [REST Get version training status](/rest/api/luis/train/get-status) call.
1515

16-
[Reference documentation](/rest/api/cognitiveservices-luis/authoring/operation-groups?view=rest-cognitiveservices-luis-authoring-v3.0-preview&preserve-view=true)
16+
[Reference documentation](/rest/api/luis/operation-groups)
1717

1818
## Prerequisites
1919

@@ -360,7 +360,7 @@ If the entityLabels array is not empty, the `startCharIndex` and `endCharIndex`
360360
361361
## Get intent from the prediction endpoint
362362
363-
Use cURL to query the [prediction endpoint](https://aka.ms/luis-apim-v3-prediction) and get a prediction result.
363+
Use cURL to query the [prediction endpoint](/rest/api/luis/prediction) and get a prediction result.
364364
365365
> [!NOTE]
366366
> This command uses your prediction endpoint.

articles/ai-services/LUIS/luis-concept-data-alteration.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ Use [Bing Spell Check](../../cognitive-services/bing-spell-check/overview.md) to
2929

3030
### Prior to V3 runtime
3131

32-
LUIS uses [Bing Spell Check API V7](../../cognitive-services/bing-spell-check/overview.md) to correct spelling errors in the utterance. LUIS needs the key associated with that service. Create the key, then add the key as a querystring parameter at the [endpoint](https://go.microsoft.com/fwlink/?linkid=2092356).
32+
LUIS uses [Bing Spell Check API V7](../../cognitive-services/bing-spell-check/overview.md) to correct spelling errors in the utterance. LUIS needs the key associated with that service. Create the key, then add the key as a querystring parameter at the [endpoint](/rest/api/luis/operation-groups).
3333

3434
The endpoint requires two params for spelling corrections to work:
3535

@@ -88,7 +88,7 @@ In V3, the `datetimeReference` determines the timezone offset.
8888
The timezone is corrected by adding the user's timezone to the endpoint using the `timezoneOffset` parameter based on the API version. The value of the parameter should be the positive or negative number, in minutes, to alter the time.
8989

9090
#### V2 prediction daylight savings example
91-
If you need the returned prebuilt datetimeV2 to adjust for daylight savings time, you should use the querystring parameter with a +/- value in minutes for the [endpoint](https://go.microsoft.com/fwlink/?linkid=2092356) query.
91+
If you need the returned prebuilt datetimeV2 to adjust for daylight savings time, you should use the querystring parameter with a +/- value in minutes for the [endpoint](/rest/api/luis/operation-groups) query.
9292

9393
Add 60 minutes:
9494

0 commit comments

Comments
 (0)