Merge branch 'main' of https://github.com/MicrosoftDocs/azure-ai-docs-pr into openai-updates

Author: PatrickFarley

.openpublishing.redirection.json

@@ -4,6 +4,26 @@
       "source_path_from_root": "/articles/ai-services/openai/concepts/use-your-image-data.md",
       "redirect_url": "/azure/ai-services/openai/concepts/use-your-data",
       "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/search/search-howto-create-indexers.md",
+      "redirect_url": "/azure/search/search-how-to-create-indexers",
+      "redirect_document_id": false
+    },
+    {
+      "source_path_from_root": "/articles/search/search-howto-dotnet-sdk.md",
+      "redirect_url": "/azure/search/search-how-to-dotnet-sdk",
+      "redirect_document_id": false
+    },
+    {
+      "source_path_from_root": "/articles/search/search-howto-index-csv-blobs.md",
+      "redirect_url": "/azure/search/search-how-to-index-csv-blobs",
+      "redirect_document_id": false
+    },
+    {
+      "source_path_from_root": "/articles/search/search-howto-large-index.md",
+      "redirect_url": "/azure/search/search-how-to-large-index",
+      "redirect_document_id": false
     }
   ]
 }

articles/ai-services/computer-vision/concept-background-removal.md

@@ -14,6 +14,8 @@ ms.author: pafarley
 
 # Background removal (version 4.0 preview)
 
+[!INCLUDE [segmentation-deprecation](includes/segmentation-deprecation.md)]
+
 The Background removal operation can divide images into multiple segments or regions to help the user identify different objects or parts of the image. Background removal creates an alpha matte that separates the foreground object from the background in an image. This service is currently in preview, and the API may change in the future.
 
 

articles/ai-services/computer-vision/concept-face-recognition.md

@@ -1,8 +1,7 @@
 ---
 title: "Face recognition - Face"
 titleSuffix: Azure AI services
-description: Learn the concept of Face recognition, its related operations, and the underlying data structures.
-#services: cognitive-services
+description: Learn the concept of Face recognition, its operations, and data structures, including PersonGroup creation, identification, and verification.
 author: PatrickFarley
 manager: nitinme
 
@@ -11,7 +10,7 @@ ms.subservice: azure-ai-face
 ms.custom:
   - ignite-2023
 ms.topic: conceptual
-ms.date: 02/14/2024
+ms.date: 10/16/2024
 ms.author: pafarley
 ---
 
@@ -50,7 +49,7 @@ Use the following tips to ensure that your input images give the most accurate r
 
 [!INCLUDE [identity-input-technical](includes/identity-input-technical.md)]
 [!INCLUDE [identity-input-composition](includes/identity-input-composition.md)]
-* You can utilize the `qualityForRecognition` attribute in the [face detection](./how-to/identity-detect-faces.md) operation when using applicable detection models as a general guideline of whether the image is likely of sufficient quality to attempt face recognition on. Only `"high"` quality images are recommended for person enrollment and quality at or above `"medium"` is recommended for identification scenarios.
+* You can use the `qualityForRecognition` attribute in the [face detection](./how-to/identity-detect-faces.md) operation when using applicable detection models as a general guideline of whether the image is likely of sufficient quality to attempt face recognition on. Only `"high"` quality images are recommended for person enrollment and quality at or above `"medium"` is recommended for identification scenarios.
 
 ## Next steps
 

articles/ai-services/computer-vision/concept-shelf-analysis.md

@@ -8,7 +8,7 @@ manager: nitinme
 
 ms.service: azure-ai-vision
 ms.topic: conceptual
-ms.date: 02/14/2024
+ms.date: 10/16/2024
 ms.author: pafarley
 ms.custom: build-2023, build-2023-dataai
 ---

articles/ai-services/computer-vision/how-to/background-removal.md

@@ -13,6 +13,8 @@ ms.date: 01/19/2024
 
 # Remove the background in images
 
+[!INCLUDE [segmentation-deprecation](../includes/segmentation-deprecation.md)]
+
 This article demonstrates how to call the Image Analysis 4.0 API to segment an image (separate the foreground from background). It also shows you how to parse the returned information.
 
 > [!IMPORTANT]

articles/ai-services/computer-vision/how-to/call-read-api.md

@@ -20,17 +20,6 @@ The following steps assume that you've already created a [Computer Vision resour
 
 [!INCLUDE [read-editions](../includes/read-editions.md)]
 
-## Input requirements
-
-The **Read** API call takes images and documents as its input. The images and documents must meet the following requirements:
-
-* Supported file formats are JPEG, PNG, BMP, PDF, and TIFF.
-* For PDF and TIFF files, up to 2,000 pages (only the first two pages for the free tier) are processed.
-* The file size of images must be less than 500 MB (4 MB for the free tier) with dimensions at least 50 x 50 pixels and at most 10,000 x 10,000 pixels. PDF files don't have a size limit.
-* The minimum height of the text to be extracted is 12 pixels for a 1024 x 768 image, which corresponds to about 8-point font text at 150 DPI.
-
->[!NOTE]
-> You don't need to crop an image for text lines. Send the whole image to the Read API and it recognizes all texts.
 
 ## Determine how to process the data (optional)
 

articles/ai-services/computer-vision/how-to/identity-access-token.md

@@ -19,7 +19,10 @@ Independent software vendors (ISVs) can manage the Face API usage of their clien
 
 This guide shows you how to generate the access tokens, if you're an approved ISV, and how to use the tokens if you're a client. 
 
-The limited access token feature is a part of the existing Azure AI Services token service. We have added a new operation for the purpose of bypassing the Limited Access gate for approved scenarios. Only ISVs that pass the gating requirements will be given access to this feature.
+The limited access token feature is a part of the existing Azure AI Services token service. We have added a new operation for the purpose of bypassing the Limited Access gate for approved scenarios. 
+
+> [!IMPORTANT]
+> Only ISVs that pass the gating requirements will be given access to this feature. To request approval, contact [[email protected]](mailto:[email protected]).
 
 ## Example use case
 
@@ -57,18 +60,18 @@ To call the **issueLimitedAccessToken** API, copy the following cURL command to
 
 ```bash
 curl -X POST 'https://<isv-endpoint>/sts/v1.0/issueLimitedAccessToken?expiredTime=3600' \  
--H 'Ocp-Apim-Subscription-Key: <client-face-key>' \  
+-H 'Ocp-Apim-Subscription-Key: <isv-face-key>' \  
 -H 'Content-Type: application/json' \  
 -d '{  
-    "resourceId": "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.CognitiveServices/accounts/<face-resource-name>",  
+    "targetAzureResourceId": "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.CognitiveServices/accounts/<face-resource-name>",  
     "featureFlags": ["Face.Identification", "Face.Verification"]  
 }' 
 ```
 
 Then, make the following changes:
 1. Replace `<isv-endpoint>` with the endpoint of the ISV's resource. For example, **westus.api.cognitive.microsoft.com**.
 1. Optionally set the `expiredTime` parameter to set the expiration time of the token in seconds. It must be between 60 and 86400. The default value is 3600 (one hour).
-1. Replace `<client-face-key>` with the key of the client's Face resource.
+1. Replace `<isv-face-key>` with the key of the ISV's Face resource.
 1. Replace `<subscription-id>` with the subscription ID of the client's Azure subscription.
 1. Replace `<resource-group-name>` with the name of the client's resource group.
 1. Replace `<face-resource-name>` with the name of the client's Face resource.

articles/ai-services/computer-vision/how-to/image-retrieval.md

@@ -1,15 +1,17 @@
 ---
-title: Do image retrieval using multimodal embeddings - Image Analysis 4.0
+title: Image retrieval using multimodal embeddings
 titleSuffix: Azure AI services
-description: Learn how to call the image retrieval API to vectorize image and search terms.
+description: Learn how to use the image retrieval API to vectorize images and search terms, enabling text-based image searches without metadata.
 #services: cognitive-services
 author: PatrickFarley
 manager: nitinme
 
 ms.service: azure-ai-vision
 ms.topic: how-to
-ms.date: 02/20/2024
+ms.date: 10/16/2024
 ms.author: pafarley
+
+#customer intent: As a developer, I want to use the image retrieval API to vectorize images and text so that I can perform text-based image searches.
 ---
 
 # Do image retrieval using multimodal embeddings (version 4.0)
@@ -35,7 +37,7 @@ You can try out the Multimodal embeddings feature quickly and easily in your bro
 > The Vision Studio experience is limited to 500 images. To use a larger image set, create your own search application using the APIs in this guide.
 
 > [!div class="nextstepaction"]
-> [Try Vision Studio](https://portal.vision.cognitive.azure.com/)
+> [Try Vision Studio](https://portal.vision.cognitive.azure.com/gallery/imageanalysis)
 
 ## Call the Vectorize Image API
 
@@ -124,6 +126,7 @@ def cosine_similarity(vector1, vector2):
 
 ---
 
-## Next steps
+## Next step
 
-[Image retrieval concepts](../concept-image-retrieval.md)
+> [!div class="nextstepaction"]
+> [Image retrieval concepts](../concept-image-retrieval.md)

articles/ai-services/computer-vision/how-to/specify-detection-model.md

@@ -143,10 +143,10 @@ This code creates a **FaceList** called `My face collection` and adds a Face to
 
 In this article, you learned how to specify the detection model to use with different Face APIs. Next, follow a quickstart to get started with face detection and analysis.
 
-* [Face .NET SDK](../quickstarts-sdk/identity-client-library.md?pivots=programming-language-csharp%253fpivots%253dprogramming-language-csharp)
-* [Face Python SDK](../quickstarts-sdk/identity-client-library.md?pivots=programming-language-python%253fpivots%253dprogramming-language-python)
-* [Face Java SDK](../quickstarts-sdk/identity-client-library.md?pivots=programming-language-java%253fpivots%253dprogramming-language-java)
-* [Face JavaScript SDK](../quickstarts-sdk/identity-client-library.md?pivots=programming-language-javascript%253fpivots%253dprogramming-language-javascript)
+* [Face .NET SDK](../quickstarts-sdk/identity-client-library.md?pivots=programming-language-csharp)
+* [Face Python SDK](../quickstarts-sdk/identity-client-library.md?pivots=programming-language-python)
+* [Face Java SDK](../quickstarts-sdk/identity-client-library.md?pivots=programming-language-java)
+* [Face JavaScript SDK](../quickstarts-sdk/identity-client-library.md?pivots=programming-language-javascript)
 
 [Detect]: /rest/api/face/face-detection-operations/detect
 [Identify From Person Group]: /rest/api/face/face-recognition-operations/identify-from-person-group

articles/ai-services/computer-vision/how-to/specify-recognition-model.md

@@ -130,10 +130,10 @@ If you normally specify a confidence threshold (a value between zero and one tha
 
 In this article, you learned how to specify the recognition model to use with different Face service APIs. Next, follow a quickstart to get started with face detection.
 
-* [Face .NET SDK](../quickstarts-sdk/identity-client-library.md?pivots=programming-language-csharp%253fpivots%253dprogramming-language-csharp)
-* [Face Python SDK](../quickstarts-sdk/identity-client-library.md?pivots=programming-language-python%253fpivots%253dprogramming-language-python)
-* [Face Java SDK](../quickstarts-sdk/identity-client-library.md?pivots=programming-language-java%253fpivots%253dprogramming-language-java)
-* [Face JavaScript SDK](../quickstarts-sdk/identity-client-library.md?pivots=programming-language-javascript%253fpivots%253dprogramming-language-javascript)
+* [Face .NET SDK](../quickstarts-sdk/identity-client-library.md?pivots=programming-language-csharp)
+* [Face Python SDK](../quickstarts-sdk/identity-client-library.md?pivots=programming-language-python)
+* [Face Java SDK](../quickstarts-sdk/identity-client-library.md?pivots=programming-language-java)
+* [Face JavaScript SDK](../quickstarts-sdk/identity-client-library.md?pivots=programming-language-javascript)
 
 [Detect]: /rest/api/face/face-detection-operations/detect
 [Verify Face To Face]: /rest/api/face/face-recognition-operations/verify-face-to-face