Skip to content

Commit 36572be

Browse files
authored
Merge pull request #112048 from diberry/diberry/luis-0420-fresh-3
[Cogsvcs] LUIS - fresh - quickstart - browser pred
2 parents 3feec5b + 23c5406 commit 36572be

File tree

1 file changed

+13
-20
lines changed

1 file changed

+13
-20
lines changed

articles/cognitive-services/LUIS/luis-get-started-get-intent-from-browser.md

Lines changed: 13 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,8 @@
11
---
22
title: "Quickstart: Get intent with browser - LUIS"
3-
titleSuffix: Azure Cognitive Services
43
description: In this quickstart, use an available public LUIS app to determine a user's intention from conversational text in a browser.
5-
services: cognitive-services
6-
author: diberry
7-
manager: nitinme
8-
ms.custom: seodec18
9-
ms.service: cognitive-services
10-
ms.subservice: language-understanding
114
ms.topic: quickstart
12-
ms.date: 02/03/2020
13-
ms.author: diberry
5+
ms.date: 04/20/2020
146
#Customer intent: As an developer familiar with how to use a browser but new to the LUIS service, I want to query the LUIS endpoint of a published model so that I can see the JSON prediction response.
157
---
168

@@ -22,29 +14,31 @@ To understand what a LUIS prediction endpoint returns, view a prediction result
2214

2315
In order to query a public app, you need:
2416

25-
* Your own Language Understanding (LUIS) Authoring or Prediction key which can be obtained from [LUIS Portal (Preview)](https://preview.luis.ai/). If you do not already have a subscription to create a key, you can register for a [free account](https://azure.microsoft.com/free/).
26-
* The public app's ID: `df67dcdb-c37d-46af-88e1-8b97951ca1c2`.
17+
* Your Language Understanding (LUIS) resource information:
18+
* **Prediction key** - which can be obtained from [LUIS Portal](https://www.luis.ai/). If you do not already have a subscription to create a key, you can register for a [free account](https://azure.microsoft.com/free/).
19+
* **Prediction endpoint subdomain** - the subdomain is also the **name** of your LUIS resource.
20+
* A LUIS app ID - use the public IoT app ID of `df67dcdb-c37d-46af-88e1-8b97951ca1c2`. The user query used in the quickstart code is specific to that app.
2721

2822
## Use the browser to see predictions
2923

3024
1. Open a web browser.
31-
1. Use the complete URLs below, replacing `YOUR-KEY` with your own LUIS Authoring or Prediction key. The requests are GET requests and include the authorization, with your LUIS Authoring or Prediction key, as a query string parameter.
25+
1. Use the complete URLs below, replacing `YOUR-KEY` with your own LUIS Prediction key. The requests are GET requests and include the authorization, with your LUIS Prediction key, as a query string parameter.
3226

3327
#### [V3 prediction request](#tab/V3-1-1)
3428

3529

3630
The format of the V3 URL for a **GET** endpoint (by slots) request is:
3731

3832
`
39-
https://westus.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/df67dcdb-c37d-46af-88e1-8b97951ca1c2/slots/production/predict?query=turn on all lights&subscription-key=YOUR-KEY
33+
https://YOUR-LUIS-ENDPOINT-SUBDOMAIN.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/df67dcdb-c37d-46af-88e1-8b97951ca1c2/slots/production/predict?query=turn on all lights&subscription-key=YOUR-LUIS-PREDICTION-KEY
4034
`
4135

4236
#### [V2 prediction request](#tab/V2-1-2)
4337

4438
The format of the V2 URL for a **GET** endpoint request is:
4539

4640
`
47-
https://westus.api.cognitive.microsoft.com/luis/v2.0/apps/df67dcdb-c37d-46af-88e1-8b97951ca1c2?subscription-key=YOUR-KEY&q=turn on all lights
41+
https://YOUR-LUIS-ENDPOINT-SUBDOMAIN.api.cognitive.microsoft.com/luis/v2.0/apps/df67dcdb-c37d-46af-88e1-8b97951ca1c2?subscription-key=YOUR-LUIS-PREDICTION-KEY&q=turn on all lights
4842
`
4943

5044
1. Paste the URL into a browser window and press Enter. The browser displays a JSON result that indicates that LUIS detects the `HomeAutomation.TurnOn` intent as the top intent and the `HomeAutomation.Operation` entity with the value `on`.
@@ -100,7 +94,7 @@ In order to query a public app, you need:
10094
Add `show-all-intents=true` to the end of the querystring to **show all intents**:
10195

10296
`
103-
https://westus.api.cognitive.microsoft.com/luis/predict/v3.0/apps/df67dcdb-c37d-46af-88e1-8b97951ca1c2/slots/production/predict?query=turn on all lights&subscription-key=YOUR-KEY&show-all-intents=true
97+
https://YOUR-LUIS-ENDPOINT-SUBDOMAIN.api.cognitive.microsoft.com/luis/predict/v3.0/apps/df67dcdb-c37d-46af-88e1-8b97951ca1c2/slots/production/predict?query=turn on all lights&subscription-key=YOUR-LUIS-PREDICTION-KEY&show-all-intents=true
10498
`
10599

106100
```JSON
@@ -133,7 +127,7 @@ In order to query a public app, you need:
133127
Add `verbose=true` to the end of the querystring to **show all intents**:
134128

135129
`
136-
https://westus.api.cognitive.microsoft.com/luis/v2.0/apps/df67dcdb-c37d-46af-88e1-8b97951ca1c2?q=turn on all lights&subscription-key={your-key}&verbose=true
130+
https://YOUR-LUIS-ENDPOINT-SUBDOMAIN.api.cognitive.microsoft.com/luis/v2.0/apps/df67dcdb-c37d-46af-88e1-8b97951ca1c2?q=turn on all lights&subscription-key=YOUR-LUIS-PREDICTION-KEY&verbose=true
137131
`
138132

139133
```json
@@ -169,12 +163,11 @@ In order to query a public app, you need:
169163
}
170164
```
171165

172-
173-
<!-- FIX - is the public app getting updated for the new prebuilt domain with entities? -->
174-
175166
## Next steps
176167

177-
Learn more about the [V3 prediction endpoint](luis-migration-api-v3.md).
168+
Learn more about:
169+
* [V3 prediction endpoint](luis-migration-api-v3.md)
170+
* [Custom subdomains](../cognitive-services-custom-subdomains.md)
178171

179172
> [!div class="nextstepaction"]
180173
> [Create an app in the LUIS portal](get-started-portal-build-app.md)

0 commit comments

Comments
 (0)