Skip to content

Commit 0aee1a8

Browse files
authored
Merge pull request #207394 from PatrickFarley/comvis-updates
[cog svcs] Comvis updates
2 parents 6b4e2ea + ba9d72a commit 0aee1a8

17 files changed

+139
-3
lines changed

articles/cognitive-services/Computer-vision/includes/curl-quickstart.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,9 @@ Use the Optical character recognition REST API to read printed and handwritten t
2828
* [cURL](https://curl.haxx.se/) installed
2929

3030

31+
> [!div class="nextstepaction"]
32+
> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=REST&Pillar=Vision&Product=OCR&Page=quickstart&Section=Prerequisites" target="_target">I ran into an issue</a>
33+
3134
## Read printed and handwritten text
3235

3336
The OCR service can extract visible text in an image or document and convert it to a character stream. For more information on text extraction, see the [Optical character recognition (OCR) overview](../overview-ocr.md).
@@ -71,6 +74,9 @@ curl -v -X POST "https://westcentralus.api.cognitive.microsoft.com/vision/v3.2/r
7174
curl -v -X GET "https://westcentralus.api.cognitive.microsoft.com/vision/v3.2/read/analyzeResults/{operationId}" -H "Ocp-Apim-Subscription-Key: {subscription key}" --data-ascii "{body}"
7275
```
7376

77+
> [!div class="nextstepaction"]
78+
> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=REST&Pillar=Vision&Product=OCR&Page=quickstart&Section=Read-printed-and-handwritten-text" target="_target">I ran into an issue</a>
79+
7480
### Examine the response
7581

7682
A successful response is returned in JSON. The sample application parses and displays a successful response in the command prompt window, similar to the following example:
@@ -133,7 +139,8 @@ A successful response is returned in JSON. The sample application parses and dis
133139

134140
```
135141

136-
142+
> [!div class="nextstepaction"]
143+
> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=REST&Pillar=Vision&Product=OCR&Page=quickstart&Section=Output" target="_target">I ran into an issue</a>
137144
138145
## Next steps
139146

articles/cognitive-services/Computer-vision/includes/identity-curl-quickstart.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,8 @@ Get started with facial recognition using the Face REST API. The Face service pr
2525
* You can use the free pricing tier (`F0`) to try the service, and upgrade later to a paid tier for production.
2626
* [PowerShell version 6.0+](/powershell/scripting/install/installing-powershell-core-on-windows), or a similar command-line application.
2727

28+
> [!div class="nextstepaction"]
29+
> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=REST&Pillar=Vision&Product=Face&Page=quickstart&Section=Prerequisites" target="_target">I ran into an issue</a>
2830
2931
## Identify faces
3032

@@ -66,6 +68,9 @@ Get started with facial recognition using the Face REST API. The Face service pr
6668

6769
The response should give you a **Person** ID indicating the person identified with the source face. It should be the ID that corresponds to the "Family1-Dad" person, because the source face is of that person.
6870

71+
> [!div class="nextstepaction"]
72+
> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=REST&Pillar=Vision&Product=Face&Page=quickstart&Section=Identify-faces" target="_target">I ran into an issue</a>
73+
6974
## Clean up resources
7075

7176
To delete the **LargePersonGroup** you created in this exercise, run the LargePersonGroup - Delete call.

articles/cognitive-services/Computer-vision/includes/identity-studio-quickstart.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,9 @@ Use Vision Studio to identify a face. This is a streamlined version of the face
2020
* Sign in to [Vision Studio](https://portal.vision.cognitive.azure.com/) with your Azure subscription and Cognitive Services resource. See the [Get started section](../overview-vision-studio.md#get-started-using-vision-studio) of the overview if you need help with this step.
2121
* You'll need at least three images of a person's face: two or more to train the model and one to test it.
2222

23+
> [!div class="nextstepaction"]
24+
> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=Vision-studio&Pillar=Vision&Product=Face&Page=quickstart&Section=Prerequisites" target="_target">I ran into an issue</a>
25+
2326
## Identify faces
2427

2528
1. Select the **Analyze faces** tab, and select panel titled **Recognize a particular person**.
@@ -29,6 +32,9 @@ Use Vision Studio to identify a face. This is a streamlined version of the face
2932
1. See the **Detected attributes** pane for the match results and confidence scores.
3033
1. Below the try-it-out experience are next steps to start using this capability in your own application.
3134

35+
> [!div class="nextstepaction"]
36+
> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=Vision-studio&Pillar=Vision&Product=Face&Page=quickstart&Section=Identify-faces" target="_target">I ran into an issue</a>
37+
3238
## Next steps
3339

3440
In this quickstart, you learned how to use Vision Studio to do a basic facial recognition task. Next, learn about the different face detection models and how to specify the right model for your use case.

articles/cognitive-services/Computer-vision/includes/image-analysis-curl-quickstart.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,9 @@ Use the Image Analysis REST API to analyze an image for tags.
2727
* You can use the free pricing tier (`F0`) to try the service, and upgrade later to a paid tier for production.
2828
* [cURL](https://curl.haxx.se/) installed
2929

30+
> [!div class="nextstepaction"]
31+
> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=REST&Pillar=Vision&Product=Image-analysis&Page=quickstart&Section=Prerequisites" target="_target">I ran into an issue</a>
32+
3033
## Analyze an image
3134

3235
To analyze an image for various visual features, do the following steps:
@@ -44,6 +47,9 @@ To analyze an image for various visual features, do the following steps:
4447
curl -H "Ocp-Apim-Subscription-Key: <subscriptionKey>" -H "Content-Type: application/json" "https://westcentralus.api.cognitive.microsoft.com/vision/v3.2/analyze?visualFeatures=Categories,Description&details=Landmarks" -d "{\"url\":\"http://upload.wikimedia.org/wikipedia/commons/3/3c/Shaki_waterfall.jpg\"}"
4548
```
4649

50+
> [!div class="nextstepaction"]
51+
> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=REST&Pillar=Vision&Product=Image-analysis&Page=quickstart&Section=Analyze-image" target="_target">I ran into an issue</a>
52+
4753
### Examine the response
4854

4955
A successful response is returned in JSON. The sample application parses and displays a successful response in the command prompt window, similar to the following example:
@@ -104,8 +110,8 @@ A successful response is returned in JSON. The sample application parses and dis
104110
}
105111
```
106112

107-
108-
113+
> [!div class="nextstepaction"]
114+
> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=REST&Pillar=Vision&Product=Image-analysis&Page=quickstart&Section=Output" target="_target">I ran into an issue</a>
109115
110116
## Next steps
111117

articles/cognitive-services/Computer-vision/includes/image-analysis-studio-quickstart.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,9 @@ ms.author: pafarley
1717

1818
* Sign in to [Vision Studio](https://portal.vision.cognitive.azure.com/) with your Azure subscription and Cognitive Services resource. See the [Get started section](../overview-vision-studio.md#get-started-using-vision-studio) of the overview if you need help with this step.
1919

20+
> [!div class="nextstepaction"]
21+
> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=Vision-studio&Pillar=Vision&Product=Image-analysis&Page=quickstart&Section=Prerequisites" target="_target">I ran into an issue</a>
22+
2023
## Analyze an image
2124

2225
1. Select the **Analyze images** tab, and select panel titled **Extract common tags from images**.
@@ -25,6 +28,9 @@ ms.author: pafarley
2528
1. After you select your image, you'll see the detected tags appear in the output window along with their confidence scores. You can also select the **JSON** tab to see the JSON output that the API call returns.
2629
1. Below the try-it-out experience are next steps to start using this capability in your own application.
2730

31+
> [!div class="nextstepaction"]
32+
> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=Vision-studio&Pillar=Vision&Product=Image-analysis&Page=quickstart&Section=Analyze-image" target="_target">I ran into an issue</a>
33+
2834
## Next steps
2935

3036
In this quickstart, you used Vision Studio to do a basic image analysis task. Next, learn more about the Analyze API features.

articles/cognitive-services/Computer-vision/includes/ocr-studio-quickstart.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,9 @@ ms.author: pafarley
1717

1818
* Sign in to [Vision Studio](https://portal.vision.cognitive.azure.com/) with your Azure subscription and Cognitive Services resource. See the [Get started section](../overview-vision-studio.md#get-started-using-vision-studio) of the overview if you need help with this step.
1919

20+
> [!div class="nextstepaction"]
21+
> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=Vision-studio&Pillar=Vision&Product=OCR&Page=quickstart&Section=Prerequisites" target="_target">I ran into an issue</a>
22+
2023
## Read printed and handwritten text
2124

2225
1. Select the **Extract text** tab, and select panel titled **Extract text from images**.
@@ -25,6 +28,9 @@ ms.author: pafarley
2528
1. After you select your image, you'll see the extracted text appear in the output window. You can also select the **JSON** tab to see the JSON output that the API call returns.
2629
1. Below the try-it-out experience are next steps to start using this capability in your own application.
2730

31+
> [!div class="nextstepaction"]
32+
> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=Vision-studio&Pillar=Vision&Product=OCR&Page=quickstart&Section=Read-printed-and-handwritten-text" target="_target">I ran into an issue</a>
33+
2834
## Next steps
2935

3036
In this quickstart, you used Vision Studio to access the Read API. Next, learn more about the Read API features.

articles/cognitive-services/Computer-vision/includes/quickstarts-sdk/csharp-sdk.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,10 @@ Use the OCR client library to read printed and handwritten text from a remote im
2929
* You will need the key and endpoint from the resource you create to connect your application to the Computer Vision service. You'll paste your key and endpoint into the code below later in the quickstart.
3030
* You can use the free pricing tier (`F0`) to try the service, and upgrade later to a paid tier for production.
3131

32+
> [!div class="nextstepaction"]
33+
> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=CSHARP&Pillar=Vision&Product=OCR&Page=quickstart&Section=Prerequisites" target="_target">I ran into an issue</a>
34+
35+
3236
## Read printed and handwritten text
3337

3438
1. Create a new C# application.
@@ -111,6 +115,9 @@ Use the OCR client library to read printed and handwritten text from a remote im
111115

112116
---
113117

118+
> [!div class="nextstepaction"]
119+
> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=CSHARP&Pillar=Vision&Product=OCR&Page=quickstart&Section=Read-printed-and-handwritten-text" target="_target">I ran into an issue</a>
120+
114121
## Output
115122

116123
```console
@@ -137,6 +144,8 @@ nt Daily Values are based on Vitamin A 50%
137144
calorie diet.
138145
```
139146

147+
> [!div class="nextstepaction"]
148+
> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=CSHARP&Pillar=Vision&Product=OCR&Page=quickstart&Section=Output" target="_target">I ran into an issue</a>
140149
141150
## Clean up resources
142151

articles/cognitive-services/Computer-vision/includes/quickstarts-sdk/identity-csharp-sdk.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,9 @@ Get started with facial recognition using the Face client library for .NET. The
2424
* You will need the key and endpoint from the resource you create to connect your application to the Face API. You'll paste your key and endpoint into the code below later in the quickstart.
2525
* You can use the free pricing tier (`F0`) to try the service, and upgrade later to a paid tier for production.
2626

27+
> [!div class="nextstepaction"]
28+
> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=CSHARP&Pillar=Vision&Product=Face&Page=quickstart&Section=Prerequisites" target="_target">I ran into an issue</a>
29+
2730
## Identify faces
2831

2932
1. Create a new C# application
@@ -98,6 +101,9 @@ Get started with facial recognition using the Face client library for .NET. The
98101

99102
---
100103

104+
> [!div class="nextstepaction"]
105+
> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=CSHARP&Pillar=Vision&Product=Face&Page=quickstart&Section=Identify-faces" target="_target">I ran into an issue</a>
106+
101107
## Output
102108

103109
```console
@@ -133,6 +139,9 @@ Person 'Family1-Son' is identified for face in: identification1.jpg - 53772235-8
133139
End of quickstart.
134140
```
135141

142+
> [!div class="nextstepaction"]
143+
> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=CSHARP&Pillar=Vision&Product=Face&Page=quickstart&Section=Output" target="_target">I ran into an issue</a>
144+
136145
> [!TIP]
137146
> The Face API runs on a set of pre-built models that are static by nature (the model's performance will not regress or improve as the service is run). The results that the model produces might change if Microsoft updates the model's backend without migrating to an entirely new model version. To take advantage of a newer version of a model, you can retrain your **PersonGroup**, specifying the newer model as a parameter with the same enrollment images.
138147

articles/cognitive-services/Computer-vision/includes/quickstarts-sdk/identity-javascript-sdk.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,9 @@ Get started with facial recognition using the Face client library for JavaScript
2424
* You will need the key and endpoint from the resource you create to connect your application to the Face API. You'll paste your key and endpoint into the code below later in the quickstart.
2525
* You can use the free pricing tier (`F0`) to try the service, and upgrade later to a paid tier for production.
2626

27+
> [!div class="nextstepaction"]
28+
> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=JAVASCRIPT&Pillar=Vision&Product=Face&Page=quickstart&Section=Prerequisites" target="_target">I ran into an issue</a>
29+
2730
## Identify faces
2831

2932
1. Create a new Node.js application
@@ -67,6 +70,9 @@ Get started with facial recognition using the Face client library for JavaScript
6770
node index.js
6871
```
6972

73+
> [!div class="nextstepaction"]
74+
> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=JAVASCRIPT&Pillar=Vision&Product=Face&Page=quickstart&Section=Identify-faces" target="_target">I ran into an issue</a>
75+
7076
## Output
7177

7278
```console
@@ -101,6 +107,9 @@ Person: Family1-Son is identified for face in: identification1.jpg with ID: 600d
101107
Person: Family1-Dad is identified for face in: identification1.jpg with ID: e83b494f-9ad2-473f-9d86-3de79c01e345. Confidence: 0.96725.
102108
```
103109

110+
> [!div class="nextstepaction"]
111+
> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=JAVASCRIPT&Pillar=Vision&Product=Face&Page=quickstart&Section=Output" target="_target">I ran into an issue</a>
112+
104113
## Clean up resources
105114

106115
If you want to clean up and remove a Cognitive Services subscription, you can delete the resource or resource group. Deleting the resource group also deletes any other resources associated with it.

articles/cognitive-services/Computer-vision/includes/quickstarts-sdk/identity-python-sdk.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,9 @@ Get started with facial recognition using the Face client library for Python. Fo
2525
* You will need the key and endpoint from the resource you create to connect your application to the Face API. You'll paste your key and endpoint into the code below later in the quickstart.
2626
* You can use the free pricing tier (`F0`) to try the service, and upgrade later to a paid tier for production.
2727

28+
> [!div class="nextstepaction"]
29+
> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=PYTHON&Pillar=Vision&Product=Face&Page=quickstart&Section=Prerequisites" target="_target">I ran into an issue</a>
30+
2831
## Identify faces
2932

3033
1. Install the client library
@@ -58,6 +61,9 @@ Get started with facial recognition using the Face client library for Python. Fo
5861
> [!TIP]
5962
> The Face API runs on a set of pre-built models that are static by nature (the model's performance will not regress or improve as the service is run). The results that the model produces might change if Microsoft updates the model's backend without migrating to an entirely new model version. To take advantage of a newer version of a model, you can retrain your **PersonGroup**, specifying the newer model as a parameter with the same enrollment images.
6063

64+
> [!div class="nextstepaction"]
65+
> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=PYTHON&Pillar=Vision&Product=Face&Page=quickstart&Section=Identify-faces" target="_target">I ran into an issue</a>
66+
6167
## Output
6268

6369
```console
@@ -82,6 +88,9 @@ No person identified for face ID c4a3dd28-ef2d-457e-81d1-a447344242c4 in image.
8288
Person for face ID 360edf1a-1e8f-402d-aa96-1734d0c21c1c is identified in image, with a confidence of 0.92886.
8389
```
8490

91+
> [!div class="nextstepaction"]
92+
> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=PYTHON&Pillar=Vision&Product=Face&Page=quickstart&Section=Output" target="_target">I ran into an issue</a>
93+
8594
## Clean up resources
8695

8796
If you want to clean up and remove a Cognitive Services subscription, you can delete the resource or resource group. Deleting the resource group also deletes any other resources associated with it.

0 commit comments

Comments
 (0)