Skip to content

Commit e6ecbf5

Browse files
ivorbivorb
committed
enrich search with language freshness review
1 parent efcb4e4 commit e6ecbf5

10 files changed

+198
-202
lines changed

‎learn-pr/wwl-data-ai/enrich-search-index-using-language-studio/01-introduction.yml

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,18 @@
1-
### YamlMime:ModuleUnit
2-
uid: learn.wwl.enrich-search-index-using-language-studio.introduction
3-
title: Introduction
4-
metadata:
5-
title: Introduction
6-
description: Introduction
7-
author: wwlpublish
8-
ms.author: berryivor
9-
ms.date: 09/20/2024
10-
ms.topic: unit
11-
ms.collection:
12-
- wwl-ai-copilot
13-
azureSandbox: false
14-
labModal: false
15-
durationInMinutes: 1
16-
content: |
17-
[!include[](includes/01-introduction.md)]
18-
1+
### YamlMime:ModuleUnit
2+
uid: learn.wwl.enrich-search-index-using-language-studio.introduction
3+
title: Introduction
4+
metadata:
5+
title: Introduction
6+
description: Introduction
7+
author: ivorb
8+
ms.author: berryivor
9+
ms.date: 05/02/2025
10+
ms.topic: unit
11+
ms.collection:
12+
- wwl-ai-copilot
13+
azureSandbox: false
14+
labModal: false
15+
durationInMinutes: 1
16+
content: |
17+
[!include[](includes/01-introduction.md)]
18+

‎learn-pr/wwl-data-ai/enrich-search-index-using-language-studio/02-explore-available-features-of-azure-cognitive-service-for-language.yml

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,18 @@
1-
### YamlMime:ModuleUnit
2-
uid: learn.wwl.enrich-search-index-using-language-studio.explore-available-features-of-azure-cognitive-service-for-language
3-
title: Explore the available features of Azure AI Language
4-
metadata:
5-
title: Explore the available features of Azure AI Language
6-
description: Explore the available features of Azure AI Language
7-
author: wwlpublish
8-
ms.author: berryivor
9-
ms.date: 09/20/2024
10-
ms.topic: unit
11-
ms.collection:
12-
- wwl-ai-copilot
13-
azureSandbox: false
14-
labModal: false
15-
durationInMinutes: 6
16-
content: |
17-
[!include[](includes/02-explore-available-features-of-azure-cognitive-service-for-language.md)]
18-
1+
### YamlMime:ModuleUnit
2+
uid: learn.wwl.enrich-search-index-using-language-studio.explore-available-features-of-azure-cognitive-service-for-language
3+
title: Explore the available features of Azure AI Language
4+
metadata:
5+
title: Explore the available features of Azure AI Language
6+
description: Explore the available features of Azure AI Language
7+
author: ivorb
8+
ms.author: berryivor
9+
ms.date: 05/02/2025
10+
ms.topic: unit
11+
ms.collection:
12+
- wwl-ai-copilot
13+
azureSandbox: false
14+
labModal: false
15+
durationInMinutes: 6
16+
content: |
17+
[!include[](includes/02-explore-available-features-of-azure-cognitive-service-for-language.md)]
18+

‎learn-pr/wwl-data-ai/enrich-search-index-using-language-studio/03-enrich-cognitive-search-index-custom-classes.yml

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,18 @@
1-
### YamlMime:ModuleUnit
2-
uid: learn.wwl.enrich-search-index-using-language-studio.enrich-cognitive-search-index-custom-classes
3-
title: Enrich a search index in Azure AI Search with custom classes and Azure AI Language
4-
metadata:
5-
title: Enrich a search index in Azure AI Search with custom classes and Azure AI Language
6-
description: Enrich a search index in Azure AI Search with custom classes and Azure AI Language.
7-
author: wwlpublish
8-
ms.author: berryivor
9-
ms.date: 09/20/2024
10-
ms.topic: unit
11-
ms.collection:
12-
- wwl-ai-copilot
13-
azureSandbox: false
14-
labModal: false
15-
durationInMinutes: 11
16-
content: |
17-
[!include[](includes/03-enrich-cognitive-search-index-custom-classes.md)]
18-
1+
### YamlMime:ModuleUnit
2+
uid: learn.wwl.enrich-search-index-using-language-studio.enrich-cognitive-search-index-custom-classes
3+
title: Enrich a search index in Azure AI Search with custom classes and Azure AI Language
4+
metadata:
5+
title: Enrich a search index in Azure AI Search with custom classes and Azure AI Language
6+
description: Enrich a search index in Azure AI Search with custom classes and Azure AI Language.
7+
author: ivorb
8+
ms.author: berryivor
9+
ms.date: 05/02/2025
10+
ms.topic: unit
11+
ms.collection:
12+
- wwl-ai-copilot
13+
azureSandbox: false
14+
labModal: false
15+
durationInMinutes: 11
16+
content: |
17+
[!include[](includes/03-enrich-cognitive-search-index-custom-classes.md)]
18+

‎learn-pr/wwl-data-ai/enrich-search-index-using-language-studio/04-exercise-enrich-cognitive-custom-classes.yml

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,18 @@
1-
### YamlMime:ModuleUnit
2-
uid: learn.wwl.enrich-search-index-using-language-studio.exercise-enrich-cognitive-custom-classes
3-
title: 'Exercise: Enrich a search index in Azure AI Search with custom classes'
4-
metadata:
5-
title: "Exercise: Enrich a search index in Azure AI Search with custom classes"
6-
description: "Exercise: Enrich a search index in Azure AI Search with custom classes"
7-
author: wwlpublish
8-
ms.author: berryivor
9-
ms.date: 09/20/2024
10-
ms.topic: unit
11-
ms.collection:
12-
- wwl-ai-copilot
13-
azureSandbox: false
14-
labModal: false
15-
durationInMinutes: 30
16-
content: |
17-
[!include[](includes/04-exercise-enrich-cognitive-custom-classes.md)]
18-
1+
### YamlMime:ModuleUnit
2+
uid: learn.wwl.enrich-search-index-using-language-studio.exercise-enrich-cognitive-custom-classes
3+
title: 'Exercise: Enrich a search index in Azure AI Search with custom classes'
4+
metadata:
5+
title: "Exercise: Enrich a search index in Azure AI Search with custom classes"
6+
description: "Exercise: Enrich a search index in Azure AI Search with custom classes"
7+
author: ivorb
8+
ms.author: berryivor
9+
ms.date: 05/02/2025
10+
ms.topic: unit
11+
ms.collection:
12+
- wwl-ai-copilot
13+
azureSandbox: false
14+
labModal: false
15+
durationInMinutes: 30
16+
content: |
17+
[!include[](includes/04-exercise-enrich-cognitive-custom-classes.md)]
18+

‎learn-pr/wwl-data-ai/enrich-search-index-using-language-studio/05-knowledge-check.yml

Lines changed: 51 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -1,51 +1,51 @@
1-
### YamlMime:ModuleUnit
2-
uid: learn.wwl.enrich-search-index-using-language-studio.knowledge-check
3-
title: Module assessment
4-
metadata:
5-
title: Module assessment
6-
description: Knowledge check
7-
author: wwlpublish
8-
ms.author: berryivor
9-
ms.date: 09/20/2024
10-
ms.topic: unit
11-
ms.collection:
12-
- wwl-ai-copilot
13-
azureSandbox: false
14-
labModal: false
15-
durationInMinutes: 3
16-
quiz:
17-
questions:
18-
- content: "Which of the following features of Azure AI Language can you use out of box without needing to train a model?"
19-
choices:
20-
- content: "Conversational language understanding."
21-
isCorrect: false
22-
explanation: "Incorrect. You need to train a model with the intents and entities."
23-
- content: "Analyze sentiment."
24-
isCorrect: true
25-
explanation: "Correct. The analyze sentiment feature has a prebuilt model that you can use without any training."
26-
- content: "Custom text classification."
27-
isCorrect: false
28-
explanation: "Incorrect. You need to train a model with the classes you want to identify."
29-
- content: "Which step enables an AI Search index to store the enrichments from an Azure AI Language project?"
30-
choices:
31-
- content: "Update your Azure AI Search solution."
32-
isCorrect: true
33-
explanation: "Correct. You need to edit the index, indexer, and custom skillset to store the enrichments."
34-
- content: "Create a function app."
35-
isCorrect: false
36-
explanation: "Incorrect. You do need to create a function app to call the trained model, but you don't store the enrichments in the search index."
37-
- content: "Train a custom text classification model."
38-
isCorrect: false
39-
explanation: "Incorrect. You do need to train the classification model, but you don't store the enrichments in the search index."
40-
- content: "Where do you copy the full endpoint of the function app to use in the custom web skill that includes the api-version and path to the actual function name?"
41-
choices:
42-
- content: "You can find the endpoint in the Azure portal."
43-
isCorrect: false
44-
explanation: "Incorrect. You can find the endpoint for the overall function app in the Azure portal, but this wont give you the full URL to call the specific function."
45-
- content: "You can find the endpoint in Language Studio."
46-
isCorrect: false
47-
explanation: "Incorrect. You can find the endpoint for the deployed training model, not your function app."
48-
- content: "You can find the endpoint in the Azure extension inside VS Code."
49-
isCorrect: true
50-
explanation: "Correct. You right click on the function name in the Azure extension and select Copy function URL."
51-
1+
### YamlMime:ModuleUnit
2+
uid: learn.wwl.enrich-search-index-using-language-studio.knowledge-check
3+
title: Module assessment
4+
metadata:
5+
title: Module assessment
6+
description: Knowledge check
7+
author: ivorb
8+
ms.author: berryivor
9+
ms.date: 05/02/2025
10+
ms.topic: unit
11+
ms.collection:
12+
- wwl-ai-copilot
13+
azureSandbox: false
14+
labModal: false
15+
durationInMinutes: 3
16+
quiz:
17+
questions:
18+
- content: "Which of the following features of Azure AI Language can you use out of box without needing to train a model?"
19+
choices:
20+
- content: "Conversational language understanding."
21+
isCorrect: false
22+
explanation: "Incorrect. You need to train a model with the intents and entities."
23+
- content: "Analyze sentiment."
24+
isCorrect: true
25+
explanation: "Correct. The analyze sentiment feature has a prebuilt model that you can use without any training."
26+
- content: "Custom text classification."
27+
isCorrect: false
28+
explanation: "Incorrect. You need to train a model with the classes you want to identify."
29+
- content: "Which step enables an AI Search index to store the enrichments from an Azure AI Language project?"
30+
choices:
31+
- content: "Update your Azure AI Search solution."
32+
isCorrect: true
33+
explanation: "Correct. You need to edit the index, indexer, and custom skillset to store the enrichments."
34+
- content: "Create a function app."
35+
isCorrect: false
36+
explanation: "Incorrect. You do need to create a function app to call the trained model, but you don't store the enrichments in the search index."
37+
- content: "Train a custom text classification model."
38+
isCorrect: false
39+
explanation: "Incorrect. You do need to train the classification model, but you don't store the enrichments in the search index."
40+
- content: "Where do you copy the full endpoint of the function app to use in the custom web skill that includes the api-version and path to the actual function name?"
41+
choices:
42+
- content: "You can find the endpoint in the Azure portal."
43+
isCorrect: false
44+
explanation: "Incorrect. You can find the endpoint for the overall function app in the Azure portal, but this wont give you the full URL to call the specific function."
45+
- content: "You can find the endpoint in Language Studio."
46+
isCorrect: false
47+
explanation: "Incorrect. You can find the endpoint for the deployed training model, not your function app."
48+
- content: "You can find the endpoint in the Azure extension inside VS Code."
49+
isCorrect: true
50+
explanation: "Correct. You right click on the function name in the Azure extension and select Copy function URL."
51+

‎learn-pr/wwl-data-ai/enrich-search-index-using-language-studio/06-summary.yml

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,18 @@
1-
### YamlMime:ModuleUnit
2-
uid: learn.wwl.enrich-search-index-using-language-studio.summary
3-
title: Summary
4-
metadata:
5-
title: Summary
6-
description: Summary
7-
author: wwlpublish
8-
ms.author: berryivor
9-
ms.date: 09/20/2024
10-
ms.topic: unit
11-
ms.collection:
12-
- wwl-ai-copilot
13-
azureSandbox: false
14-
labModal: false
15-
durationInMinutes: 1
16-
content: |
17-
[!include[](includes/06-summary.md)]
18-
1+
### YamlMime:ModuleUnit
2+
uid: learn.wwl.enrich-search-index-using-language-studio.summary
3+
title: Summary
4+
metadata:
5+
title: Summary
6+
description: Summary
7+
author: ivorb
8+
ms.author: berryivor
9+
ms.date: 05/02/2025
10+
ms.topic: unit
11+
ms.collection:
12+
- wwl-ai-copilot
13+
azureSandbox: false
14+
labModal: false
15+
durationInMinutes: 1
16+
content: |
17+
[!include[](includes/06-summary.md)]
18+

‎learn-pr/wwl-data-ai/enrich-search-index-using-language-studio/includes/01-introduction.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,4 @@
1-
Language Studio is included with Azure AI Language. Language Studio lets you use UI tools to explore and build AI models focused in language into your solutions.
2-
3-
These AI models have endpoints that can be used in search solutions to enrich indexes.
1+
Language Studio, included with Azure AI Language, lets you use UI tools to explore and build AI models focused in language into your solutions. These AI models have endpoints that can be used in search solutions to enrich indexes.
42

53
This module builds on [Create a custom skill for Azure AI Search](/training/modules/create-enrichment-pipeline-azure-cognitive-search) but uses a custom text classification model to enrich a search index.
64

‎learn-pr/wwl-data-ai/enrich-search-index-using-language-studio/includes/02-explore-available-features-of-azure-cognitive-service-for-language.md

Lines changed: 9 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -11,40 +11,38 @@ Azure AI Language groups its features into the following areas:
1111
1. Summarize text
1212
1. Translate text
1313

14-
#### Classify text
14+
### Classify text
1515

1616
:::image type="content" source="../media/classify-text-services-small.png" lightbox="../media/classify-text-services.png" alt-text="A screenshot showing the text classification capabilities.":::
1717

18-
#### Understand questions and conversational language
18+
### Understand questions and conversational language
1919

2020
:::image type="content" source="../media/understand-conversational-language-small.png" lightbox="../media/understand-conversational-language.png" alt-text="A screenshot showing question understanding and conversational language capabilities.":::
2121

22-
#### Extract information
22+
### Extract information
2323

2424
:::image type="content" source="../media/extract-information-services-small.png" lightbox="../media/extract-information-services.png" alt-text="A screenshot of the information extraction capabilities":::
2525

26-
#### Summarize text
26+
### Summarize text
2727

2828
:::image type="content" source="../media/text-summarize-small.png" lightbox="../media/text-summarize.png" alt-text="A screenshot of text summarization capabilities.":::
2929

30-
#### Translate text
30+
### Translate text
3131

3232
:::image type="content" source="../media/translate-text-small.png" lightbox="../media/translate-text.png" alt-text="A screenshot showing text translation capabilities.":::
3333

3434
Features can be either preconfigured or customizable. Preconfigured features can be tested straight away with a demo-like environment directly inside Language Studio. You can use them straight out of the box.
3535

3636
The other features with **\*** and green cogs in their logo need user customization. They require you to train their models so they fit your data better. After you have train them, you deploy and can then use them to power your apps or use the same demo-like testing environment.
3737

38-
39-
40-
### Test and use preconfigured language features
38+
## Test and use preconfigured language features
4139

4240
1. Go to the [Language Studio](https://aka.ms/languageStudio) and sign in with your Azure account.
4341
1. If you haven't got a language resource, create one.
4442

4543
:::image type="content" source="../media/select-sentiment-small.png" alt-text="A screenshot showing selecting analyze sentiment." lightbox="../media/select-sentiment.png":::
4644

47-
1. Scroll down to the classify text section, then select **Analyze sentiment and mine options**.
45+
1. Go to the classify text section, then select **Analyze sentiment and mine options**.
4846
1. Scroll down, then select **Service Review (long)**.
4947

5048
:::image type="content" source="../media/analyze-sentiment-demo-environment-small.png" alt-text="A screenshot of the demo-like testing environment." lightbox="../media/analyze-sentiment-demo-environment.png":::
@@ -66,7 +64,7 @@ For example, you can get the same JSON response from the model by using this cur
6664
curl -v -X POST "https://<YOUR_ENDPOINT_HERE>/language/:analyze-text?api-version=2022-05-01" -H "Content-Type: application/json" -H "Ocp-Apim-Subscription-Key: subscription key" --data-ascii "{\"kind\":\"SentimentAnalysis\",\"analysisInput\":{\"documents\":[{\"id\":\"documentId\",\"text\":\"Long waits...BUT FOR GOOD REASON. Some awesome Italian food and great vibes. Contoso Bistro always has live music or events going on to keep you entertained. The food is good enough to keep me entertained though!\n\n The Contoso Bistro lasagna is a classic! The outdoor back patio is such a vibe, especially in the summer. Great service as well :) Love this place and will be back for more.\",\"language\":\"en\"}]},\"parameters\":{\"opinionMining\":true}}"
6765
```
6866

69-
### Create, train, and deploy a conversation language understanding model
67+
## Create, train, and deploy a conversation language understanding model
7068

7169
Each of the customizable features in Azure AI Language needs different steps to create the models. In this example, you'll see how to create a conversation language understanding model.
7270

@@ -96,4 +94,4 @@ Language Studio guides you through the remaining steps. Follow the left navigati
9694

9795
Whichever feature your use you end up with a model that you can use in apps to add language understanding.
9896

99-
In the context of Azure AI Search, these models can help us enrich our search indexes to create better search experiences. Or provide answers when users ask questions.
97+
In the context of Azure AI Search, these models can help us enrich our search indexes to create better search experiences. Or provide answers when users ask questions.

‎learn-pr/wwl-data-ai/enrich-search-index-using-language-studio/includes/06-summary.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
1-
By completing this module, you've learned to:
1+
By completing this module, you learned to:
22

33
- Use Azure AI Language to enrich Azure AI Search indexes.
44
- Enrich an AI Search index with custom classes.
55

66
The flexibility of Azure AI Language and AI Search gives you the power to improve the search experience in your apps.
77

8-
If you'd like to learn more about Language Studio, see the [docs overview](/azure/ai-services/language-service/language-studio).
8+
If you'd like to learn more about Language Studio, see the [docs overview](/azure/ai-services/language-service/language-studio).

0 commit comments

Comments
 (0)