basic pivot framework to add custom speech in foundry portal

Author: eric-urban

articles/ai-services/speech-service/how-to-custom-speech-create-project.md

@@ -50,74 +50,6 @@ In Azure AI Foundry, you can fine-tune some Azure AI services models. For exampl
     - **Speech Service**: An Azure AI Speech resource that was [connected after the project was created](../../ai-studio/ai-services/how-to/connect-ai-services.md#connect-azure-ai-services-after-you-create-a-project). 
 
 1. Enter a name and description for the fine-tuning job. Then select **Next**.
-1. From the new left menu in the fine-tuning page, select **Manage data** and then select **Add data**.
-
-    :::image type="content" source="./media/ai-studio/custom-speech/new-fine-tune-add-data.png" alt-text="Screenshot of the page with an option to add data to the custom speech project." lightbox="./media/ai-studio/custom-speech/new-fine-tune-add-data.png":::
-
-1. In the **Add data** wizard, select the type of training data you want to add. In this example, we select **Audio + human-labeled transcript**. Then select **Next**.
-
-    :::image type="content" source="./media/ai-studio/custom-speech/new-fine-tune-add-data-select-type.png" alt-text="Screenshot of the page with an option to select the type of training data you want to add." lightbox="./media/ai-studio/custom-speech/new-fine-tune-add-data-select-type.png":::
-
-1. On the **Upload your data** page, select local files, Azure Blob Storage, or other shared web locations. Then select **Next**.
-1. Enter a name and description for the data. Then select **Next**.
-1. Review the data and select **Upload**. You're taken back to the **Manage data** page. The status of the data is **Processing**.
-
-    :::image type="content" source="./media/ai-studio/custom-speech/new-fine-tune-add-data-status-processing.png" alt-text="Screenshot of the page that shows the status of the data as processing." lightbox="./media/ai-studio/custom-speech/new-fine-tune-add-data-status-processing.png":::
-
-## Train a custom model from your data
-
-1. After the data is processed, select **Train model** from the left menu. Then select **+ Train model**.
-
-    :::image type="content" source="./media/ai-studio/custom-speech/new-fine-tune-train-model.png" alt-text="Screenshot of the page with an option to start training for a custom speech model." lightbox="./media/ai-studio/custom-speech/new-fine-tune-train-model.png":::
-
-1. In the **Train a new model** wizard, select the base model that you want to fine-tune. Then select **Next**.
-
-    :::image type="content" source="./media/ai-studio/custom-speech/new-fine-tune-train-model-select-base.png" alt-text="Screenshot of the page with an option to select the base model that you want to fine-tune." lightbox="./media/ai-studio/custom-speech/new-fine-tune-train-model-select-base.png":::
-
-1. Select the data that you want to use for training. Then select **Next**.
-1. Enter a name and description for the model. Then select **Next**.
-1. Review the settings and select **Train a new model**. You're taken back to the **Train model** page. The status of the data is **Processing**.
-
-    :::image type="content" source="./media/ai-studio/custom-speech/new-fine-tune-train-model-status-processing.png" alt-text="Screenshot of the page that shows the status of the training as processing." lightbox="./media/ai-studio/custom-speech/new-fine-tune-train-model-status-processing.png":::
-
-## Test the custom model
-
-1. After the model is trained, select **Test models** from the left menu. Then select **+ Create test**.
-
-    :::image type="content" source="./media/ai-studio/custom-speech/new-fine-tune-test-model.png" alt-text="Screenshot of the page with an option to test your custom speech model." lightbox="./media/ai-studio/custom-speech/new-fine-tune-test-model.png":::
-
-1. In the **Create a new test** wizard, select the test type. In this example, we select **Evaluate accuracy (Audio + transcript data)**. Then select **Next**.
-
-    :::image type="content" source="./media/ai-studio/custom-speech/new-fine-tune-test-model-select-type.png" alt-text="Screenshot of the page with an option to select the test type." lightbox="./media/ai-studio/custom-speech/new-fine-tune-test-model-select-type.png":::
-
-1. Select the data that you want to use for testing. Then select **Next**.
-1. Select up to two models to evaluate and compare accuracy. In this example, we select the model that we trained and the base model. Then select **Next**.
-
-    :::image type="content" source="./media/ai-studio/custom-speech/new-fine-tune-test-model-select-models.png" alt-text="Screenshot of the page with an option to select up to two models to evaluate and compare accuracy." lightbox="./media/ai-studio/custom-speech/new-fine-tune-test-model-select-models.png":::
-
-1. Enter a name and description for the test. Then select **Next**.
-1. Review the settings and select **Create test**. You're taken back to the **Test models** page. The status of the data is **Processing**.
-
-    :::image type="content" source="./media/ai-studio/custom-speech/new-fine-tune-test-model-status-processing.png" alt-text="Screenshot of the page that shows the status of the test as processing." lightbox="./media/ai-studio/custom-speech/new-fine-tune-test-model-status-processing.png":::
-
-1. When the test status is **Succeeded**, you can view the results. Select the test to view the results.
-
-
-## Deploy the custom model
-
-1. After you're satisfied with the test results, select **Deploy models** from the left menu. Then select **+ Deploy model**.
-
-    :::image type="content" source="./media/ai-studio/custom-speech/new-fine-tune-deploy-model.png" alt-text="Screenshot of the page with an option to deploy the custom speech model." lightbox="./media/ai-studio/custom-speech/new-fine-tune-deploy-model.png":::
-
-1. In the **Deploy a new model** wizard, select the model that you want to deploy. 
-
-    :::image type="content" source="./media/ai-studio/custom-speech/new-fine-tune-deploy-model-select-and-deploy.png" alt-text="Screenshot of the page with an option to select the model that you want to deploy." lightbox="./media/ai-studio/custom-speech/new-fine-tune-deploy-model-select-and-deploy.png":::
-
-1. Enter a name and description for the deployment. Select the box to agree to the terms of use. Then select **Deploy**.
-
-1. After the deployment status is **Succeeded**, you can view the deployment details. Select the deployment to view the details like the endpoint ID. 
-
-    :::image type="content" source="./media/ai-studio/custom-speech/new-fine-tune-deploy-model-status-succeeded.png" alt-text="Screenshot of the page with an option to select the deployment to view the details like the endpoint ID." lightbox="./media/ai-studio/custom-speech/new-fine-tune-deploy-model-status-succeeded.png":::
 
 ## View fine-tuned models
 
@@ -165,7 +97,7 @@ A base model or custom model deployed to an endpoint using custom speech is fixe
 
 Whether you train your own model or use a snapshot of a base model, you can use the model for a limited time. For more information, see [Model and endpoint lifecycle](./how-to-custom-speech-model-and-endpoint-lifecycle.md).
 
-## Next steps
+## Related content
 
 * [Training and testing datasets](./how-to-custom-speech-test-and-train.md)
 * [Test model quantitatively](how-to-custom-speech-evaluate-data.md)

articles/ai-services/speech-service/how-to-custom-speech-deploy-model.md

@@ -29,6 +29,20 @@ You can deploy an endpoint for a base or custom model, and then [update](#change
 ::: zone pivot="ai-foundry-portal"
 
 
+1. After you're satisfied with the test results, select **Deploy models** from the left menu. Then select **+ Deploy model**.
+
+    :::image type="content" source="./media/ai-studio/custom-speech/new-fine-tune-deploy-model.png" alt-text="Screenshot of the page with an option to deploy the custom speech model." lightbox="./media/ai-studio/custom-speech/new-fine-tune-deploy-model.png":::
+
+1. In the **Deploy a new model** wizard, select the model that you want to deploy. 
+
+    :::image type="content" source="./media/ai-studio/custom-speech/new-fine-tune-deploy-model-select-and-deploy.png" alt-text="Screenshot of the page with an option to select the model that you want to deploy." lightbox="./media/ai-studio/custom-speech/new-fine-tune-deploy-model-select-and-deploy.png":::
+
+1. Enter a name and description for the deployment. Select the box to agree to the terms of use. Then select **Deploy**.
+
+1. After the deployment status is **Succeeded**, you can view the deployment details. Select the deployment to view the details like the endpoint ID. 
+
+    :::image type="content" source="./media/ai-studio/custom-speech/new-fine-tune-deploy-model-status-succeeded.png" alt-text="Screenshot of the page with an option to select the deployment to view the details like the endpoint ID." lightbox="./media/ai-studio/custom-speech/new-fine-tune-deploy-model-status-succeeded.png":::
+
 
 ::: zone-end
 

articles/ai-services/speech-service/how-to-custom-speech-evaluate-data.md

@@ -27,6 +27,25 @@ You can test the accuracy of your custom model by creating a test. A test requir
 ::: zone pivot="ai-foundry-portal"
 
 
+1. After the model is trained, select **Test models** from the left menu. Then select **+ Create test**.
+
+    :::image type="content" source="./media/ai-studio/custom-speech/new-fine-tune-test-model.png" alt-text="Screenshot of the page with an option to test your custom speech model." lightbox="./media/ai-studio/custom-speech/new-fine-tune-test-model.png":::
+
+1. In the **Create a new test** wizard, select the test type. In this example, we select **Evaluate accuracy (Audio + transcript data)**. Then select **Next**.
+
+    :::image type="content" source="./media/ai-studio/custom-speech/new-fine-tune-test-model-select-type.png" alt-text="Screenshot of the page with an option to select the test type." lightbox="./media/ai-studio/custom-speech/new-fine-tune-test-model-select-type.png":::
+
+1. Select the data that you want to use for testing. Then select **Next**.
+1. Select up to two models to evaluate and compare accuracy. In this example, we select the model that we trained and the base model. Then select **Next**.
+
+    :::image type="content" source="./media/ai-studio/custom-speech/new-fine-tune-test-model-select-models.png" alt-text="Screenshot of the page with an option to select up to two models to evaluate and compare accuracy." lightbox="./media/ai-studio/custom-speech/new-fine-tune-test-model-select-models.png":::
+
+1. Enter a name and description for the test. Then select **Next**.
+1. Review the settings and select **Create test**. You're taken back to the **Test models** page. The status of the data is **Processing**.
+
+    :::image type="content" source="./media/ai-studio/custom-speech/new-fine-tune-test-model-status-processing.png" alt-text="Screenshot of the page that shows the status of the test as processing." lightbox="./media/ai-studio/custom-speech/new-fine-tune-test-model-status-processing.png":::
+
+
 
 ::: zone-end
 
@@ -235,6 +254,7 @@ You should get the test results and [evaluate](#evaluate-word-error-rate-wer) th
 
 ::: zone pivot="ai-foundry-portal"
 
+When the test status is **Succeeded**, you can view the results. Select the test to view the results.
 
 
 ::: zone-end

articles/ai-services/speech-service/how-to-custom-speech-train-model.md

@@ -33,6 +33,19 @@ You can use a custom model for a limited time after it was trained. You must per
 ::: zone pivot="ai-foundry-portal"
 
 
+1. After the data is processed, select **Train model** from the left menu. Then select **+ Train model**.
+
+    :::image type="content" source="./media/ai-studio/custom-speech/new-fine-tune-train-model.png" alt-text="Screenshot of the page with an option to start training for a custom speech model." lightbox="./media/ai-studio/custom-speech/new-fine-tune-train-model.png":::
+
+1. In the **Train a new model** wizard, select the base model that you want to fine-tune. Then select **Next**.
+
+    :::image type="content" source="./media/ai-studio/custom-speech/new-fine-tune-train-model-select-base.png" alt-text="Screenshot of the page with an option to select the base model that you want to fine-tune." lightbox="./media/ai-studio/custom-speech/new-fine-tune-train-model-select-base.png":::
+
+1. Select the data that you want to use for training. Then select **Next**.
+1. Enter a name and description for the model. Then select **Next**.
+1. Review the settings and select **Train a new model**. You're taken back to the **Train model** page. The status of the data is **Processing**.
+
+    :::image type="content" source="./media/ai-studio/custom-speech/new-fine-tune-train-model-status-processing.png" alt-text="Screenshot of the page that shows the status of the training as processing." lightbox="./media/ai-studio/custom-speech/new-fine-tune-train-model-status-processing.png":::
 
 ::: zone-end
 

articles/ai-services/speech-service/how-to-custom-speech-upload-data.md

@@ -23,7 +23,19 @@ You need audio or text data for testing the accuracy of speech recognition or tr
 
 ::: zone pivot="ai-foundry-portal"
 
+1. From the new left menu in the fine-tuning page, select **Manage data** and then select **Add data**.
 
+    :::image type="content" source="./media/ai-studio/custom-speech/new-fine-tune-add-data.png" alt-text="Screenshot of the page with an option to add data to the custom speech project." lightbox="./media/ai-studio/custom-speech/new-fine-tune-add-data.png":::
+
+1. In the **Add data** wizard, select the type of training data you want to add. In this example, we select **Audio + human-labeled transcript**. Then select **Next**.
+
+    :::image type="content" source="./media/ai-studio/custom-speech/new-fine-tune-add-data-select-type.png" alt-text="Screenshot of the page with an option to select the type of training data you want to add." lightbox="./media/ai-studio/custom-speech/new-fine-tune-add-data-select-type.png":::
+
+1. On the **Upload your data** page, select local files, Azure Blob Storage, or other shared web locations. Then select **Next**.
+1. Enter a name and description for the data. Then select **Next**.
+1. Review the data and select **Upload**. You're taken back to the **Manage data** page. The status of the data is **Processing**.
+
+    :::image type="content" source="./media/ai-studio/custom-speech/new-fine-tune-add-data-status-processing.png" alt-text="Screenshot of the page that shows the status of the data as processing." lightbox="./media/ai-studio/custom-speech/new-fine-tune-add-data-status-processing.png":::
 
 ::: zone-end
 

articles/ai-services/speech-service/toc.yml

@@ -64,12 +64,12 @@ items:
             href: how-to-custom-speech-create-project.md
           - name: "Part 2: Upload training and testing datasets"
             href: how-to-custom-speech-upload-data.md
-          - name: "Part 3: Test recognition quality"
+          - name: "Part 3: Train a model"
+            href: how-to-custom-speech-train-model.md
+          - name: "Part 4: Test recognition quality"
             href: how-to-custom-speech-inspect-data.md
-          - name: "Part 4: Test model quantitatively"
+          - name: "Part 5: Test model quantitatively"
             href: how-to-custom-speech-evaluate-data.md
-          - name: "Part 5: Train a model"
-            href: how-to-custom-speech-train-model.md
           - name: "Part 6: Deploy a model"
             href: how-to-custom-speech-deploy-model.md
         - name: Custom speech datasets