Merge pull request #2379 from MicrosoftDocs/main

1/17/2025 PM Publish

Author: Taojunshen

articles/ai-services/cognitive-services-container-support.md

@@ -56,6 +56,7 @@ Azure AI containers provide the following set of Docker containers, each of whic
 | [Language service][ta-containers-pii] | **Personally Identifiable Information (PII) detection** ([image](https://mcr.microsoft.com/en-us/product/azure-cognitive-services/textanalytics/pii/tags))| Detect and redact personally identifiable information entities from text. | Generally available. <br>This container can also [run in disconnected environments](containers/disconnected-containers.md). |
 | [Language service][ta-containers-cner] |  **Custom Named Entity Recognition** ([image](https://mcr.microsoft.com/product/azure-cognitive-services/textanalytics/customner/about))| Extract named entities from text, using a custom model you create using your data. | Generally available |
 | [Language service][ta-containers-summarization] | **Summarization** ([image](https://mcr.microsoft.com/product/azure-cognitive-services/textanalytics/summarization/about))| Summarize text from various sources. | Public preview. <br>This container can also [run in disconnected environments](containers/disconnected-containers.md). |
+| [Language service][ta-containers-clu] | **Conversational Language Understanding** ([image](https://mcr.microsoft.com/product/azure-cognitive-services/language/clu/about)| Interpret conversational language. | Generally Available. <br>This container can also [run in disconnected environments](containers/disconnected-containers.md). |
 | [Translator][tr-containers] | **Translator** ([image](https://mcr.microsoft.com/product/azure-cognitive-services/translator/text-translation/about))| Translate text in several languages and dialects. | Generally available. Gated - [request access](https://aka.ms/csgate-translator). <br>This container can also [run in disconnected environments](containers/disconnected-containers.md). |
 
 ### Speech containers
@@ -132,6 +133,7 @@ Install and explore the functionality provided by containers in Azure AI service
 [ta-containers-cner]: language-service/custom-named-entity-recognition/how-to/use-containers.md
 [ta-containers-summarization]: language-service/summarization/how-to/use-containers.md
 [ta-containers-ner]: language-service/named-entity-recognition/how-to/use-containers.md
-[ta-containers-pii]: language-service/personally-identifiable-information//how-to/use-containers.md
+[ta-containers-pii]: language-service/personally-identifiable-information/how-to/use-containers.md
+[ta-contatiners-clu]: language-service/conversational-language-understanding/how-to/use-containers.md
 [tr-containers]: translator/containers/translator-how-to-install-container.md
 [request-access]: https://aka.ms/csgate

articles/ai-services/computer-vision/toc.yml

@@ -97,7 +97,7 @@ items:
     - name: Azure CLI
       href: /cli/azure/cognitiveservices#az_cognitiveservices_list
     - name: Azure PowerShell
-      href: /powershell/module/azurerm.cognitiveservices/
+      href: /powershell/module/az.cognitiveservices/
 - name: Image Analysis
   items:
   - name: Image Analysis overview
@@ -275,7 +275,7 @@ items:
     - name: Azure CLI
       href: /cli/azure/cognitiveservices#az_cognitiveservices_list
     - name: Azure PowerShell
-      href: /powershell/module/azurerm.cognitiveservices/
+      href: /powershell/module/az.cognitiveservices/
 - name: Face
   items:
   - name: Face overview

articles/ai-services/containers/disconnected-containers.md

@@ -28,13 +28,14 @@ Containers enable you to run Azure AI services APIs in your own environment, and
   * [Summarization](../language-service/summarization/how-to/use-containers.md)
   * [Named Entity Recognition](../language-service/named-entity-recognition/how-to/use-containers.md)
   * [Personally Identifiable Information (PII) detection](../language-service/personally-identifiable-information/how-to/use-containers.md)
+  * [Conversational Language Understanding (CLU)](../language-service/conversational-language-understanding/how-to/use-containers.md)
 * [Azure AI Vision - Read](../computer-vision/computer-vision-how-to-install-containers.md)
 * [Document Intelligence](../../ai-services/document-intelligence/containers/disconnected.md)
 
 Before attempting to run a Docker container in an offline environment, make sure you know the steps to successfully download and use the container. For example:
 
 * Host computer requirements and recommendations.
-* The Docker `pull` command you'll use to download the container.
+* The Docker `pull` command you use to download the container.
 * How to validate that a container is running.
 * How to send queries to the container's endpoint, once it's running.
 
@@ -47,24 +48,24 @@ Fill out and submit the [request form](https://aka.ms/csdisconnectedcontainers)
 Access is limited to customers that meet the following requirements:
 
 * Your organization should be identified as strategic customer or partner with Microsoft.
-* Disconnected containers are expected to run fully offline, hence your use cases must meet one of below or similar requirements:
-  * Environment or device(s) with zero connectivity to internet.
+* Disconnected containers are expected to run fully offline, hence your use cases must meet one of these or similar requirements:
+  * Environments or devices with zero connectivity to internet.
   * Remote location that occasionally has internet access.
   * Organization under strict regulation of not sending any kind of data back to cloud.
-* Application completed as instructed - Please pay close attention to guidance provided throughout the application to ensure you provide all the necessary information required for approval.
+* Application completed as instructed - Pay close attention to guidance provided throughout the application to ensure you provide all the necessary information required for approval.
 
 ## Purchase a commitment tier pricing plan for disconnected containers
 
 ### Create a new resource
 
-1. Sign in to the [Azure portal](https://portal.azure.com) and select **Create a new resource** for one of the applicable Azure AI services listed above.
+1. Sign in to the [Azure portal](https://portal.azure.com) and select **Create a new resource** for one of the applicable Azure AI services listed.
 
 2. Enter the applicable information to create your resource. Be sure to select **Commitment tier disconnected containers** as your pricing tier.
 
     > [!NOTE]
     >
-    > * You will only see the option to purchase a commitment tier if you have been approved by Microsoft.
-    > * Pricing details are for example only.
+    > * You only see the option to purchase a commitment tier if you have been approved by Microsoft.
+    > * Pricing details are only examples.
 
 1. Select **Review + Create** at the bottom of the page. Review the information, and select **Create**.
 
@@ -90,9 +91,10 @@ See the following documentation for steps on downloading and configuring the con
 * [Language Detection](../language-service/language-detection/how-to/use-containers.md#run-the-container-disconnected-from-the-internet)
 * [Named Entity Recognition](../language-service/named-entity-recognition/how-to/use-containers.md#run-the-container-disconnected-from-the-internet)
 * [Personally Identifiable Information (PII) detection](../language-service/personally-identifiable-information/how-to/use-containers.md#run-the-container-disconnected-from-the-internet)
+* [Conversational Language Understanding (CLU)](../language-service/conversational-language-understanding/how-to/use-containers.md#run-the-container-disconnected-from-the-internet)
 
 ## Environment variable names in Kubernetes deployments
-Some Azure AI Containers, for example Translator, require users to pass environmental variable names that include colons (`:`) when running the container. This will work fine when using Docker, but Kubernetes does not accept colons in environmental variable names.
+Some Azure AI Containers, for example Translator, require users to pass environmental variable names that include colons (`:`) when running the container. This works fine when using Docker, but Kubernetes doesn't accept colons in environmental variable names.
 To resolve this, you can replace colons with double underscore characters (`__`) when deploying to Kubernetes. See the following example of an acceptable format for environment variable names:
 
 ```Kubernetes
@@ -111,11 +113,11 @@ This example replaces the default format for the `Mounts:License` and `Mounts:Ou
 
 ## Usage records
 
-When operating Docker containers in a disconnected environment, the container will write usage records to a volume where they're collected over time. You can also call a REST endpoint to generate a report about service usage.
+When operating Docker containers in a disconnected environment, the container writes usage records to a volume where they're collected over time. You can also call a REST endpoint to generate a report about service usage.
 
 ### Arguments for storing logs
 
-When run in a disconnected environment, an output mount must be available to the container to store usage logs. For example, you would include `-v /host/output:{OUTPUT_PATH}` and `Mounts:Output={OUTPUT_PATH}` in the example below, replacing `{OUTPUT_PATH}` with the path where the logs will be stored:
+When run in a disconnected environment, an output mount must be available to the container to store usage logs. For example, you would include `-v /host/output:{OUTPUT_PATH}` and `Mounts:Output={OUTPUT_PATH}` in the example below, replacing `{OUTPUT_PATH}` with the path where the logs are stored:
 
 ```Docker
 docker run -v /host/output:{OUTPUT_PATH} ... <image> ... Mounts:Output={OUTPUT_PATH}
@@ -127,13 +129,13 @@ The container provides two endpoints for returning records about its usage.
 
 #### Get all records
 
-The following endpoint will provide a report summarizing all of the usage collected in the mounted billing record directory.
+The following endpoint provides a report summarizing all of the usage collected in the mounted billing record directory.
 
 ```http
 https://<service>/records/usage-logs/
 ```
 
-It will return JSON similar to the example below.
+It returns JSON similar to the example below.
 
 ```json
 {
@@ -150,13 +152,13 @@ It will return JSON similar to the example below.
 
 #### Get records for a specific month
 
-The following endpoint will provide a report summarizing usage over a specific month and year.
+The following endpoint provides a report summarizing usage over a specific month and year.
 
 ```HTTP
 https://<service>/records/usage-logs/{MONTH}/{YEAR}
 ```
 
-it will return a JSON response similar to the example below:
+It returns a JSON response similar to the example below:
 
 ```json
 {
@@ -173,13 +175,13 @@ it will return a JSON response similar to the example below:
 
 ## Purchase a commitment plan to use containers in disconnected environments
 
-Commitment plans for disconnected containers have a calendar year commitment period. When you purchase a plan, you'll be charged the full price immediately. During the commitment period, you can't change your commitment plan, however you can purchase additional unit(s) at a pro-rated price for the remaining days in the year. You have until midnight (UTC) on the last day of your commitment, to end a commitment plan.
+Commitment plans for disconnected containers have a calendar year commitment period. When you purchase a plan, you are charged the full price immediately. During the commitment period, you can't change your commitment plan, however you can purchase more units at a pro-rated price for the remaining days in the year. You have until midnight (UTC) on the last day of your commitment, to end a commitment plan.
 
 You can choose a different commitment plan in the **Commitment Tier pricing** settings of your resource.
 
 ## End a commitment plan
 
-If you decide that you don't want to continue purchasing a commitment plan, you can set your resource's auto-renewal to **Do not auto-renew**. Your commitment plan will expire on the displayed commitment end date. After this date, you won't be charged for the commitment plan. You'll be able to continue using the Azure resource to make API calls, charged at pay-as-you-go pricing. You have until midnight (UTC) on the last day of the year to end a commitment plan for disconnected containers, and not be charged for the following year.
+If you decide that you don't want to continue purchasing a commitment plan, you can set your resource's auto-renewal to **Do not auto-renew**. Your commitment plan expires on the displayed commitment end date. After this date, you won't be charged for the commitment plan. You are able to continue using the Azure resource to make API calls, charged at pay-as-you-go pricing. You have until midnight (UTC) on the last day of the year to end a commitment plan for disconnected containers, and not be charged for the following year.
 
 ## Troubleshooting