Merge pull request #293816 from maud-lv/ml-scaidocs

denrea · web-flow · commit 2a886c9b55dc · 2025-01-30T10:09:32.000-08:00
AI articles review
diff --git a/articles/service-connector/how-to-integrate-ai-services.md b/articles/service-connector/how-to-integrate-ai-services.md
@@ -1,17 +1,18 @@
 ---
-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
 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
+# Connect to Azure AI services using 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 +26,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 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 |
@@ -40,9 +41,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                                     |
 | --------------------------------- | ---------------------------- | ------------------------------------------------ |
@@ -51,6 +52,7 @@ Use the connection details below to connect compute services to Azure AI Service
 | AZURE_AISERVICES_SPEECH_ENDPOINT | Speech to Text (Standard) API endpoint | `https://<location>.stt.speech.microsoft.com` |
 
 #### Sample code
+
 Refer to the steps and code below to connect to Azure AI Services using a system-assigned managed identity.
 [!INCLUDE [code sample for app config](./includes/code-ai-services-microsoft-entra-id.md)]
 
@@ -64,6 +66,7 @@ Refer to the steps and code below to connect to Azure AI Services using a system
 | AZURE_AISERVICES_CLIENTID   | Your client ID             | `<client-ID>`                                 |
 
 #### Sample code
+
 Refer to the steps and code below to connect to Azure AI Services using a user-assigned managed identity.
 [!INCLUDE [code sample for azure AI Services](./includes/code-ai-services-microsoft-entra-id.md)]
 
@@ -77,7 +80,8 @@ Refer to the steps and code below to connect to Azure AI Services using a user-a
 > | AZURE_AISERVICES_SPEECH_ENDPOINT | Speech to Text (Standard) API endpoint | `https://<location>.stt.speech.microsoft.com` |
 > | AZURE_AISERVICES_KEY | Azure AI Services API key | `<api-key>` |
 
-#### Sample Code 
+#### Sample code
+
 Refer to the steps and code below to connect to Azure AI Services using a connection string.
 [!INCLUDE [code sample for azure AI Services](./includes/code-ai-services-secret.md)]
 
@@ -94,12 +98,12 @@ Refer to the steps and code below to connect to Azure AI Services using a connec
 | AZURE_AISERVICES_TENANTID     | Your tenant ID             | `<tenant-ID>`                                |
 
 #### Sample code
+
 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
-
-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 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)
diff --git a/articles/service-connector/how-to-integrate-cognitive-services.md b/articles/service-connector/how-to-integrate-cognitive-services.md
@@ -1,17 +1,18 @@
 ---
-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
 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
+# Connect to 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 +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 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 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 |
@@ -40,16 +41,18 @@ 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
+### System-assigned managed identity (recommended)
 
 | Default environment variable name | Description                  | Sample value                                     |
 | --------------------------------- | ---------------------------- | ------------------------------------------------ |
 | 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,12 +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)]
 
-## Next steps
+[!INCLUDE [code sample for an Azure AI multi-service resource](./includes/code-cognitive-microsoft-entra-id.md)]
 
-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 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
@@ -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: 01/28/2025
+ms.date: 01/29/2025
 ---
 
 # 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, 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"]
 >
@@ -138,16 +138,23 @@ Once the connection has been created, you can view its details in the **Service
 
 ## [Azure CLI](#tab/azure-cli)
 
-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.
-* **OpenAI service name:** the Azure OpenAI service that is connected.
+Create a service connection to the Azure OpenAI service in AKS by running the [az aks connection create cognitiveservices](/cli/azure/aks/connection/create#az-aks-connection-create-cognitiveservices) command in the Azure CLI. 
 
 ```azurecli
 az aks connection create cognitiveservices --secret
+```
+
+When using the above command, Service Connector prompts you to specify the AKS resource group, AKS cluster name, target service resource group, and cognitive service account name step by step.
+
+Alternatively, you can provide the complete command directly:
 
+```azurecli
+az aks connection create cognitiveservices \
+   --secret \
+   --resource-group <aks-cluster-resource-group> \
+   --name <aks-cluster-name> \
+   --target-resource-group <target-cognitive-services-resource-group> \
+   --account <target-cognitive-services-account>
 ```
 
 ---
@@ -216,12 +223,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](./how-to-integrate-openai.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)
diff --git a/articles/service-connector/tutorial-python-aks-openai-workload-identity.md b/articles/service-connector/tutorial-python-aks-openai-workload-identity.md
