Merge pull request #1373 from MicrosoftDocs/main

11/7/2024 PM Publish

Author: Taojunshen

articles/ai-services/content-safety/how-to/use-blocklist.md

@@ -53,7 +53,7 @@ Copy the cURL command below to a text editor and make the following changes:
 
 
 ```shell
-curl --location --request PATCH '<endpoint>/contentsafety/text/blocklists/<your_list_name>?api-version=2023-10-01' \
+curl --location --request PATCH '<endpoint>/contentsafety/text/blocklists/<your_list_name>?api-version=2024-09-01' \
 --header 'Ocp-Apim-Subscription-Key: <enter_your_key_here>' \
 --header 'Content-Type: application/json' \
 --data-raw '{
@@ -245,7 +245,7 @@ Copy the cURL command below to a text editor and make the following changes:
 1. Replace the value of the `"text"` field with the item you'd like to add to your blocklist. The maximum length of a blocklistItem is 128 characters.
 
 ```shell
-curl --location --request POST '<endpoint>/contentsafety/text/blocklists/<your_list_name>:addOrUpdateBlocklistItems?api-version=2023-10-01' \
+curl --location --request POST '<endpoint>/contentsafety/text/blocklists/<your_list_name>:addOrUpdateBlocklistItems?api-version=2024-09-01' \
 --header 'Ocp-Apim-Subscription-Key: <enter_your_key_here>' \
 --header 'Content-Type: application/json' \
 --data-raw '"blocklistItems": [{
@@ -487,7 +487,7 @@ Copy the cURL command below to a text editor and make the following changes:
 1. Optionally change the value of the `"text"` field to whatever text you want to analyze. 
 
 ```shell
-curl --location --request POST '<endpoint>/contentsafety/text:analyze?api-version=2023-10-01&' \
+curl --location --request POST '<endpoint>/contentsafety/text:analyze?api-version=2024-09-01&' \
 --header 'Ocp-Apim-Subscription-Key: <enter_your_key_here>' \
 --header 'Content-Type: application/json' \
 --data-raw '{
@@ -727,7 +727,7 @@ Copy the cURL command below to a text editor and make the following changes:
 1. Replace `<your_list_name>` (in the request URL) with the name you used in the list creation step.
 
 ```shell
-curl --location --request GET '<endpoint>/contentsafety/text/blocklists/<your_list_name>/blocklistItems?api-version=2023-10-01' \
+curl --location --request GET '<endpoint>/contentsafety/text/blocklists/<your_list_name>/blocklistItems?api-version=2024-09-01' \
 --header 'Ocp-Apim-Subscription-Key: <enter_your_key_here>' \
 --header 'Content-Type: application/json'
 ```
@@ -900,7 +900,7 @@ Copy the cURL command below to a text editor and make the following changes:
 
 
 ```shell
-curl --location --request GET '<endpoint>/contentsafety/text/blocklists?api-version=2023-10-01' \
+curl --location --request GET '<endpoint>/contentsafety/text/blocklists?api-version=2024-09-01' \
 --header 'Ocp-Apim-Subscription-Key: <enter_your_key_here>' \
 --header 'Content-Type: application/json'
 ```
@@ -1048,7 +1048,7 @@ Copy the cURL command below to a text editor and make the following changes:
 1. Replace `<your_list_name>` (in the request URL) with the name you used in the list creation step.
 
 ```shell
-cURL --location '<endpoint>contentsafety/text/blocklists/<your_list_name>?api-version=2023-10-01' \
+cURL --location '<endpoint>contentsafety/text/blocklists/<your_list_name>?api-version=2024-09-01' \
 --header 'Ocp-Apim-Subscription-Key: <enter_your_key_here>' \
 --data ''
 ```
@@ -1199,7 +1199,7 @@ Copy the cURL command below to a text editor and make the following changes:
 
 
 ```shell
-cURL --location '<endpoint>contentsafety/text/blocklists/<your_list_name>/blocklistItems/<your_item_id>?api-version=2023-10-01' \
+cURL --location '<endpoint>contentsafety/text/blocklists/<your_list_name>/blocklistItems/<your_item_id>?api-version=2024-09-01' \
 --header 'Ocp-Apim-Subscription-Key: <enter_your_key_here>' \
 --data ''
 ```
@@ -1387,7 +1387,7 @@ Copy the cURL command below to a text editor and make the following changes:
 
 
 ```shell
-curl --location --request DELETE '<endpoint>/contentsafety/text/blocklists/<your_list_name>:removeBlocklistItems?api-version=2023-10-01' \
+curl --location --request POST '<endpoint>/contentsafety/text/blocklists/<your_list_name>:removeBlocklistItems?api-version=2024-09-01' \
 --header 'Ocp-Apim-Subscription-Key: <enter_your_key_here>' \
 --header 'Content-Type: application/json'
 --data-raw '"blocklistItemIds":[
@@ -1573,7 +1573,7 @@ Copy the cURL command below to a text editor and make the following changes:
 1. Replace `<your_list_name>` (in the request URL) with the name you used in the list creation step.
 
 ```shell
-curl --location --request DELETE '<endpoint>/contentsafety/text/blocklists/<your_list_name>?api-version=2023-10-01' \
+curl --location --request DELETE '<endpoint>/contentsafety/text/blocklists/<your_list_name>?api-version=2024-09-01' \
 --header 'Ocp-Apim-Subscription-Key: <enter_your_key_here>' \
 --header 'Content-Type: application/json' \
 ```

articles/ai-services/content-safety/quickstart-custom-categories.md

@@ -45,8 +45,12 @@ To train a custom category, you need example text data that represents the categ
 > For tips on creating your own data set, see the [How-to guide](./how-to/custom-categories.md#prepare-your-training-data).
 
 1. Download the [sample text data file](https://github.com/Azure-Samples/cognitive-services-sample-data-files/blob/master/ContentSafety/survival-advice.jsonl) from the GitHub repository.
-1. Upload the _.jsonl_ file to your Azure Storage account blob container. Then copy the blob URL to a temporary location for later use.
+2. Upload the _.jsonl_ file to your Azure Storage account blob container. Then copy the blob URL to a temporary location for later use.
 
+> [!IMPORTANT]
+> **The user's storage account is set up as a hierarchical namespace account, which cannot be supported by Custom Categories. Please try using a regular storage account instead.**
+For example, your blob URL cannot be split into two layers, such as example/example1/, and should only have one layer. For more details, refer to the documentation: [Azure Data Lake Storage hierarchical namespace - Azure Storage](https://learn.microsoft.com/azure/storage/blobs/data-lake-storage-namespace).
+>
 ### Grant storage access 
 
 [!INCLUDE [storage-account-access](./includes/storage-account-access.md)]

articles/ai-services/openai/concepts/provisioned-throughput.md

@@ -41,13 +41,13 @@ An Azure OpenAI Deployment is a unit of management for a specific OpenAI Model.
 ## How much throughput per PTU you get for each model
 The amount of throughput (tokens per minute or TPM) a deployment gets per PTU is a function of the input and output tokens in the minute. Generating output tokens requires more processing than input tokens and so the more output tokens generated the lower your overall TPM. The service dynamically balances the input & output costs, so users do not have to set specific input and output limits. This approach means your deployment is resilient to fluctuations in the workload shape. 
 
-To help with simplifying the sizing effort, the following table outlines the TPM per PTU for the `gpt-4o` and `gpt-4o-mini` models. The table also shows Service Level Agreement (SLA) Latency Target Values per model.  For more information about the SLA for Azure OpenAI Service, see the [Service Level Agreements (SLA) for Online Services page].(https://www.microsoft.com/licensing/docs/view/Service-Level-Agreements-SLA-for-Online-Services?lang=1)
+To help with simplifying the sizing effort, the following table outlines the TPM per PTU for the `gpt-4o` and `gpt-4o-mini` models which represent the max all the traffic is either input or output. The table also shows Service Level Agreement (SLA) Latency Target Values per model.  For more information about the SLA for Azure OpenAI Service, see the [Service Level Agreements (SLA) for Online Services page].(https://www.microsoft.com/licensing/docs/view/Service-Level-Agreements-SLA-for-Online-Services?lang=1)
 
 |     | **gpt-4o**, **2024-05-13**   & **gpt-4o**, **2024-08-06**   | **gpt-4o-mini**, **2024-07-18**   |
 | --- | --- | --- |
 | Deployable Increments | 50 | 25|
-| Input TPM per PTU | 2,500 | 37,000  |
-| Output TPM per PTU| 833|12,333|
+|Max Input TPM per PTU | 2,500 | 37,000  |
+|Max Output TPM per PTU| 833|12,333|
 | Latency Target Value |25 Tokens Per Second* |33 Tokens Per Second*|
 
 For a full list see the [AOAI Studio calculator](https://oai.azure.com/portal/calculator).

articles/ai-services/openai/how-to/migration-javascript.md

@@ -43,14 +43,14 @@ const azureADTokenProvider = getBearerTokenProvider(credential, scope);
 
 ### (Highly Discouraged) API Key
 
-API keys are not recommended for production use because they are less secure than other authentication methods. However, if you are using an API key to authenticate `OpenAIClient` or `AssistantsClient`, an `AzureKeyCredential` object must be created as follows:
+API keys are not recommended for production use because they are less secure than other authentication methods. Previously, `AzureKeyCredential` objects were created as follows to authenticate `OpenAIClient` or `AssistantsClient`:
 
 ```typescript
 import { AzureKeyCredential } from "@azure/openai";
 const apiKey = new AzureKeyCredential("your API key");
 ```
 
-Authenticating `AzureOpenAI` with an API key involves setting the `AZURE_OPENAI_API_KEY` environment variable or setting the `apiKey` string property in the options object when creating the `AzureOpenAI` client.
+On the other hand, `AzureOpenAI` can be authenticated with an API key by setting the `AZURE_OPENAI_API_KEY` environment variable or by setting the `apiKey` string property in the options object when creating the `AzureOpenAI` client.
 
 [!INCLUDE [Azure key vault](~/reusable-content/ce-skilling/azure/includes/ai-services/security/azure-key-vault.md)]
 

articles/ai-services/openai/how-to/quota.md

@@ -18,7 +18,7 @@ Quota provides the flexibility to actively manage the allocation of rate limits
 ## Prerequisites
 
 > [!IMPORTANT]
-> Viewing quota and deploying models requires the **Cognitive Services Usages Reader** role. This role provides the minimal access necessary to view quota usage across an Azure subscription. To learn more about this role and the other roles you will need to access Azure OpenAI, consult our [Azure role-based access (Azure RBAC) guide](./role-based-access-control.md).
+> For any task that requires viewing available quota we recommend using the **Cognitive Services Usages Reader** role. This role provides the minimal access necessary to view quota usage across an Azure subscription. To learn more about this role and the other roles you will need to access Azure OpenAI, consult our [Azure role-based access (Azure RBAC) guide](./role-based-access-control.md). 
 >
 > This role can be found in the Azure portal under **Subscriptions** > **Access control (IAM)** > **Add role assignment** > search for **Cognitive Services Usages Reader**.This role **must be applied at the subscription level**, it does not exist at the resource level.
 >

articles/ai-services/translator/containers/install-run.md

@@ -7,7 +7,7 @@ author: laujan
 manager: nitinme
 ms.service: azure-ai-translator
 ms.topic: how-to
-ms.date: 06/27/2024
+ms.date: 11/01/2024
 ms.author: lajanuar
 recommendations: false
 keywords: on-premises, Docker, container, identify
@@ -463,7 +463,7 @@ If you installed Docker Desktop CLI, it includes Docker compose and its prerequi
     services:
       azure-ai-translator:
         container_name: azure-ai-translator
-        image: mcr.microsoft.com/product/azure-cognitive-services/translator/text-translation:latest
+        image: mcr.microsoft.com/azure-cognitive-services/translator/text-translation::latest
         environment:
             - EULA=accept
             - billing={TRANSLATOR_ENDPOINT_URI}
@@ -472,13 +472,17 @@ If you installed Docker Desktop CLI, it includes Docker compose and its prerequi
             - VISIONURL=http://azure-ai-read:5000
         ports:
               - "5000:5000"
+        volumes:
+              - {your local folder}:/usr/local/models
         azure-ai-language:
           container_name: azure-ai-language
           image:  mcr.microsoft.com/azure-cognitive-services/textanalytics/language:latest
           environment:
               - EULA=accept
               - billing={LANGUAGE_RESOURCE_ENDPOINT_URI}
               - apiKey={LANGUAGE_RESOURCE_KEY}
+              - Languages=en,es
+              - LADINCLUSTER=true 
         azure-ai-read:
           container_name: azure-ai-read
           image:  mcr.microsoft.com/azure-cognitive-services/vision/read:latest

articles/ai-studio/ai-services/how-to/create-model-deployments.md

@@ -1,5 +1,5 @@
 ---
-title: Add and configure models to Azure AI services
+title: Add and configure models to Azure AI model inference service
 titleSuffix: Azure AI services
 description: Learn how to add and configure new models to the Azure AI model's inference endpoint in Azure AI services.
 ms.service: azure-ai-studio
@@ -12,9 +12,9 @@ ms.reviewer: fasantia
 recommendations: false
 ---
 
-# Add and configure models to Azure AI services
+# Add and configure models to Azure AI model inference service
 
-You can decide and configure which models are available for inference in the Azure AI services resource model's inference endpoint. When a given model is configured, you can then generate predictions from it by indicating its model name or deployment name on your requests. No further changes are required in your code to use it.
+You can decide and configure which models are available for inference in the resource's model inference endpoint. When a given model is configured, you can then generate predictions from it by indicating its model name or deployment name on your requests. No further changes are required in your code to use it.
 
 In this article, you learn how to add a new model to the Azure AI model inference service in Azure AI services.
 
@@ -62,4 +62,4 @@ When creating model deployments, you can configure other settings including cont
 
 ## Next steps
 
-* [Develop applications using Azure AI model inference service in Azure AI services](../concepts/endpoints.md)
+* [Develop applications using Azure AI model inference service in Azure AI services](../concepts/endpoints.md)