Skip to content

Commit 76292e8

Browse files
authored
Merge pull request #279768 from jboback/UUF-June
UUF June
2 parents 2e2db35 + 1c237bd commit 76292e8

File tree

3 files changed

+22
-22
lines changed

3 files changed

+22
-22
lines changed

articles/ai-services/language-service/conversational-language-understanding/glossary.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ A model is an object that's trained to do a certain task, in this case conversat
3838

3939
## Overfitting
4040

41-
Overfitting happens when the model is fixated on the specific examples and is not able to generalize well.
41+
Overfitting happens when the model is fixated on the specific examples and isn't able to generalize well.
4242

4343
## Precision
4444
Measures how precise/accurate your model is. It's the ratio between the correctly identified positives (true positives) and all identified positives. The precision metric reveals how many of the predicted classes are correctly labeled.
@@ -53,14 +53,14 @@ Measures the model's ability to predict actual positive classes. It's the ratio
5353
A regular expression entity represents a regular expression. Regular expression entities are exact matches.
5454

5555
## Schema
56-
Schema is defined as the combination of intents and entities within your project. Schema design is a crucial part of your project's success. When creating a schema, you want think about which intents and entities should be included in your project
56+
Schema is defined as the combination of intents and entities within your project. Schema design is a crucial part of your project's success. When creating a schema, you want to think about which intents and entities should be included in your project.
5757

5858
## Training data
5959
Training data is the set of information that is needed to train a model.
6060

6161
## Utterance
6262

63-
An utterance is user input that is short text representative of a sentence in a conversation. It is a natural language phrase such as "book 2 tickets to Seattle next Tuesday". Example utterances are added to train the model and the model predicts on new utterance at runtime
63+
An utterance is user input that is short text representative of a sentence in a conversation. It's a natural language phrase such as "book 2 tickets to Seattle next Tuesday". Example utterances are added to train the model and the model predicts on new utterance at runtime
6464

6565

6666
## Next steps

articles/ai-services/language-service/question-answering/how-to/migrate-qnamaker-to-question-answering.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.topic: how-to
99
ms.date: 12/19/2023
1010
ms.custom: language-service-question-answering
1111
---
12-
# Migrate from QnA Maker to custom question qnswering
12+
# Migrate from QnA Maker to custom question answering
1313

1414
**Purpose of this document:** This article aims to provide information that can be used to successfully migrate applications that use QnA Maker to custom question answering. Using this article, we hope customers will gain clarity on the following:
1515

@@ -28,7 +28,7 @@ ms.custom: language-service-question-answering
2828
> - Automatic RBAC to Language project (not resource)
2929
> - Automatic enabling of analytics.
3030
31-
You will also need to [re-enable analytics](analytics.md) for the language resource.
31+
You'll also need to [re-enable analytics](analytics.md) for the language resource.
3232

3333
## Comparison of features
3434

@@ -42,7 +42,7 @@ In addition to a new set of features, custom question answering provides many te
4242
|Smart URL Refresh||✔️|Custom question answering provides a means to refresh ingested content from public sources with a single click.|
4343
|Q&A over knowledge base (hierarchical extraction)|✔️|✔️| |
4444
|Active learning|✔️|✔️|Custom question answering has an improved active learning model.|
45-
|Alternate Questions|✔️|✔️|The improved models in custom question answering reduces the need to add alternate questions.|
45+
|Alternate Questions|✔️|✔️|The improved models in custom question answering reduce the need to add alternate questions.|
4646
|Synonyms|✔️|✔️| |
4747
|Metadata|✔️|✔️| |
4848
|Question Generation (private preview)||✔️|This new feature will allow generation of questions over text.|
@@ -54,7 +54,7 @@ In addition to a new set of features, custom question answering provides many te
5454

5555
## Pricing
5656

57-
When you are looking at migrating to custom question answering, please consider the following:
57+
When you're looking at migrating to custom question answering, please consider the following:
5858

5959
|Component |QnA Maker|Custom question answering|Details |
6060
|-------------------------------|---------|------------------|---------------------------------------------------------------------------------------------------------|
@@ -65,7 +65,7 @@ When you are looking at migrating to custom question answering, please consider
6565

6666
- Users may select a higher tier with higher capacity, which will impact overall price they pay. It doesn’t impact the price on language component of custom question answering.
6767

68-
- “Text Records” in custom question answering features refers to the query submitted by the user to the runtime, and it is a concept common to all features within Language service. Sometimes a query may have more text records when the query length is higher.
68+
- “Text Records” in custom question answering features refers to the query submitted by the user to the runtime, and it's a concept common to all features within Language service. Sometimes a query may have more text records when the query length is higher.
6969

7070
**Example price estimations**
7171

@@ -76,7 +76,7 @@ When you are looking at migrating to custom question answering, please consider
7676
|Medium|10 |10(S1) |800K |4x3(S1) |Less expensive |
7777
|Low |4 |4(B1) |100K |3x3(S1) |Less expensive |
7878

79-
Summary : Customers should save cost across the most common configurations as seen in the relative cost column.
79+
Summary: Customers should save cost across the most common configurations as seen in the relative cost column.
8080

8181
Here you can find the pricing details for [custom question answering](https://azure.microsoft.com/pricing/details/cognitive-services/language-service/) and [QnA Maker](https://azure.microsoft.com/pricing/details/cognitive-services/qna-maker/).
8282

@@ -101,7 +101,7 @@ Following are the broad migration phases to consider:
101101

102102
![A chart showing the phases of a successful migration](../media/migrate-qnamaker-to-question-answering/migration-phases.png)
103103

104-
Additional links which can help you are given below:
104+
Additional links which can help you're given below:
105105
- [Authoring portal](https://language.cognitive.azure.com/home)
106106
- [API](authoring.md)
107107
- [SDK](/dotnet/api/microsoft.azure.cognitiveservices.knowledge.qnamaker)
@@ -115,7 +115,7 @@ This topic compares two hypothetical scenarios when migrating from QnA Maker to
115115
> An attempt has been made to ensure these scenarios are representative of real customer migrations, however, individual customer scenarios will of course differ. Also, this article doesn't include pricing details. Visit the [pricing](https://azure.microsoft.com/pricing/details/cognitive-services/language-service/) page for more information.
116116
117117
> [!IMPORTANT]
118-
> Each custom question answering project is equivalent to a knowledge base in QnA Maker. Resource level settings such as Role-based access control (RBAC) are not migrated to the new resource. These resource level settings would have to be reconfigured for the language resource post migration. You will also need to [re-enable analytics](analytics.md) for the language resource.
118+
> Each custom question answering project is equivalent to a knowledge base in QnA Maker. Resource level settings such as Role-based access control (RBAC) are not migrated to the new resource. These resource level settings would have to be reconfigured for the language resource post migration. You'll also need to [re-enable analytics](analytics.md) for the language resource.
119119
120120
### Migration scenario 1: No custom authoring portal
121121

articles/ai-services/language-service/question-answering/how-to/migrate-qnamaker.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.date: 12/19/2023
99
ms.custom: language-service-question-answering
1010
---
1111

12-
# Migrate from QnA Maker to custom question answering
12+
# Migrate from QnA Maker knowledge bases to custom question answering
1313

1414
> [!NOTE]
1515
> You can also migrate to [Azure OpenAI](../../../qnamaker/How-To/migrate-to-openai.md).
@@ -32,7 +32,7 @@ This [SDK Migration Guide](https://github.com/Azure/azure-sdk-for-net/blob/Azure
3232

3333
You can follow the steps below to migrate knowledge bases:
3434

35-
1. Create a [language resource](https://aka.ms/create-language-resource) with custom question answering enabled in advance. When you create the language resource in the Azure portal, you will see the option to enable custom question answering. When you select that option and proceed, you will be asked for Azure Search details to save the knowledge bases.
35+
1. Create a [language resource](https://aka.ms/create-language-resource) with custom question answering enabled in advance. When you create the language resource in the Azure portal, you'll see the option to enable custom question answering. When you select that option and proceed, you'll be asked for Azure Search details to save the knowledge bases.
3636

3737
2. If you want to add knowledge bases in multiple languages to your language resource, visit [Language Studio](https://language.azure.com/) to create your first custom question answering project and select the first option as shown below. Language settings for the language resource can be specified only when creating a project. If you want to migrate existing knowledge bases in a single language to the language resource, you can skip this step.
3838

@@ -53,12 +53,12 @@ You can follow the steps below to migrate knowledge bases:
5353
> [!div class="mx-imgBorder"]
5454
> ![Migrate QnAMaker with red selection box around the QnAMaker resource selection option](../media/migrate-qnamaker/select-resource.png)
5555
56-
6. Select the language resource to which you want to migrate the knowledge bases. You will only be able to see those language resources that have custom question answering enabled. The language setting for the language resource is displayed in the options. You won’t be able to migrate knowledge bases in multiple languages from QnA Maker resources to a language resource if its language setting is not specified.
56+
6. Select the language resource to which you want to migrate the knowledge bases. You'll only be able to see those language resources that have custom question answering enabled. The language setting for the language resource is displayed in the options. You won’t be able to migrate knowledge bases in multiple languages from QnA Maker resources to a language resource if its language setting isn't specified.
5757

5858
> [!div class="mx-imgBorder"]
5959
> ![Migrate QnAMaker with red selection box around the language resource option currently selected resource contains the information that language is unspecified](../media/migrate-qnamaker/language-setting.png)
6060
61-
If you want to migrate knowledge bases in multiple languages to the language resource, you must enable the multiple language setting when creating the first custom question answering project for the language resource. You can do so by following the instructions in step #2. **If the language setting for the language resource is not specified, it is assigned the language of the selected QnA Maker resource**.
61+
If you want to migrate knowledge bases in multiple languages to the language resource, you must enable the multiple language setting when creating the first custom question answering project for the language resource. You can do so by following the instructions in step #2. **If the language setting for the language resource isn't specified, it is assigned the language of the selected QnA Maker resource**.
6262

6363
7. Select all the knowledge bases that you wish to migrate > select **Next**.
6464

@@ -71,26 +71,26 @@ You can follow the steps below to migrate knowledge bases:
7171
> If you migrate a knowledge base with the same name as a project that already exists in the target language resource, **the content of the project will be overridden** by the content of the selected knowledge base.
7272
7373
> [!div class="mx-imgBorder"]
74-
> ![Screenshot of an error message starting project names can't contain special characters](../media/migrate-qnamaker/migration-kb-name-validation.png)
74+
> ![Screenshot of an error message starting project names can't contain special characters.](../media/migrate-qnamaker/migration-kb-name-validation.png)
7575
7676
9. After resolving the validation errors, select **Start migration**
7777

7878
> [!div class="mx-imgBorder"]
79-
> ![Screenshot with special characters removed](../media/migrate-qnamaker/migration-kb-name-validation-success.png)
79+
> ![Screenshot with special characters removed.](../media/migrate-qnamaker/migration-kb-name-validation-success.png)
8080
81-
10. It will take a few minutes for the migration to occur. Do not cancel the migration while it is in progress. You can navigate to the migrated projects within the [Language Studio](https://language.azure.com/) post migration.
81+
10. It will take a few minutes for the migration to occur. Don't cancel the migration while it is in progress. You can navigate to the migrated projects within the [Language Studio](https://language.azure.com/) post migration.
8282

8383
> [!div class="mx-imgBorder"]
84-
> ![Screenshot of successfully migrated knowledge bases with information that you can publish by using Language Studio](../media/migrate-qnamaker/migration-success.png)
84+
> ![Screenshot of successfully migrated knowledge bases with information that you can publish by using Language Studio.](../media/migrate-qnamaker/migration-success.png)
8585
8686
If any knowledge bases fail to migrate to custom question answering projects, an error will be displayed. The most common migration errors occur when:
8787

8888
- Your source and target resources are invalid.
89-
- You are trying to migrate an empty knowledge base (KB).
90-
- You have reached the limit for an Azure Search instance linked to your target resources.
89+
- You're trying to migrate an empty knowledge base (KB).
90+
- You've reached the limit for an Azure Search instance linked to your target resources.
9191

9292
> [!div class="mx-imgBorder"]
93-
> ![Screenshot of a failed migration with an example error](../media/migrate-qnamaker/migration-errors.png)
93+
> ![Screenshot of a failed migration with an example error.](../media/migrate-qnamaker/migration-errors.png)
9494
9595
Once you resolve these errors, you can rerun the migration.
9696

0 commit comments

Comments
 (0)