AI articles review

maud-lv · maud-lv · commit 032c64dc5bda · 2025-01-30T15:57:33.000+01:00
diff --git a/articles/service-connector/how-to-integrate-ai-services.md b/articles/service-connector/how-to-integrate-ai-services.md
@@ -1,5 +1,6 @@
 ---
-title: Integrate Azure AI services with service connector
+title: Connect Azure AI services with other Azure services
+titleSuffix: Service Connector
 description: In this document, learn how to integrate Azure AI Services into your application with Service Connector
 author: wchigit
 ms.author: wchi
@@ -9,7 +10,7 @@ ms.date: 01/29/2024
 ms.collection: ce-skilling-ai-copilot
 ---
 
-# Integrate Azure AI services with Service Connector
+# Connect to Azure AI services using Service Connector
 
 This page provides information on supported authentication methods and clients, along with sample code for connecting Azure AI services to other cloud services using Service Connector. This page also lists default environment variable names and values obtained when creating the service connection. 
 
@@ -25,7 +26,7 @@ Service Connector can be used to connect the following compute services to Azure
 
 ## Supported authentication types and client types
 
-The table below indicates which combinations of authentication methods and clients are supported for connecting your compute service to Azure AI Services using Service Connector. A “Yes” indicates that the combination is supported, while a “No” indicates that it is not supported.
+The table below indicates which combinations of authentication methods and clients are supported for connecting your compute service to individual Azure AI Services using Service Connector. A “Yes” indicates that the combination is supported, while a “No” indicates that it is not supported.
 
 
 | Client type | System-assigned managed identity | User-assigned managed identity | Secret/connection string | Service principal |
@@ -99,7 +100,7 @@ Refer to the steps and code below to connect to Azure AI Services using a servic
 
 ## Related content
 
-* [Azure AI multi-service resource integration](./how-to-integrate-cognitive-services.md)
+* [Connect to an Azure AI multi-service resource](./how-to-integrate-cognitive-services.md)
 * [Azure OpenAI Service integration](./how-to-integrate-openai.md)
 * [Connect to Azure OpenAI Service in AKS using a Workload Identity](./tutorial-python-aks-openai-workload-identity.md)
 * [Learn about Service Connector concepts](./concept-service-connector-internals.md)
diff --git a/articles/service-connector/how-to-integrate-cognitive-services.md b/articles/service-connector/how-to-integrate-cognitive-services.md
@@ -1,5 +1,6 @@
 ---
-title: Integrate an Azure AI multi-service resource with service connector
+title: Connect Azure AI multi-service resource with Azure services
+titleSuffix: Service Connector
 description: In this document, learn how to integrate an Azure AI multi-service resource into your application with Service Connector
 author: wchigit
 ms.author: wchi
@@ -9,7 +10,7 @@ ms.date: 01/29/2025
 ms.collection: ce-skilling-ai-copilot
 ---
 
-# Integrate an Azure AI multi-service resource with Service Connector
+# Connect to an Azure AI multi-service resource with Service Connector
 
 This page provides information on supported authentication methods and clients, along with sample code for connecting an Azure AI multi-service resource to other cloud services using Service Connector. This page also lists default environment variable names and values obtained when creating the service connection. 
 
@@ -25,7 +26,7 @@ Service Connector can be used to connect the following compute services to an Az
 
 ## Supported authentication types and client types
 
-The table below indicates which combinations of authentication methods and clients are supported for connecting your compute service to an Azure AI multi-service resource using Service Connector. A “Yes” indicates that the combination is supported, while a “No” indicates that it is not supported.
+The table below indicates the authentication methods and clients supported for connecting your compute service to an Azure AI multi-service resource using Service Connector. A “Yes” indicates that the combination is supported, while a “No” indicates that it is not supported.
 
 
 | Client type | System-assigned managed identity | User-assigned managed identity | Secret/connection string | Service principal |
@@ -49,7 +50,9 @@ Use the connection details below to connect compute services to an Azure AI mult
 | AZURE_COGNITIVESERVICES_ENDPOINT | Azure Cognitive Services token provider service |  `https://<cognitive-service-name>.cognitiveservices.azure.com/` |
 
 #### Sample code
+
 Refer to the steps and code below to connect to an Azure AI multi-service resource using a system-assigned managed identity.
+
 [!INCLUDE [code sample for an Azure AI multi-service resource](./includes/code-cognitive-microsoft-entra-id.md)]
 
 ### User-assigned managed identity
@@ -60,6 +63,7 @@ Refer to the steps and code below to connect to an Azure AI multi-service resour
 | AZURE_COGNITIVESERVICES_CLIENTID   | Your client ID             | `<client-ID>`                                 |
 
 #### Sample code
+
 Refer to the steps and code below to connect to an Azure AI multi-service resource using a user-assigned managed identity.
 [!INCLUDE [code sample for an Azure AI multi-service resource](./includes/code-cognitive-microsoft-entra-id.md)]
 
@@ -71,7 +75,8 @@ Refer to the steps and code below to connect to an Azure AI multi-service resour
 > | AZURE_COGNITIVESERVICES_ENDPOINT | Azure Cognitive Services token provider service |  `https://<cognitive-service-name>.cognitiveservices.azure.com/` |
 > | AZURE_COGNITIVESERVICES_KEY | API key of an Azure AI multi-service resource | `<api-key>` |
 
-#### Sample Code 
+#### Sample code
+
 Refer to the steps and code below to connect to an Azure AI multi-service resource using a connection string.
 [!INCLUDE [code sample for an Azure AI multi-service resource](./includes/code-cognitive-secret.md)]
 
@@ -86,11 +91,13 @@ Refer to the steps and code below to connect to an Azure AI multi-service resour
 | AZURE_COGNITIVESERVICES_TENANTID     | Your tenant ID             | `<tenant-ID>`                                |
 
 #### Sample code
+
 Refer to the steps and code below to connect to an Azure AI multi-service resource using a service principaL.
+
 [!INCLUDE [code sample for an Azure AI multi-service resource](./includes/code-cognitive-microsoft-entra-id.md)]
 
 ## Related content
 
-* [Integrate Azure AI services with Service Connector](./how-to-integrate-ai-services.md)
-* [Integrate Azure OpenAI Service with Service Connector](./how-to-integrate-openai.md)
+* [Connect to Azure AI services](./how-to-integrate-ai-services.md)
+* [Connect to Azure OpenAI Service](./how-to-integrate-openai.md)
 * [Connect to Azure OpenAI Service in AKS using Workload Identity](./tutorial-python-aks-openai-workload-identity.md)
diff --git a/articles/service-connector/how-to-integrate-openai.md b/articles/service-connector/how-to-integrate-openai.md
@@ -1,17 +1,18 @@
 ---
-title: Integrate Azure OpenAI Service with service connector
+title: Connect Azure OpenAI Service to other Azure services
+titleSuffix: Service Connector
 description: In this document, learn how to integrate Azure OpenAI Service into your application with Service Connector
 author: wchigit
 ms.author: wchi
 ms.service: service-connector
 ms.topic: how-to
-ms.date: 06/14/2024
+ms.date: 01/29/2025
 ms.collection: ce-skilling-ai-copilot
 ---
 
-# Integrate Azure OpenAI Service with Service Connector
+# Connect to Azure OpenAI Service using Service Connector
 
-This page shows supported authentication methods and clients, and shows sample code you can use to connect Azure OpenAI Service to other cloud services using Service Connector. You might still be able to connect to Azure OpenAI Service using other methods. This page also shows default environment variable names and values you get when you create the service connection. 
+This page provides information about supported authentication methods and clients, along with sample code for connecting Azure OpenAI Service to other cloud services using Service Connector. This page also lists default environment variable names and values obtained when creating service connections.
 
 ## Supported compute services
 
@@ -22,6 +23,7 @@ Service Connector can be used to connect the following compute services to Azure
 - Azure Functions
 - Azure Kubernetes Service (AKS)
 - Azure Spring Apps
+
 ## Supported authentication types and client types
 
 The table below shows which combinations of authentication methods and clients are supported for connecting your compute service to Azure OpenAI Service using Service Connector. A “Yes” indicates that the combination is supported, while a “No” indicates that it is not supported.
@@ -39,7 +41,7 @@ This table indicates that all combinations of client types and authentication me
 
 ## Default environment variable names or application properties and sample code
 
-Use the connection details below to connect compute services to Azure OpenAI Service. For more information about naming conventions, check the [Service Connector internals](concept-service-connector-internals.md#configuration-naming-convention) article.
+Use the connection details below to connect compute services to Azure OpenAI Service. For more information about naming conventions, refer to [Service Connector internals](concept-service-connector-internals.md#configuration-naming-convention) article.
 
 ### System-assigned managed identity
 
@@ -59,6 +61,7 @@ Refer to the steps and code below to connect to Azure OpenAI Service using a sys
 | AZURE_OPENAI_CLIENTID   | Your client ID             | `<client-ID>`                                 |
 
 #### Sample code
+
 Refer to the steps and code below to connect to Azure OpenAI Service using a user-assigned managed identity.
 [!INCLUDE [code sample for azure openai service](./includes/code-openai-microsoft-entra-id.md)]
 
@@ -71,6 +74,7 @@ Refer to the steps and code below to connect to Azure OpenAI Service using a use
 > | AZURE_OPENAI_KEY | Azure OpenAI Service API key | `<api-key>` |
 
 #### Sample Code 
+
 Refer to the steps and code below to connect to Azure OpenAI Service using a connection string.
 [!INCLUDE [code sample for azure openai service](./includes/code-openai-secret.md)]
 
@@ -88,9 +92,8 @@ Refer to the steps and code below to connect to Azure OpenAI Service using a con
 Refer to the steps and code below to connect to Azure OpenAI Service using a service principaL.
 [!INCLUDE [code sample for azure openai service](./includes/code-openai-microsoft-entra-id.md)]
 
-## Next steps
-
-Follow the tutorial listed below to learn more about Service Connector.
+# Related content
 
-> [!div class="nextstepaction"]
-> [Learn about Service Connector concepts](./concept-service-connector-internals.md)
+* [Connect to Azure OpenAI Service in AKS using Workload Identity](./tutorial-python-aks-openai-workload-identity.md)
+* [Connect to an Azure AI multi-service resource](./how-to-integrate-cognitive-services.md)
+* [Connect to Azure AI services](./how-to-integrate-ai-services.md)
diff --git a/articles/service-connector/tutorial-python-aks-openai-connection-string.md b/articles/service-connector/tutorial-python-aks-openai-connection-string.md
@@ -12,7 +12,7 @@ ms.topic: tutorial
 ms.date: 01/29/2025
 ---
 
-# Tutorial: Connect to Azure OpenAI Service in AKS using a connection string (preview)
+# Tutorial: Connect to Azure OpenAI Service in AKS using a connection string
 
 In this tutorial, you learn how to create a pod in an Azure Kubernetes (AKS) cluster that communicates with Azure OpenAI Service using a connection string. You complete the following tasks:
 
@@ -109,7 +109,7 @@ In this tutorial, you learn how to create a pod in an Azure Kubernetes (AKS) clu
         --anonymous-pull-enabled
     ```
 
-## Create a service connection in AKS with Service Connector (preview)
+## Create a service connection in AKS with Service Connector
 
 Create a service connection between an AKS cluster and Azure OpenAI Service in the Azure portal or the Azure CLI.
 
@@ -217,6 +217,6 @@ az group delete \
 
 ## Related content
 
+* [Connect to Azure OpenAI Service](./how-to-integrate-openai.md)
 * [Connect to Azure OpenAI Service in AKS using Workload Identity](./tutorial-python-aks-openai-workload-identity.md)
-* [Integrate Azure OpenAI Service with Service Connector](./how-to-integrate-openai.md)
-* [Azure AI multi-service resource integration](./how-to-integrate-cognitive-services.md)
+* [Connect to an Azure AI multi-service resource](./how-to-integrate-cognitive-services.md)
diff --git a/articles/service-connector/tutorial-python-aks-openai-workload-identity.md b/articles/service-connector/tutorial-python-aks-openai-workload-identity.md
@@ -1,5 +1,5 @@
 ---
-title: Connect to Azure OpenAI in AKS using workload identity.
+title: Connect to Azure OpenAI Service in AKS using workload identity
 titlesuffix: Service Connector
 description: Learn how to connect to Azure OpenAI Service in Azure Kubernetes Service (AKS) using workload identity and Service Connector.
 #customerintent: As a developer, I want to connect my AKS resource to Azure OpenAI Service using a workload identity.
@@ -12,7 +12,7 @@ ms.topic: tutorial
 ms.date: 01/28/2025
 ---
 
-# Tutorial: Connect to Azure OpenAI Service in AKS using Workload Identity (preview)
+# Tutorial: Connect to Azure OpenAI Service in AKS using Workload Identity
 
 In this tutorial, you learn how to create a pod in an Azure Kubernetes (AKS) cluster that communicates with Azure OpenAI Service using workload identity and Service Connector. In this tutorial, you complete the following tasks:
 
@@ -117,7 +117,7 @@ You start this tutorial by creating several Azure resources.
         --name MyIdentity
     ```
 
-## Create a service connection in AKS with Service Connector (preview)
+## Create a service connection in AKS with Service Connector
 
 Create a service connection between an AKS cluster and Azure OpenAI Service in the Azure portal or the Azure CLI.
 
@@ -230,6 +230,6 @@ az group delete \
 
 ## Related content
 
-* [Integrate Azure AI services with Service Connector](./how-to-integrate-ai-services.md)
-* [Integrate Azure OpenAI Service with Service Connector](./how-to-integrate-openai.md)
+* [Connect to Azure AI services](./how-to-integrate-ai-services.md)
+* [Connect to Azure OpenAI Service with Service Connector](./how-to-integrate-openai.md)
 * [Azure AI multi-service resource integration](./how-to-integrate-cognitive-services.md)
