Merge pull request #281916 from gmndrg/main

Supportability updates based on customer cases

Author: prmerger-automator[bot]

articles/search/cognitive-search-debug-session.md

@@ -10,7 +10,7 @@ ms.service: cognitive-search
 ms.custom:
   - ignite-2023
 ms.topic: conceptual
-ms.date: 07/21/2024
+ms.date: 07/24/2024
 ---
 
 # Debug Sessions in Azure AI Search
@@ -74,6 +74,10 @@ Expression Evaluator gives you full interactive access for testing skill context
 
 :::image type="content" source="media/cognitive-search-debug/expression-evaluator.png" alt-text="Screenshot of Expression Evaluator.":::
 
+## Limitations
+
+Debug sessions feature doesn't support [SharePoint Online indexer](search-howto-index-sharepoint-online.md).
+
 ## Next steps
 
 Now that you understand the elements of debug sessions, start your first debug session on an existing skillset.

articles/search/search-howto-index-plaintext-blobs.md

@@ -10,7 +10,7 @@ ms.service: cognitive-search
 ms.custom:
   - ignite-2023
 ms.topic: how-to
-ms.date: 01/18/2024
+ms.date: 07/25/2024
 ---
 
 # Index plain text blobs and files in Azure AI Search
@@ -48,12 +48,12 @@ api-key: [admin key]
 }
 ```
 
-By default, the `UTF-8` encoding is assumed. To specify a different encoding, use the `encoding` configuration property: 
+By default, the `UTF-8` encoding is assumed. To specify a different encoding, use the `encoding` configuration property. The supported [list of encodings](/dotnet/fundamentals/runtime-libraries/system-text-encoding#list-of-encodings) is under **.NET 5 and later support** column.
 
 ```http
 {
   ... other parts of indexer definition
-  "parameters" : { "configuration" : { "parsingMode" : "text", "encoding" : "windows-1252" } }
+  "parameters" : { "configuration" : { "parsingMode" : "text", "encoding" : "iso-8859-1" } }
 }
 ```
 

articles/search/search-howto-managed-identities-data-sources.md

@@ -11,7 +11,7 @@ ms.custom:
   - ignite-2023
   - build-2024
 ms.topic: how-to
-ms.date: 07/02/2024
+ms.date: 07/25/2024
 ---
 
 # Configure a search service to connect using a managed identity in Azure AI Search
@@ -200,6 +200,7 @@ You can use a preview Management REST API instead of the portal to assign a user
    + "type" is the type of identity. Valid values are "SystemAssigned", "UserAssigned", or "SystemAssigned, UserAssigned" for both. A value of "None" clears any previously assigned identities from the search service.
 
    + "userAssignedIdentities" includes the details of the user assigned managed identity. This identity [must already exist](../active-directory/managed-identities-azure-resources/how-manage-user-assigned-managed-identities.md) before you can specify it in the Update Service request.
+  
 
 ---
 
@@ -313,6 +314,7 @@ A custom skill targets the endpoint of an Azure function or app hosting custom c
 
  An Azure OpenAI embedding skill and vectorizer in AI Search target the endpoint of an Azure OpenAI service hosting an embedding model. The endpoint is specified in the [Azure OpenAI embedding skill definition](cognitive-search-skill-azure-openai-embedding.md) and/or in the [Azure OpenAI vectorizer definition](vector-search-how-to-configure-vectorizer.md). The system-managed identity is used if configured and if the "apikey" and "authIdentity" are empty. The "authIdentity" property is used for user-assigned managed identity only.
 
+**System-managed identity example:**
 
 ```json
 {
@@ -349,6 +351,51 @@ A custom skill targets the endpoint of an Azure function or app hosting custom c
   ]
 ```
 
+**User-assigned managed identity example:**
+
+```json
+{
+  "@odata.type": "#Microsoft.Skills.Text.AzureOpenAIEmbeddingSkill",
+  "description": "Connects a deployed embedding model.",
+  "resourceUri": "https://url.openai.azure.com/",
+  "deploymentId": "text-embedding-ada-002",
+  "modelName": "text-embedding-ada-002",
+  "inputs": [
+    {
+      "name": "text",
+      "source": "/document/content"
+    }
+  ],
+  "outputs": [
+    {
+      "name": "embedding"
+    }
+  ],
+  "authIdentity": {
+    "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
+    "userAssignedIdentity": "/subscriptions/<subscription_id>/resourcegroups/<resource_group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<user-assigned-managed-identity-name>"
+   }
+}
+```
+
+```json
+ "vectorizers": [
+    {
+      "name": "my_azure_open_ai_vectorizer",
+      "kind": "azureOpenAI",
+      "azureOpenAIParameters": {
+        "resourceUri": "https://url.openai.azure.com",
+        "deploymentId": "text-embedding-ada-002",
+        "modelName": "text-embedding-ada-002"
+        "authIdentity": {
+            "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
+            "userAssignedIdentity": "/subscriptions/<subscription_id>/resourcegroups/<resource_group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<user-assigned-managed-identity-name>"
+          }
+      }
+    }
+  ]
+```
+
 ## Check for firewall access
 
 If your Azure resource is behind a firewall, make sure there's an inbound rule that admits requests from your search service.