AI articles review

maud-lv · maud-lv · commit 6d761b2a0f05 · 2025-01-30T11:42:52.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
@@ -5,13 +5,13 @@ author: wchigit
 ms.author: wchi
 ms.service: service-connector
 ms.topic: how-to
-ms.date: 06/14/2024
+ms.date: 01/29/2024
 ms.collection: ce-skilling-ai-copilot
 ---
 
 # Integrate Azure AI services with Service Connector
 
-This page shows supported authentication methods and clients, and shows sample code you can use to connect Azure AI Services to other cloud services using Service Connector. You might still be able to connect to Azure AI Services 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 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. 
 
 ## Supported compute services
 
@@ -25,7 +25,7 @@ Service Connector can be used to connect the following compute services to Azure
 
 ## 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 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 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 |
@@ -40,9 +40,9 @@ 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 AI Services. 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 AI Services. For more information about naming conventions, refer to the [Service Connector internals](concept-service-connector-internals.md#configuration-naming-convention) article.
 
-### System-assigned managed identity
+### System-assigned managed identity (recommended)
 
 | Default environment variable name | Description                  | Sample value                                     |
 | --------------------------------- | ---------------------------- | ------------------------------------------------ |
@@ -97,9 +97,9 @@ Refer to the steps and code below to connect to Azure AI Services using a connec
 Refer to the steps and code below to connect to Azure AI Services using a service principaL.
 [!INCLUDE [code sample for azure AI Services](./includes/code-ai-services-microsoft-entra-id.md)]
 
-## Next steps
+## Related content
 
-Follow the tutorial listed below to learn more about Service Connector.
-
-> [!div class="nextstepaction"]
-> [Learn about Service Connector concepts](./concept-service-connector-internals.md)
+* [Azure AI multi-service resource integration](./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
@@ -5,13 +5,13 @@ 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 an Azure AI multi-service resource with Service Connector
 
-This page shows supported authentication methods and clients, and shows sample code you can use to connect an Azure AI multi-service resource to other cloud services using Service Connector. You might still be able to connect to an Azure AI multi-service resource 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 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. 
 
 ## Supported compute services
 
@@ -25,7 +25,7 @@ Service Connector can be used to connect the following compute services to an Az
 
 ## 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 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 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.
 
 
 | Client type | System-assigned managed identity | User-assigned managed identity | Secret/connection string | Service principal |
@@ -40,7 +40,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 an Azure AI multi-service resource. 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 an Azure AI multi-service resource. For more information about naming conventions, refer to the [Service Connector internals](concept-service-connector-internals.md#configuration-naming-convention) article.
 
 ### System-assigned managed identity
 
@@ -89,9 +89,8 @@ Refer to the steps and code below to connect to an Azure AI multi-service resour
 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)]
 
-## Next steps
+## Related content
 
-Follow the tutorial listed below to learn more about Service Connector.
-
-> [!div class="nextstepaction"]
-> [Learn about Service Connector concepts](./concept-service-connector-internals.md)
+* [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 OpenAI Service in AKS using Workload Identity](./tutorial-python-aks-openai-workload-identity.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
@@ -9,12 +9,12 @@ ms.service: service-connector
 ms.custom: devx-track-python, build-2024, devx-track-azurecli
 ms.collection: ce-skilling-ai-copilot
 ms.topic: tutorial
-ms.date: 05/07/2024
+ms.date: 01/29/2025
 ---
 
 # Tutorial: Connect to Azure OpenAI Service in AKS using a connection string (preview)
 
-In this tutorial, you learn how to create a pod in an Azure Kubernetes (AKS) cluster, which talks to Azure OpenAI Service using a connection string. You complete the following tasks:
+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:
 
 > [!div class="checklist"]
 >
@@ -140,14 +140,13 @@ Once the connection has been created, you can view its details in the **Service
 
 Use the Azure CLI command to create a service connection to the Azure OpenAI service, providing the following information:
 
-* **Source compute service resource group name:** the resource group name of the AKS cluster.
-* **AKS cluster name:** the name of your AKS cluster that connects to the target service.
-* **Target service resource group name:** the resource group name of the Azure OpenAI service.
+* **Source compute service resource group name:** the name of the resource group containing the AKS cluster.
+* **AKS cluster name:** the name of the AKS cluster that connects to the target service.
+* **Target service resource group name:** the name of the resource group containing the Azure OpenAI service.
 * **OpenAI service name:** the Azure OpenAI service that is connected.
 
 ```azurecli
 az aks connection create cognitiveservices --secret
-
 ```
 
 ---
@@ -216,12 +215,8 @@ az group delete \
     --resource-group MyResourceGroup
 ```
 
-## Next steps
-
-Read the following articles to learn more about Service Connector concepts and how it helps AKS connect to Azure services.
-
-> [!div class="nextstepaction"]
-> [Learn about Service Connector concepts](./concept-service-connector-internals.md)
+## Related content
 
-> [!div class="nextstepaction"]
-> [Use Service Connector to connect an AKS cluster to other cloud services](./how-to-use-service-connector-in-aks.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)
diff --git a/articles/service-connector/tutorial-python-aks-openai-workload-identity.md b/articles/service-connector/tutorial-python-aks-openai-workload-identity.md
@@ -9,12 +9,12 @@ ms.service: service-connector
 ms.custom: devx-track-python, build-2024, devx-track-azurecli
 ms.collection: ce-skilling-ai-copilot
 ms.topic: tutorial
-ms.date: 05/07/2024
+ms.date: 01/28/2025
 ---
 
 # Tutorial: Connect to Azure OpenAI Service in AKS using Workload Identity (preview)
 
-In this tutorial, you learn how to create a pod in an Azure Kubernetes (AKS) cluster, which talks to Azure OpenAI Service using workload identity and Service Connector. In this tutorial, you complete the following tasks:
+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:
 
 > [!div class="checklist"]
 >
@@ -150,9 +150,9 @@ Once the connection has been created, you can view its details in the **Service
 
 Use the Azure CLI command to create a service connection to the Azure OpenAI service, providing the following information:
 
-* **Source compute service resource group name:** the resource group name of the AKS cluster.
-* **AKS cluster name:** the name of your AKS cluster that connects to the target service.
-* **Target service resource group name:** the resource group name of the Azure OpenAI service.
+* **Source compute service resource group name:** the name of the resource group containing the AKS cluster.
+* **AKS cluster name:** the name of the AKS cluster that connects to the target service.
+* **Target service resource group name:** the name of the resource group containing the Azure OpenAI service.
 * **OpenAI service name:** the Azure OpenAI service that is connected.
 * **User-assigned identity resource ID:** the resource ID of the user-assigned identity used to create the workload identity.
 
@@ -228,12 +228,8 @@ az group delete \
     --resource-group MyResourceGroup
 ```
 
-## Next steps
+## Related content
 
-Read the following articles to learn more about Service Connector concepts and how it helps AKS connect to services.
-
-> [!div class="nextstepaction"]
-> [Learn about Service Connector concepts](./concept-service-connector-internals.md)
-
-> [!div class="nextstepaction"]
-> [Use Service Connector to connect an AKS cluster to other cloud services](./how-to-use-service-connector-in-aks.md)
+* [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)
+* [Azure AI multi-service resource integration](./how-to-integrate-cognitive-services.md)
