Merge pull request #203216 from eric-urban/eur/try-it-user-research

cli try it interactive

Author: PRMerger4

articles/cognitive-services/Speech-Service/how-to-custom-speech-create-project.md

@@ -30,6 +30,9 @@ To create a Custom Speech project, follow these steps:
 
 Select the new project by name or select **Go to project**. You will see these menu items in the left panel: **Speech datasets**, **Train custom models**, **Test models**, and **Deploy models**. 
 
+> [!div class="nextstepaction"]
+> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=Speech-studio&Pillar=Speech&Product=Custom-speech&Page=Create-a-project&Section=Create-a-project" target="_target">I ran into an issue</a>
+
 ::: zone-end
 
 ::: zone pivot="speech-cli"
@@ -41,10 +44,13 @@ To create a project, use the `spx csr project create` command. Construct the req
 
 Here's an example Speech CLI command that creates a project:
 
-```azurecli
+```azurecli-interactive
 spx csr project create --name "My Project" --description "My Project Description" --language "en-US"
 ```
 
+> [!div class="nextstepaction"]
+> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=CLI&Pillar=Speech&Product=Custom-speech&Page=Create-a-project&Section=Create-a-project" target="_target">I ran into an issue</a>
+
 You should receive a response body in the following format:
 
 ```json
@@ -75,7 +81,7 @@ The top-level `self` property in the response body is the project's URI. Use thi
 
 For Speech CLI help with projects, run the following command:
 
-```azurecli
+```azurecli-interactive
 spx help csr project
 ```
 
@@ -98,6 +104,9 @@ curl -v -X POST -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey" -H "Content-
 } '  "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.0/projects"
 ```
 
+> [!div class="nextstepaction"]
+> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=REST&Pillar=Speech&Product=Custom-speech&Page=Create-a-project&Section=Create-a-project" target="_target">I ran into an issue</a>
+
 You should receive a response body in the following format:
 
 ```json

articles/cognitive-services/Speech-Service/how-to-custom-speech-deploy-model.md

@@ -66,10 +66,13 @@ To create an endpoint and deploy a model, use the `spx csr endpoint create` comm
 
 Here's an example Speech CLI command to create an endpoint and deploy a model:
 
-```azurecli
+```azurecli-interactive
 spx csr endpoint create --project YourProjectId --model YourModelId --name "My Endpoint" --description "My Endpoint Description" --language "en-US"
 ```
 
+> [!div class="nextstepaction"]
+> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=Speech-studio&Pillar=Speech&Product=Custom-speech&Page=Deploy-a-model&Section=Add-a-deployment-endpoint" target="_target">I ran into an issue</a>
+
 You should receive a response body in the following format:
 
 ```json
@@ -106,7 +109,7 @@ The top-level `self` property in the response body is the endpoint's URI. Use th
 
 For Speech CLI help with endpoints, run the following command:
 
-```azurecli
+```azurecli-interactive
 spx help csr endpoint
 ```
 
@@ -141,6 +144,9 @@ curl -v -X POST -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey" -H "Content-
 }'  "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.0/endpoints"
 ```
 
+> [!div class="nextstepaction"]
+> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=CLI&Pillar=Speech&Product=Custom-speech&Page=Deploy-a-model&Section=Add-a-deployment-endpoint" target="_target">I ran into an issue</a>
+
 You should receive a response body in the following format:
 
 ```json
@@ -202,10 +208,13 @@ To redeploy the custom endpoint with a new model, use the `spx csr model update`
 
 Here's an example Speech CLI command that redeploys the custom endpoint with a new model:
 
-```azurecli
+```azurecli-interactive
 spx csr endpoint update --endpoint YourEndpointId --model YourModelId
 ```
 
+> [!div class="nextstepaction"]
+> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=REST&Pillar=Speech&Product=Custom-speech&Page=Deploy-a-model&Section=Add-a-deployment-endpoint" target="_target">I ran into an issue</a>
+
 You should receive a response body in the following format:
 
 ```json
@@ -240,7 +249,7 @@ You should receive a response body in the following format:
 
 For Speech CLI help with endpoints, run the following command:
 
-```azurecli
+```azurecli-interactive
 spx help csr endpoint
 ```
 
@@ -262,6 +271,9 @@ curl -v -X PATCH -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey" -H "Content
 }'  "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.0/endpoints/YourEndpointId"
 ```
 
+> [!div class="nextstepaction"]
+> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=Speech-studio&Pillar=Speech&Product=Custom-speech&Page=Deploy-a-model&Section=Change-model-and-redeploy-endpoint" target="_target">I ran into an issue</a>
+
 You should receive a response body in the following format:
 
 ```json
@@ -321,10 +333,13 @@ To gets logs for an endpoint, use the `spx csr endpoint list` command. Construct
 
 Here's an example Speech CLI command that gets logs for an endpoint:
 
-```azurecli
+```azurecli-interactive
 spx csr endpoint list --endpoint YourEndpointId
 ```
 
+> [!div class="nextstepaction"]
+> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=CLI&Pillar=Speech&Product=Custom-speech&Page=Deploy-a-model&Section=Change-model-and-redeploy-endpoint" target="_target">I ran into an issue</a>
+
 The location of each log file with more details are returned in the response body.
 
 ::: zone-end
@@ -339,6 +354,9 @@ Make an HTTP GET request using the URI as shown in the following example. Replac
 curl -v -X GET "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.0/endpoints/YourEndpointId" -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey"
 ```
 
+> [!div class="nextstepaction"]
+> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=REST&Pillar=Speech&Product=Custom-speech&Page=Deploy-a-model&Section=Change-model-and-redeploy-endpoint" target="_target">I ran into an issue</a>
+
 You should receive a response body in the following format:
 
 ```json

articles/cognitive-services/Speech-Service/how-to-custom-speech-evaluate-data.md

@@ -43,6 +43,8 @@ Follow these steps to create a test:
 1. Enter the test name and description, and then select **Next**.
 1. Review the test details, and then select **Save and close**.
 
+> [!div class="nextstepaction"]
+> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=Speech-studio&Pillar=Speech&Product=Custom-speech&Page=Test-model-quantitatively&Section=Create-a-test" target="_target">I ran into an issue</a>
 
 ::: zone-end
 
@@ -59,10 +61,13 @@ To create a test, use the `spx csr evaluation create` command. Construct the req
 
 Here's an example Speech CLI command that creates a test:
 
-```azurecli
+```azurecli-interactive
 spx csr evaluation create --project 9f8c4cbb-f9a5-4ec1-8bb0-53cfa9221226 --dataset be378d9d-a9d7-4d4a-820a-e0432e8678c7 --model1 ff43e922-e3e6-4bf0-8473-55c08fd68048 --model2 1aae1070-7972-47e9-a977-87e3b05c457d --name "My Evaluation" --description "My Evaluation Description"
 ```
 
+> [!div class="nextstepaction"]
+> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=CLI&Pillar=Speech&Product=Custom-speech&Page=Test-model-quantitatively&Section=Create-a-test" target="_target">I ran into an issue</a>
+
 You should receive a response body in the following format:
 
 ```json
@@ -120,7 +125,7 @@ The top-level `self` property in the response body is the evaluation's URI. Use
 
 For Speech CLI help with evaluations, run the following command:
 
-```azurecli
+```azurecli-interactive
 spx help csr evaluation
 ```
 
@@ -163,6 +168,9 @@ curl -v -X POST -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey" -H "Content-
 }'  "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.0/evaluations"
 ```
 
+> [!div class="nextstepaction"]
+> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=REST&Pillar=Speech&Product=Custom-speech&Page=Test-model-quantitatively&Section=Create-a-test" target="_target">I ran into an issue</a>
+
 You should receive a response body in the following format:
 
 ```json
@@ -238,6 +246,9 @@ Follow these steps to get test results:
 
 This page lists all the utterances in your dataset and the recognition results, alongside the transcription from the submitted dataset. You can toggle various error types, including insertion, deletion, and substitution. By listening to the audio and comparing recognition results in each column, you can decide which model meets your needs and determine where additional training and improvements are required.
 
+> [!div class="nextstepaction"]
+> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=Speech-studio&Pillar=Speech&Product=Custom-speech&Page=Test-model-quantitatively&Section=Get-test-results" target="_target">I ran into an issue</a>
+
 ::: zone-end
 
 ::: zone pivot="speech-cli"
@@ -248,10 +259,13 @@ To get test results, use the `spx csr evaluation status` command. Construct the
 
 Here's an example Speech CLI command that gets test results:
 
-```azurecli
+```azurecli-interactive
 spx csr evaluation status --evaluation 8bfe6b05-f093-4ab4-be7d-180374b751ca
 ```
 
+> [!div class="nextstepaction"]
+> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=CLI&Pillar=Speech&Product=Custom-speech&Page=Test-model-quantitatively&Section=Get-test-results" target="_target">I ran into an issue</a>
+
 The word error rates and more details are returned in the response body.
 
 You should receive a response body in the following format:
@@ -312,7 +326,7 @@ You should receive a response body in the following format:
 
 For Speech CLI help with evaluations, run the following command:
 
-```azurecli
+```azurecli-interactive
 spx help csr evaluation
 ```
 
@@ -328,6 +342,9 @@ Make an HTTP GET request using the URI as shown in the following example. Replac
 curl -v -X GET "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.0/evaluations/YourEvaluationId" -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey"
 ```
 
+> [!div class="nextstepaction"]
+> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=REST&Pillar=Speech&Product=Custom-speech&Page=Test-model-quantitatively&Section=Get-test-results" target="_target">I ran into an issue</a>
+
 The word error rates and more details are returned in the response body.
 
 You should receive a response body in the following format:

articles/cognitive-services/Speech-Service/how-to-custom-speech-inspect-data.md

@@ -39,6 +39,9 @@ Follow these instructions to create a test:
 1. Enter the test name and description, and then select **Next**.
 1. Review your settings, and then select **Save and close**.
 
+> [!div class="nextstepaction"]
+> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=Speech-studio&Pillar=Speech&Product=Custom-speech&Page=Test-recognition-quality&Section=Create-a-test" target="_target">I ran into an issue</a>
+
 ::: zone-end
 
 ::: zone pivot="speech-cli"
@@ -54,10 +57,13 @@ To create a test, use the `spx csr evaluation create` command. Construct the req
 
 Here's an example Speech CLI command that creates a test:
 
-```azurecli
+```azurecli-interactive
 spx csr evaluation create --project 9f8c4cbb-f9a5-4ec1-8bb0-53cfa9221226 --dataset be378d9d-a9d7-4d4a-820a-e0432e8678c7 --model1 ff43e922-e3e6-4bf0-8473-55c08fd68048 --model2 1aae1070-7972-47e9-a977-87e3b05c457d --name "My Inspection" --description "My Inspection Description"
 ```
 
+> [!div class="nextstepaction"]
+> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=CLI&Pillar=Speech&Product=Custom-speech&Page=Test-recognition-quality&Section=Create-a-test" target="_target">I ran into an issue</a>
+
 You should receive a response body in the following format:
 
 ```json
@@ -115,7 +121,7 @@ The top-level `self` property in the response body is the evaluation's URI. Use
 
 For Speech CLI help with evaluations, run the following command:
 
-```azurecli
+```azurecli-interactive
 spx help csr evaluation
 ```
 
@@ -154,6 +160,9 @@ curl -v -X POST -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey" -H "Content-
 }'  "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.0/evaluations"
 ```
 
+> [!div class="nextstepaction"]
+> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=REST&Pillar=Speech&Product=Custom-speech&Page=Test-recognition-quality&Section=Create-a-test" target="_target">I ran into an issue</a>
+
 You should receive a response body in the following format:
 
 ```json
@@ -227,6 +236,9 @@ Follow these steps to get test results:
 
 This page lists all the utterances in your dataset and the recognition results, alongside the transcription from the submitted dataset. You can toggle various error types, including insertion, deletion, and substitution. By listening to the audio and comparing recognition results in each column, you can decide which model meets your needs and determine where additional training and improvements are required.
 
+> [!div class="nextstepaction"]
+> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=Speech-studio&Pillar=Speech&Product=Custom-speech&Page=Test-recognition-quality&Section=Get-test-results" target="_target">I ran into an issue</a>
+
 ::: zone-end
 
 ::: zone pivot="speech-cli"
@@ -237,10 +249,13 @@ To get test results, use the `spx csr evaluation status` command. Construct the
 
 Here's an example Speech CLI command that gets test results:
 
-```azurecli
+```azurecli-interactive
 spx csr evaluation status --evaluation 8bfe6b05-f093-4ab4-be7d-180374b751ca
 ```
 
+> [!div class="nextstepaction"]
+> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=CLI&Pillar=Speech&Product=Custom-speech&Page=Test-recognition-quality&Section=Get-test-results" target="_target">I ran into an issue</a>
+
 The models, audio dataset, transcriptions, and more details are returned in the response body.
 
 You should receive a response body in the following format:
@@ -298,7 +313,7 @@ You should receive a response body in the following format:
 
 For Speech CLI help with evaluations, run the following command:
 
-```azurecli
+```azurecli-interactive
 spx help csr evaluation
 ```
 
@@ -314,6 +329,9 @@ Make an HTTP GET request using the URI as shown in the following example. Replac
 curl -v -X GET "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.0/evaluations/YourEvaluationId" -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey"
 ```
 
+> [!div class="nextstepaction"]
+> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=REST&Pillar=Speech&Product=Custom-speech&Page=Test-recognition-quality&Section=Get-test-results" target="_target">I ran into an issue</a>
+
 The models, audio dataset, transcriptions, and more details are returned in the response body.
 
 You should receive a response body in the following format:

articles/cognitive-services/Speech-Service/how-to-custom-speech-model-and-endpoint-lifecycle.md

@@ -68,7 +68,7 @@ To get the training and transcription expiration dates for a base model, use the
 
 Here's an example Speech CLI command to get the training and transcription expiration dates for a base model:
 
-```azurecli
+```azurecli-interactive
 spx csr model status --model https://eastus.api.cognitive.microsoft.com/speechtotext/v3.0/models/base/b0bbc1e0-78d5-468b-9b7c-a5a43b2bb83f
 ```
 
@@ -100,7 +100,7 @@ You should receive a response body in the following format:
 
 For Speech CLI help with models, run the following command:
 
-```azurecli
+```azurecli-interactive
 spx help csr model
 ```
 
@@ -176,7 +176,7 @@ To get the transcription expiration date for your custom model, use the `spx csr
 
 Here's an example Speech CLI command to get the transcription expiration date for your custom model:
 
-```azurecli
+```azurecli-interactive
 spx csr model status --model https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.0/models/YourModelId
 ```
 
@@ -219,7 +219,7 @@ You should receive a response body in the following format:
 
 For Speech CLI help with models, run the following command:
 
-```azurecli
+```azurecli-interactive
 spx help csr model
 ```