new quickstart for cs py and js

der3318 · der3318 · commit c7a1a2b64e0b · 2024-07-18T10:47:04.000+08:00
diff --git a/articles/ai-services/computer-vision/includes/quickstarts-sdk/identity-csharp-sdk.md b/articles/ai-services/computer-vision/includes/quickstarts-sdk/identity-csharp-sdk.md
@@ -15,7 +15,7 @@ ms.author: pafarley
 
 Get started with facial recognition using the Face client library for .NET. The Azure AI Face service provides you with access to advanced algorithms for detecting and recognizing human faces in images. Follow these steps to install the package and try out the example code for basic face identification using remote images.
 
-[Reference documentation](/dotnet/api/overview/azure/cognitiveservices/face-readme) | [Library source code](https://github.com/Azure/azure-sdk-for-net/tree/master/sdk/cognitiveservices/Vision.Face) | [Package (NuGet)](https://www.nuget.org/packages/Microsoft.Azure.CognitiveServices.Vision.Face/2.7.0-preview.3) | [Samples](/samples/browse/?products=azure&term=face)
+[Reference documentation](https://aka.ms/azsdk-csharp-face-ref) | [Library source code](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/face/Azure.AI.Vision.Face) | [Package (NuGet)](https://aka.ms/azsdk-csharp-face-pkg) | [Samples](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/face/Azure.AI.Vision.Face/samples)
 
 ## Prerequisites
 
@@ -41,7 +41,7 @@ Get started with facial recognition using the Face client library for .NET. The
 
     ### Install the client library 
 
-    Once you've created a new project, install the client library by right-clicking on the project solution in the **Solution Explorer** and selecting **Manage NuGet Packages**. In the package manager that opens select **Browse**, check **Include prerelease**, and search for `Microsoft.Azure.CognitiveServices.Vision.Face`. Select the latest version, and then **Install**. 
+    Once you've created a new project, install the client library by right-clicking on the project solution in the **Solution Explorer** and selecting **Manage NuGet Packages**. In the package manager that opens select **Browse**, check **Include prerelease**, and search for `Azure.AI.Vision.Face`. Select the latest version, and then **Install**. 
 
     #### [CLI](#tab/cli)
 
@@ -72,7 +72,7 @@ Get started with facial recognition using the Face client library for .NET. The
     Within the application directory, install the Face client library for .NET with the following command:
 
     ```console
-    dotnet add package Microsoft.Azure.CognitiveServices.Vision.Face --prerelease
+    dotnet add package Azure.AI.Vision.Face --prerelease
     ```
 
     ---
@@ -81,7 +81,7 @@ Get started with facial recognition using the Face client library for .NET. The
     > [!NOTE]
     > If you haven't received access to the Face service using the [intake form](https://aka.ms/facerecognition), some of these functions won't work.
     
-    [!code-csharp[](~/cognitive-services-quickstart-code/dotnet/Face/FaceQuickstart-single.cs?name=snippet_single)]
+    [!code-csharp[](~/cognitive-services-quickstart-code/dotnet/Face/Quickstart.cs?name=snippet_single)]
 
 
 1. Run the application
@@ -107,32 +107,39 @@ Get started with facial recognition using the Face client library for .NET. The
 ```console
 ========IDENTIFY FACES========
 
-Create a person group (3972c063-71b3-4328-8579-6d190ee76f99).
+Create a person group (18d1c443-a01b-46a4-9191-121f74a831cd).
 Create a person group person 'Family1-Dad'.
+Check whether image is of sufficient quality for recognition
 Add face to the person group person(Family1-Dad) from image `Family1-Dad1.jpg`
+Check whether image is of sufficient quality for recognition
 Add face to the person group person(Family1-Dad) from image `Family1-Dad2.jpg`
 Create a person group person 'Family1-Mom'.
+Check whether image is of sufficient quality for recognition
 Add face to the person group person(Family1-Mom) from image `Family1-Mom1.jpg`
+Check whether image is of sufficient quality for recognition
 Add face to the person group person(Family1-Mom) from image `Family1-Mom2.jpg`
 Create a person group person 'Family1-Son'.
+Check whether image is of sufficient quality for recognition
 Add face to the person group person(Family1-Son) from image `Family1-Son1.jpg`
+Check whether image is of sufficient quality for recognition
 Add face to the person group person(Family1-Son) from image `Family1-Son2.jpg`
-Create a person group person 'Family1-Daughter'.
-Create a person group person 'Family2-Lady'.
-Add face to the person group person(Family2-Lady) from image `Family2-Lady1.jpg`
-Add face to the person group person(Family2-Lady) from image `Family2-Lady2.jpg`
-Create a person group person 'Family2-Man'.
-Add face to the person group person(Family2-Man) from image `Family2-Man1.jpg`
-Add face to the person group person(Family2-Man) from image `Family2-Man2.jpg`
 
-Train person group 3972c063-71b3-4328-8579-6d190ee76f99.
-Training status: Succeeded.
+Train person group 18d1c443-a01b-46a4-9191-121f74a831cd.
+Training status: succeeded.
 
+Pausing for 60 seconds to avoid triggering rate limit on free account...
 4 face(s) with 4 having sufficient quality for recognition detected from image `identification1.jpg`
-Person 'Family1-Dad' is identified for face in: identification1.jpg - 994bfd7a-0d8f-4fae-a5a6-c524664cbee7, confidence: 0.96725.
-Person 'Family1-Mom' is identified for face in: identification1.jpg - 0c9da7b9-a628-429d-97ff-cebe7c638fb5, confidence: 0.96921.
-No person is identified for face in: identification1.jpg - a881259c-e811-4f7e-a35e-a453e95ca18f,
-Person 'Family1-Son' is identified for face in: identification1.jpg - 53772235-8193-46eb-bdfc-1ebc25ea062e, confidence: 0.92886.
+Person 'Family1-Dad' is identified for the face in: identification1.jpg - ad813534-9141-47b4-bfba-24919223966f, confidence: 0.96807.
+Verification result: is a match? True. confidence: 0.96807
+Person 'Family1-Mom' is identified for the face in: identification1.jpg - 1a39420e-f517-4cee-a898-5d968dac1a7e, confidence: 0.96902.
+Verification result: is a match? True. confidence: 0.96902
+No person is identified for the face in: identification1.jpg - 889394b1-e30f-4147-9be1-302beb5573f3,
+Person 'Family1-Son' is identified for the face in: identification1.jpg - 0557d87b-356c-48a8-988f-ce0ad2239aa5, confidence: 0.9281.
+Verification result: is a match? True. confidence: 0.9281
+
+========DELETE PERSON GROUP========
+
+Deleted the person group 18d1c443-a01b-46a4-9191-121f74a831cd.
 
 End of quickstart.
 ```
@@ -149,14 +156,6 @@ If you want to clean up and remove an Azure AI services subscription, you can de
 * [Portal](../../../multi-service-resource.md?pivots=azportal#clean-up-resources)
 * [Azure CLI](../../../multi-service-resource.md?pivots=azcli#clean-up-resources)
 
-To delete the **PersonGroup** you created in this quickstart, run the following code in your program:
-
-[!code-csharp[](~/cognitive-services-quickstart-code/dotnet/Face/FaceQuickstart.cs?name=snippet_persongroup_delete)]
-
-Define the deletion method with the following code:
-
-[!code-csharp[](~/cognitive-services-quickstart-code/dotnet/Face/FaceQuickstart.cs?name=snippet_deletepersongroup)]
-
 ## Next steps
 
 In this quickstart, you learned how to use the Face client library for .NET to do basic face identification. Next, learn about the different face detection models and how to specify the right model for your use case.
@@ -165,4 +164,4 @@ In this quickstart, you learned how to use the Face client library for .NET to d
 > [Specify a face detection model version](../../how-to/specify-detection-model.md)
 
 * [What is the Face service?](../../overview-identity.md)
-* More extensive sample code can be found on [GitHub](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/dotnet/Face/FaceQuickstart.cs).
+* More extensive sample code can be found on [GitHub](https://aka.ms/FaceSamples).
diff --git a/articles/ai-services/computer-vision/includes/quickstarts-sdk/identity-javascript-sdk.md b/articles/ai-services/computer-vision/includes/quickstarts-sdk/identity-javascript-sdk.md
@@ -61,7 +61,7 @@ Get started with facial recognition using the Face client library for JavaScript
     > [!NOTE]
     > If you haven't received access to the Face service using the [intake form](https://aka.ms/facerecognition), some of these functions won't work.
 
-    :::code language="js" source="~/cognitive-services-quickstart-code/javascript/Face/sdk_quickstart-single.js" id="snippet_single":::
+    :::code language="js" source="~/cognitive-services-quickstart-code/javascript/Face/Quickstart.js" id="snippet_single":::
 
 1. Run the application with the `node` command on your quickstart file.
 
@@ -76,37 +76,31 @@ Get started with facial recognition using the Face client library for JavaScript
 ```console
 ========IDENTIFY FACES========
 
-Creating a person group with ID: c08484e0-044b-4610-8b7e-c957584e5d2d
+Creating a person group with ID: a230ac8b-09b2-4fa0-ae04-d76356d88d9f
 Adding faces to person group...
-Create a persongroup person: Family1-Dad.
-Create a persongroup person: Family1-Mom.
-Create a persongroup person: Family2-Lady.
-Create a persongroup person: Family1-Son.
-Create a persongroup person: Family1-Daughter.
-Create a persongroup person: Family2-Man.
-Add face to the person group person: (Family1-Son) from image: Family1-Son2.jpg.
-Add face to the person group person: (Family1-Dad) from image: Family1-Dad2.jpg.
-Add face to the person group person: (Family1-Mom) from image: Family1-Mom1.jpg.
-Add face to the person group person: (Family2-Man) from image: Family2-Man1.jpg.
-Add face to the person group person: (Family1-Son) from image: Family1-Son1.jpg.
-Add face to the person group person: (Family2-Lady) from image: Family2-Lady2.jpg.
-Add face to the person group person: (Family1-Mom) from image: Family1-Mom2.jpg.
-Add face to the person group person: (Family1-Dad) from image: Family1-Dad1.jpg.
-Add face to the person group person: (Family2-Man) from image: Family2-Man2.jpg.
-Add face to the person group person: (Family2-Lady) from image: Family2-Lady1.jpg.
+Create a persongroup person: Family1-Dad
+Create a persongroup person: Family1-Mom
+Create a persongroup person: Family1-Son
+Add face to the person group person: (Family1-Dad) from image: (Family1-Dad1.jpg)
+Add face to the person group person: (Family1-Mom) from image: (Family1-Mom1.jpg)
+Add face to the person group person: (Family1-Son) from image: (Family1-Son1.jpg)
+Add face to the person group person: (Family1-Dad) from image: (Family1-Dad2.jpg)
+Add face to the person group person: (Family1-Mom) from image: (Family1-Mom2.jpg)
+Add face to the person group person: (Family1-Son) from image: (Family1-Son2.jpg)
 Done adding faces to person group.
 
-Training person group: c08484e0-044b-4610-8b7e-c957584e5d2d.
-Training status: succeeded.
-No persons identified for face with ID 259dd648-be70-499c-9942-3512594e21eb
-Person: Family1-Mom is identified for face in: identification1.jpg with ID: b7f7f542-c338-4a40-ad52-e61772bc6e14. Confidence: 0.96921.
-Person: Family1-Son is identified for face in: identification1.jpg with ID: 600dc1b4-b2c4-4516-87de-edbbdd8d7632. Confidence: 0.92886.
-Person: Family1-Dad is identified for face in: identification1.jpg with ID: e83b494f-9ad2-473f-9d86-3de79c01e345. Confidence: 0.96725.
-Verification result between face bb7f7f542-c338-4a40-ad52-e61772bc6e14 and person de1d7dea-a393-4f69-9062-10cb66d4cf17: true with confidence: 0.96921
-Verification result between face 600dc1b4-b2c4-4516-87de-edbbdd8d7632 and person 05fd84e4-41b0-4716-b767-4376e33fa207: true with confidence: 0.92886
-Verification result between face e83b494f-9ad2-473f-9d86-3de79c01e345 and person c5124fe2-39dd-47ba-9163-1ed2998fdeb2: true with confidence: 0.96725
+Training person group: a230ac8b-09b2-4fa0-ae04-d76356d88d9f
+Training status: succeeded
+Pausing for 60 seconds to avoid triggering rate limit on free account...
+No persons identified for face with ID 56380623-8bf0-414a-b9d9-c2373386b7be
+Person: Family1-Dad is identified for face in: identification1.jpg with ID: c45052eb-a910-4fd3-b1c3-f91ccccc316a. Confidence: 0.96807
+Person: Family1-Son is identified for face in: identification1.jpg with ID: 8dce9b50-513f-4fe2-9e19-352acfd622b3. Confidence: 0.9281
+Person: Family1-Mom is identified for face in: identification1.jpg with ID: 75868da3-66f6-4b5f-a172-0b619f4d74c1. Confidence: 0.96902
+Verification result between face c45052eb-a910-4fd3-b1c3-f91ccccc316a and person 35a58d14-fd58-4146-9669-82ed664da357: true with confidence: 0.96807
+Verification result between face 8dce9b50-513f-4fe2-9e19-352acfd622b3 and person 2d4d196c-5349-431c-bf0c-f1d7aaa180ba: true with confidence: 0.9281
+Verification result between face 75868da3-66f6-4b5f-a172-0b619f4d74c1 and person 35d5de9e-5f92-4552-8907-0d0aac889c3e: true with confidence: 0.96902
 
-Deleting person group: c08484e0-044b-4610-8b7e-c957584e5d2d
+Deleting person group: a230ac8b-09b2-4fa0-ae04-d76356d88d9f
 
 Done.
 ```
@@ -127,4 +121,4 @@ In this quickstart, you learned how to use the Face client library for JavaScrip
 > [Specify a face detection model version](../../how-to/specify-detection-model.md)
 
 * [What is the Face service?](../../overview-identity.md)
-* More extensive sample code can be found on [GitHub](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/face/ai-vision-face-rest/samples).
+* More extensive sample code can be found on [GitHub](https://aka.ms/FaceSamples).
diff --git a/articles/ai-services/computer-vision/includes/quickstarts-sdk/identity-python-sdk.md b/articles/ai-services/computer-vision/includes/quickstarts-sdk/identity-python-sdk.md
@@ -15,7 +15,7 @@ ms.author: pafarley
 
 Get started with facial recognition using the Face client library for Python. Follow these steps to install the package and try out the example code for basic tasks. The Face service provides you with access to advanced algorithms for detecting and recognizing human faces in images. Follow these steps to install the package and try out the example code for basic face identification using remote images.
 
-[Reference documentation](/python/api/overview/azure/cognitiveservices/face-readme) | [Library source code](https://github.com/Azure/azure-sdk-for-python/tree/master/sdk/cognitiveservices/azure-cognitiveservices-vision-face) | [Package (PiPy)](https://pypi.org/project/azure-cognitiveservices-vision-face/) | [Samples](/samples/browse/?products=azure&term=face)
+[Reference documentation](https://aka.ms/azsdk-python-face-ref) | [Library source code](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/face/azure-ai-vision-face) | [Package (PiPy)](https://aka.ms/azsdk-python-face-pkg) | [Samples](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/face/azure-ai-vision-face/samples)
 
 ## Prerequisites
 
@@ -39,7 +39,7 @@ Get started with facial recognition using the Face client library for Python. Fo
     After installing Python, you can install the client library with:
 
     ```console
-    pip install --upgrade azure-cognitiveservices-vision-face
+    pip install --upgrade azure-ai-vision-face
     ```
 
 1. Create a new Python application
@@ -49,7 +49,7 @@ Get started with facial recognition using the Face client library for Python. Fo
     > [!NOTE]
     > If you haven't received access to the Face service using the [intake form](https://aka.ms/facerecognition), some of these functions won't work.
 
-    [!code-python[](~/cognitive-services-quickstart-code/python/Face/FaceQuickstart-single.py?name=snippet_single)]
+    [!code-python[](~/cognitive-services-quickstart-code/python/Face/Quickstart.py?name=snippet_single)]
 
 
 1. Run your face recognition app from the application directory with the `python` command.
@@ -66,25 +66,28 @@ Get started with facial recognition using the Face client library for Python. Fo
 ## Output
 
 ```console
-Person group: c8e679eb-0b71-43b4-aa91-ab8200cae7df
-face 861d769b-d014-40e8-8b4a-7fd3bc9b425b added to person f80c1cfa-b8cb-46f8-9f7f-e72fbe402bc3
-face e3c356a4-1ac3-4c97-9219-14648997f195 added to person f80c1cfa-b8cb-46f8-9f7f-e72fbe402bc3
-face f9119820-c374-4c4d-b795-96ae2fec5069 added to person be4084a7-0c7b-4cf9-9463-3756d2e28e17
-face 67d626df-3f75-4801-9364-601b63c8296a added to person be4084a7-0c7b-4cf9-9463-3756d2e28e17
-face 19e2e8cc-5029-4087-bca0-9f94588fb850 added to person 3ff07c65-6193-4d3e-bf18-d7c106393cd5
-face dcc61e80-16b1-4241-ae3f-9721597bae4c added to person 3ff07c65-6193-4d3e-bf18-d7c106393cd5
-pg resource is c8e679eb-0b71-43b4-aa91-ab8200cae7df
-<msrest.pipeline.ClientRawResponse object at 0x00000240DAD47310>
-Training status: running.
-
-Training status: succeeded.
-
-Pausing for 10 seconds to avoid triggering rate limit on free account...
+Person group: ad12b2db-d892-48ec-837a-0e7168c18224
+face 335a2cb1-5211-4c29-9c45-776dd014b2af added to person 9ee65510-81a5-47e5-9e50-66727f719465
+face df57eb50-4a13-4f93-b804-cd108327ad5a added to person 9ee65510-81a5-47e5-9e50-66727f719465
+face d8b7b8b8-3ca6-4309-b76e-eeed84f7738a added to person 00651036-4236-4004-88b9-11466c251548
+face dffbb141-f40b-4392-8785-b6c434fa534e added to person 00651036-4236-4004-88b9-11466c251548
+face 9cdac36e-5455-447b-a68d-eb1f5e2ec27d added to person 23614724-b132-407a-aaa0-67003987ce93
+face d8208412-92b7-4b8d-a2f8-3926c839c87e added to person 23614724-b132-407a-aaa0-67003987ce93
+Train the person group ad12b2db-d892-48ec-837a-0e7168c18224
+The person group ad12b2db-d892-48ec-837a-0e7168c18224 is trained successfully.
+Pausing for 60 seconds to avoid triggering rate limit on free account...
 Identifying faces in image
-Person for face ID 40582995-d3a8-41c4-a9d1-d17ae6b46c5c is identified in image, with a confidence of 0.96725.
-Person for face ID 7a0368a2-332c-4e7a-81c4-2db3d74c78c5 is identified in image, with a confidence of 0.96921.
-No person identified for face ID c4a3dd28-ef2d-457e-81d1-a447344242c4 in image.
-Person for face ID 360edf1a-1e8f-402d-aa96-1734d0c21c1c is identified in image, with a confidence of 0.92886.
+Person is identified for face ID bc52405a-5d83-4500-9218-557468ccdf99 in image, with a confidence of 0.96726.
+verification result: True. confidence: 0.96726
+Person is identified for face ID dfcc3fc8-6252-4f3a-8205-71466f39d1a7 in image, with a confidence of 0.96925.
+verification result: True. confidence: 0.96925
+No person identified for face ID 401c581b-a178-45ed-8205-7692f6eede88 in image.
+Person is identified for face ID 8809d9c7-e362-4727-8c95-e1e44f5c2e8a in image, with a confidence of 0.92898.
+verification result: True. confidence: 0.92898
+
+The person group ad12b2db-d892-48ec-837a-0e7168c18224 is deleted.
+
+End of quickstart.
 ```
 
 
@@ -96,10 +99,6 @@ If you want to clean up and remove an Azure AI services subscription, you can de
 * [Portal](../../../multi-service-resource.md?pivots=azportal#clean-up-resources)
 * [Azure CLI](../../../multi-service-resource.md?pivots=azcli#clean-up-resources)
 
-To delete the **PersonGroup** you created in this quickstart, run the following code in your script:
-
-[!code-python[](~/cognitive-services-quickstart-code/python/Face/FaceQuickstart.py?name=snippet_deletegroup)]
-
 ## Next steps
 
 In this quickstart, you learned how to use the Face client library for Python to do basic face identification. Next, learn about the different face detection models and how to specify the right model for your use case.
@@ -108,4 +107,4 @@ In this quickstart, you learned how to use the Face client library for Python to
 > [Specify a face detection model version](../../how-to/specify-detection-model.md)
 
 * [What is the Face service?](../../overview-identity.md)
-* More extensive sample code can be found on [GitHub](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/python/Face/FaceQuickstart.py).
+* More extensive sample code can be found on [GitHub](https://aka.ms/FaceSamples).
