Skip to content

Commit c2b4225

Browse files
committed
add int view
1 parent 5a44fce commit c2b4225

19 files changed

+107
-15
lines changed

articles/ai-services/language-service/conversational-language-understanding/how-to/create-project.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ A Conversational Language Understanding (CLU) fine-tuning task is a workspace pr
6767

6868
1. From **Create service fine-tuning** window, choose the **Conversational language understanding** tab then select **Next**.
6969

70-
:::image type="content" source="../media/select-project.png" alt-text="Screenshot of conversational language understanding tab in the Azure AI Foundry.":::
70+
:::image type="content" source="../media/select-project.png" alt-text="Screenshot of conversational language understanding selection card in the Azure AI Foundry.":::
7171

7272
1. In **Create CLU fine tuning task** window, select your **Connected service** from the drop-down menu, then complete the **Name** and **Language** fields. If you're using the free **Standard Training** mode, select **English** for the language field.
7373

@@ -80,7 +80,7 @@ A Conversational Language Understanding (CLU) fine-tuning task is a workspace pr
8080
> * **Advanced training** includes longer training durations and is supported for English, other languages, and multilingual projects.
8181
> * For more information, *see* [Training modes](train-model.md#training-modes).
8282
83-
1. Once the task creation is complete, select the task from the AI Service fine-tuning window to arrive at the Getting started with fine-tuning page.
83+
1. Once the task creation is complete, select the task from the AI Service fine-tuning window to arrive at the **Getting started with fine-tuning** page.
8484

8585
:::image type="content" source="../media/create-project/getting-started-fine-tuning.png" alt-text="Screenshot of the getting started with fine-tuning page in the Azure AI Foundry." lightbox="../media/create-project/getting-started-fine-tuning.png":::
8686

articles/ai-services/language-service/conversational-language-understanding/how-to/train-model.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -54,9 +54,10 @@ We recommend that you introduce casing and punctuation diversity in the training
5454

5555
## Data splitting
5656

57-
Before you start the training process, labeled utterances in your project are divided into a training set and a testing set. Each one of them serves a different function.
58-
The **training set** is used in training the model, the set from which the model learns the labeled utterances.
59-
The **testing set** is a blind set that isn't introduced to the model during training but only during evaluation.
57+
Before you start the training process, labeled utterances in your project are divided into a training set and a testing set. Each one of them serves a different function:
58+
59+
* The **training set** is used in training the model, the set from which the model learns the labeled utterances.
60+
* The **testing set** is a blind set that isn't introduced to the model during training but only during evaluation.
6061

6162
After the model is trained successfully, the model can be used to make predictions from the utterances in the testing set. These predictions are used to calculate [evaluation metrics](../concepts/evaluation-metrics.md).
6263
We recommend that you make sure that all your intents and entities are adequately represented in both the training and testing set.

articles/ai-services/language-service/conversational-language-understanding/includes/quickstarts/azure-ai-foundry.md

Lines changed: 94 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -20,21 +20,110 @@ ms.author: lajanuar
2020
* An [Azure AI Foundry multi-service resource](/azure/ai-services/multi-service-resource). For more information, *see* [Configure an Azure AI Foundry resource](../../how-to/configure-azure-resources.md).md#option-1-configure-an-azure-ai-foundry-resource). Alternately, you can use an [Azure AI Language resource](https://portal.azure.com/?Microsoft_Azure_PIMCommon=true#create/Microsoft.CognitiveServicesTextAnalytics).
2121
* A Foundry project created in the Azure AI Foundry. For more information, *see* [Create an AI Foundry project](/azure/ai-foundry/how-to/create-projects).
2222

23-
## Azure Foundry language playground
23+
## Get started with Azure AI Foundry
2424

25-
Azure AI Foundry offers a unified platform for building, managing, and deploying AI solutions with a wide array of models and tools. Azure AI Foundry playgrounds are interactive environments within the Azure AI Foundry portal designed for exploring, testing, and prototyping with various AI models and tools.
25+
To complete this quickstart, you need a CLU fine-tuning task project that includes a [defined schema](../../how-to/build-schema.md) and [labeled utterances](../../how-to/tag-utterances.md). You can download our [**sample project file**](https://github.com/Azure-Samples/cognitive-services-sample-data-files/blob/master/language-service/CLU/EmailAppDemo.json), which comes preconfigured with both a schema and labeled utterances. This project, enables the prediction of user intent for commands such as reading emails, deleting emails, and attaching documents to emails.
26+
27+
Azure AI Foundry offers a unified platform for building, managing, and deploying AI solutions with a wide array of models and tools. Azure AI Foundry playgrounds are interactive environments within the Azure AI Foundry portal designed for exploring, testing, and prototyping with various AI models and tools. Let's begin:
2628

2729
1. Navigate to the [Azure AI Foundry](https://ai.azure.com/).
2830
1. If you aren't already signed in, the portal prompts you to do so with your Azure credentials.
2931
1. Once signed in, you can create or access your existing projects within Azure AI Foundry.
3032
1. If you're not already at your project for this task, select it.
3133
1. On the left side navigation pane, select **Playgrounds**, navigate to the **Language playground card**, and then choose the **Try the Language playground** button.
3234

33-
:::image type="content" source="../../media/quickstarts/playground.png" alt-text="Screenshot of the playgrounds selection in Azure AI Foundry.":::
35+
:::image type="content" source="../../media/quickstarts/try-playground.png" alt-text="Screenshot of the try language playground selection in Azure AI Foundry.":::
36+
37+
## Try Foundry Language playground
38+
39+
The top section of the Language playground is where you can view and select the available Language services.
40+
41+
1. Select the **Conversational language understanding Fine-tuning** card.
42+
43+
:::image type="content" source="../../media/quickstarts/language-playground.png" alt-text="Screenshot of the language playground homepage in Azure AI Foundry.":::
44+
45+
1. Next scroll to and select the **Fine-tune** button.
46+
47+
:::image type="content" source="../../quickstarts/fine-tune-button.png" alt-text="Screenshot of the fine-tune button on the language playground homepage in Azure AI Foundry.":::
48+
49+
1. From **Create service fine-tuning** window that opens, choose the **Conversational language understanding** card, then select **Next**.
50+
51+
:::image type="content" source="../../media/select-project.png" alt-text="Screenshot of conversational language understanding selection card in the Azure AI Foundry.":::
52+
53+
1. In **Create CLU fine tuning task** window, select **Import an existing project**, then select your **Connected service** from the drop-down menu and complete the **Name** field.
54+
55+
:::image type="content" source="../../media/quickstarts/select-import-existing-project.png" alt-text="Screenshot of the import an existing project selection in Azure AI Foundry.":::
56+
57+
1. Next, add the [sample project file](https://github.com/Azure-Samples/cognitive-services-sample-data-files/blob/master/language-service/CLU/EmailAppDemo.json) that you downloaded earlier to the upload area.
58+
59+
1. Select the **Create** button. It can take a few minutes for the *creating* operation to complete.
60+
61+
1. Once your fine-tuning task project has been created, the **Getting started with fine-tuning** page opens.
62+
63+
:::image type="content" source="../../media/create-project/getting-started-fine-tuning.png" alt-text="Screenshot of the getting started with fine-tuning page in the Azure AI Foundry." lightbox="../media/create-project/getting-started-fine-tuning.png":::
64+
65+
## Train your model
66+
67+
After project creation, the next steps are schema construction and utterance labeling. However, for this quickstart, since we already preconfigured these steps—simply initiate a training job by selecting **Train model** from the **Getting Started** menu to generate your model.
68+
69+
:::image type="content" source="../../media/quickstarts/getting-started-menu.png" alt-text="Screenshot of the getting started with fine-tuning menu in the Azure AI Foundry.":::
70+
71+
1. Select the **➕ Train model button** from the **Train you model** window.
72+
73+
:::image type="content" source="../../media/quickstarts/train-your-model-button.png" alt-text="Screenshot of the train your model button in the Azure AI Foundry.":::
74+
75+
1. Complete **Select a mode** form but completing the **Model name** field and selecting a **Training mode**. For this quickstart, select the free **Standard training** mode.
76+
For more information, *see* [Training modes](train-model.md#training-modes).
77+
78+
1. Choose a **training version** from the drop-down menu, then select the **Next** button.
79+
80+
1. Check your selections in the **Review** window and select the **Create** button
81+
82+
:::image type="content" source="../../media/quickstarts/review-selections.png" alt-text="Screenshot of the review selections window in the Azure AI Foundry.":::
83+
84+
## Deploy model
85+
86+
Typically, after training a model, you review its evaluation details. In this quickstart, however, you can simply deploy your model and make it available to test in the Language playground, or by calling the [prediction API](https://aka.ms/clu-apis). However, if you wish, you can take a moment to select **Evaluate your model** from the left-side menu and explore the in-depth telemetry for your model.
87+
88+
1. To deploy your model within Azure AI Foundry, select **Deploy model** from the left-side menu.
89+
1. Next, select **➕ Deploy a trained model** from the **Deploy your model** window.
90+
91+
:::image type="content" source="../../media/quickstarts/deploy-trained-model.png" alt-text="Screenshot of the deploy your model window in Azure AI Foundry.":::
92+
93+
1. Make sure the **Create a new deployment** button is selected.
94+
95+
1. Complete the **Deploy a trained model** window:
96+
* Create a deployment name.
97+
* Select your trained model from the **Assign a model** drop-down menu.
98+
* Select a subscription from the **Subscription** drop-down menu.
99+
* Select a region from the **Region** drop-down menu.
100+
* Select a resource from the **Resource** drop-down menu. The resource must be in the same deployment region.
101+
102+
103+
:::image type="content" source="../../media/quickstarts/deploy-model-configuration.png" alt-text="Screenshot of the deploy your model configuration in Azure AI Foundry.":::
104+
105+
1. Select the **Create** button. It may take a few minutes for your model to deploy.
106+
1. After successful deployment, you can view the deployment status on the **Deploy your model** page. The expiration date that appears marks the date when your deployed model becomes unavailable to be used for prediction. This date is 18 months after a training configuration is deployed.
107+
108+
:::image type="content" source="../../media/quickstarts/deployed-model-succeeded.png" alt-text="Screenshot of your successfully deployed model status page in Azure AI Foundry.":::
109+
1. From the far-left menu navigate to the Language playground. **Playgrounds****Language playground (Try the Language playground)**.
110+
1. Select the **Conversational language understanding** card.
111+
1. A Configuration window with your deployed model should be in the main/center window.
112+
1. In the text box, enter an utterance to test. For example, if you used our [sample project](https://github.com/Azure-Samples/cognitive-services-sample-data-files/blob/master/language-service/CLU/EmailAppDemo.json) application for email-related utterances you could enter **Check email**.
113+
1. After you enter your test text, select the **Run** button.
114+
115+
:::image type="content" source="../../media/quickstarts/deployed-model-succeeded.png" alt-text="Screenshot of your successfully deployed model status page in Azure AI Foundry.":::
116+
1. After you run the test, you should see the response of the model in the result.
117+
118+
:::image type="content" source="../../media/quickstarts/language-playground-test.png" alt-text="Screenshot of deployed model testing in Azure AI Foundry language playground.
119+
120+
1. You can view the results in a text or JSON format view.
121+
122+
:::image type="content" source="../../media/quickstarts/language-playground-test-results.png" alt-text="Screenshot of deployed model test results in Azure AI Foundry language playground.
34123

35-
## Try CLU in the Foundry playground
124+
That's it, congratulations!
36125

37-
The top section of the Language playground is where you can view and select the available Language services. For CLU you can select **Fine-tune models**. For more information, *see* [Create a fine-tuning task project ](../../how-to/create-project.md).
126+
In this quickstart, you deployed a CLU model and tested it in the Azure AI Foundry Language playground. Next, learn how to [Create your own fine-tuning task project ](../../how-to/create-project.md) for your applcations and workflows.
38127

39128
## Clean up resources
40129

125 KB
Loading
46.2 KB
Loading
48.4 KB
Loading
35.3 KB
Loading
31.8 KB
Loading
Loading
162 KB
Loading

0 commit comments

Comments
 (0)