Merge pull request #278960 from MicrosoftDocs/main

6/21/2024 PM Publish

Author: Taojunshen

articles/ai-services/language-service/native-document-support/use-native-documents.md

@@ -6,7 +6,7 @@ author: laujan
 manager: nitinme
 ms.service: azure-ai-language
 ms.topic: how-to
-ms.date: 02/21/2024
+ms.date: 06/20/2024
 ms.author: lajanuar
 ---
 
@@ -340,25 +340,28 @@ For this project, you need a **source document** uploaded to your **source conta
 
   ```json
   {
-   "kind": "ExtractiveSummarization",
-   "parameters": {
+  "tasks": [
+    {
+      "kind": "ExtractiveSummarization",
+      "parameters": {
         "sentenceCount": 6
-    },
-   "analysisInput":{
-        "documents":[
-            {
-          "source":{
-            "location":"{your-source-blob-SAS-URL}"
-          },
-          "targets":
-            {
-              "location":"{your-target-container-SAS-URL}",
-            }
-            }
-        ]
+      }
     }
+  ],
+  "analysisInput": {
+    "documents": [
+      {
+        "source": {
+          "location": "{your-source-blob-SAS-URL}"
+        },
+        "targets": {
+          "location": "{your-target-container-SAS-URL}"
+        }
+      }
+    ]
   }
-  ```
+}
+```
 
 ### Run the POST request
 

articles/ai-services/openai/how-to/provisioned-get-started.md

@@ -175,7 +175,7 @@ We recommend the following workflow:
 * For more information on provisioned deployments, check out [What is provisioned throughput?](../concepts/provisioned-throughput.md)
 * For more information on retry logic within each SDK, check out:
     * [Python reference documentation](https://github.com/openai/openai-python?tab=readme-ov-file#retries)
-    * [.NET reference documentation](/dotnet/api/azure.ai.openai.openaiclientoptions?view=azure-dotnet-preview&preserve-view=true)
+    * [.NET reference documentation](/dotnet/api/overview/azure/ai.openai-readme)
     * [Java reference documentation](/java/api/com.azure.ai.openai.openaiclientbuilder?view=azure-java-preview&preserve-view=true#com-azure-ai-openai-openaiclientbuilder-retryoptions(com-azure-core-http-policy-retryoptions))
     * [JavaScript reference documentation](/javascript/api/@azure/openai/openaiclientoptions?view=azure-node-preview&preserve-view=true#@azure-openai-openaiclientoptions-retryoptions)
     * [GO reference documentation](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/ai/azopenai#ChatCompletionsOptions)

articles/ai-services/openai/includes/model-matrix/provisioned-models.md

@@ -5,7 +5,7 @@ description: PTU-managed model availability by region.
 manager: nitinme
 ms.service: azure-ai-openai
 ms.topic: include
-ms.date: 06/18/2024
+ms.date: 06/21/2024
 ---
 
 | **Region**     | **gpt-4**, **0613**   | **gpt-4**, **1106-Preview**   | **gpt-4**, **0125-Preview**   | **gpt-4**, **turbo-2024-04-09**   | **gpt-4o**, **2024-05-13**   | **gpt-4-32k**, **0613**   | **gpt-35-turbo**, **1106**   | **gpt-35-turbo**, **0125**   |
@@ -16,19 +16,19 @@ ms.date: 06/18/2024
 | canadaeast         | ✅                | ✅                        | -                       | ✅                            | ✅                       | -                   | ✅                       | -                      |
 | eastus             | ✅                | ✅                        | ✅                        | ✅                            | -                      | ✅                    | ✅                       | ✅                       |
 | eastus2            | ✅                | ✅                        | ✅                        | ✅                            | -                      | ✅                    | ✅                       | ✅                       |
-| francecentral      | ✅                | ✅                        | ✅                        | -                           | -                      | ✅                    | -                      | ✅                       |
+| francecentral      | ✅                | ✅                        | ✅                        | -                           | ✅                       | ✅                    | -                      | ✅                       |
 | germanywestcentral | ✅                | ✅                        | ✅                        | ✅                            | -                      | ✅                    | ✅                       | -                      |
 | japaneast          | -               | ✅                        | ✅                        | ✅                            | ✅                       | -                   | -                      | ✅                       |
 | koreacentral       | ✅                | -                       | -                       | ✅                            | ✅                       | ✅                    | ✅                       | -                      |
 | northcentralus     | ✅                | ✅                        | ✅                        | ✅                            | -                      | ✅                    | ✅                       | ✅                       |
 | norwayeast         | ✅                | -                       | ✅                        | -                           | -                      | ✅                    | -                      | -                      |
 | polandcentral      | ✅                | ✅                        | ✅                        | -                           | -                      | ✅                    | ✅                       | ✅                       |
 | southafricanorth   | ✅                | ✅                        | -                       | -                           | -                      | ✅                    | ✅                       | -                      |
-| southcentralus     | ✅                | ✅                        | ✅                        | ✅                            | -                      | ✅                    | ✅                       | ✅                       |
+| southcentralus     | ✅                | ✅                        | ✅                        | ✅                            | ✅                       | ✅                    | ✅                       | ✅                       |
 | southindia         | ✅                | ✅                        | ✅                        | -                           | -                      | ✅                    | ✅                       | ✅                       |
 | swedencentral      | ✅                | ✅                        | ✅                        | ✅                            | ✅                       | ✅                    | ✅                       | ✅                       |
 | switzerlandnorth   | ✅                | ✅                        | ✅                        | ✅                            | ✅                       | ✅                    | ✅                       | ✅                       |
 | switzerlandwest    | -               | -                       | -                       | -                           | -                      | -                   | -                      | ✅                       |
 | uksouth            | ✅                | ✅                        | ✅                        | ✅                            | -                      | ✅                    | ✅                       | ✅                       |
-| westus             | ✅                | ✅                        | ✅                        | ✅                            | -                      | ✅                    | ✅                       | ✅                       |
-| westus3            | ✅                | ✅                        | ✅                        | ✅                            | ✅                       | ✅                    | ✅                       | ✅                       |
+| westus             | ✅                | ✅                        | ✅                        | ✅                            | ✅                       | ✅                    | ✅                       | ✅                       |
+| westus3            | ✅                | ✅                        | ✅                        | ✅                            | ✅                       | ✅                    | ✅                       | ✅                       |

articles/ai-services/openai/quotas-limits.md

@@ -10,7 +10,7 @@ ms.custom:
   - ignite-2023
   - references_regions
 ms.topic: conceptual
-ms.date: 06/12/2024
+ms.date: 06/21/2024
 ms.author: mbullwin
 ---
 
@@ -99,7 +99,8 @@ If your Azure subscription is linked to certain [offer types](https://azure.micr
 |Tier| Quota Limit in tokens per minute (TPM) |
 |---|:---|
 |Azure for Students, Free Trials | 1 K (all models)|
-| Monthly credit card based accounts <sup>1</sup> | GPT 3.5 Turbo Series: 30 K <br> GPT-4 series: 8 K  <br> |
+| MSDN subscriptions | GPT 3.5 Turbo Series: 30 K <br> GPT-4 series: 8 K   |
+| Monthly credit card based subscriptions <sup>1</sup> | GPT 3.5 Turbo Series: 30 K <br> GPT-4 series: 8 K  |
 
 <sup>1</sup> This currently applies to [offer type 0003P](https://azure.microsoft.com/support/legal/offer-details/)
 

articles/ai-services/qnamaker/whats-new.md

@@ -24,7 +24,7 @@ Learn what's new with QnA Maker.
 
 ### November 2021
 * [Question answering](../language-service/question-answering/overview.md) is now [generally available](https://techcommunity.microsoft.com/t5/ai-cognitive-services-blog/question-answering-feature-is-generally-available/ba-p/2899497) as a feature within [Azure AI Language](https://portal.azure.com/?quickstart=true#create/Microsoft.CognitiveServicesTextAnalytics).
-* Question answering is powered by **state-of-the-art transformer models** and [Turing](https://turing.microsoft.com/) Natural Language models.
+* Question answering is powered by **state-of-the-art transformer models** and [Turing](https://www.microsoft.com/research/project/project-turing/) Natural Language models.
 * The erstwhile QnA Maker product will be [retired](https://azure.microsoft.com/updates/azure-qna-maker-will-be-retired-on-31-march-2025/) on 31st March 2025, and no new QnA Maker resources will be created beginning 1st October 2022.
 * All existing QnA Maker customers are strongly advised to [migrate](../language-service/question-answering/how-to/migrate-qnamaker.md) their QnA Maker knowledge bases to Question answering as soon as possible to continue experiencing the best of QnA capabilities offered by Azure.
 

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: 04/19/2024
+ms.date: 06/20/2024
 ms.author: lajanuar
 recommendations: false
 keywords: on-premises, Docker, container, identify
@@ -312,7 +312,7 @@ The following example shows the formatting for the `docker run` command with pla
 |:-------------|:-------|:---:|
 | `[image]` | The container image you want to use. | `mcr.microsoft.com/azure-cognitive-services/translator/text-translation` |
 | `{LICENSE_MOUNT}` | The path where the license is downloaded, and mounted.  | `/host/license:/path/to/license/directory` |
- | `{MODEL_MOUNT_PATH}`| The path where the machine translation models are downloaded, and mounted. Your directory structure must be formatted as **/usr/local/models** | `/host/translator/models:/usr/local/models`|
+| `{MODEL_MOUNT_PATH}`| The path where the machine translation models are downloaded, and mounted. Your directory structure must be formatted as **/usr/local/models** | `/host/translator/models:/usr/local/models`|
 | `{ENDPOINT_URI}` | The endpoint for authenticating your service request. You can find it on your resource's **Key and endpoint** page, in the Azure portal. | `https://<your-custom-subdomain>.cognitiveservices.azure.com` |
 | `{API_KEY}` | The key for your Text Translation resource. You can find it on your resource's **Key and endpoint** page, in the Azure portal. |`{string}`|
 | `{LANGUAGES_LIST}` | List of language codes separated by commas. It's mandatory to have English (en) language as part of the list.| `en`, `fr`, `it`, `zu`, `uk` |
@@ -477,15 +477,15 @@ If you installed Docker Desktop CLI, it includes Docker compose and its prerequi
           image:  mcr.microsoft.com/azure-cognitive-services/textanalytics/language:latest
           environment:
               - EULA=accept
-              - billing={TRANSLATOR_ENDPOINT_URI}
-              - apiKey={TRANSLATOR_KEY}
+              - billing={LANGUAGE_RESOURCE_ENDPOINT_URI}
+              - apiKey={LANGUAGE_RESOURCE_KEY}
         azure-ai-read:
           container_name: azure-ai-read
           image:  mcr.microsoft.com/azure-cognitive-services/vision/read:latest
           environment:
               - EULA=accept
-              - billing={TRANSLATOR_ENDPOINT_URI}
-              - apiKey={TRANSLATOR_KEY}
+              - billing={COMPUTER_VISION_ENDPOINT_URI}
+              - apiKey={COMPUTER_VISION_KEY}
     ```
 
 1. Open a terminal navigate to the `container-environment` folder, and start the containers with the following `docker-compose` command:

articles/ai-services/translator/document-translation/document-sdk-overview.md

@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: azure-ai-translator
 ms.custom: devx-track-python
 ms.topic: conceptual
-ms.date: 05/21/2024
+ms.date: 06/19/2024
 ms.author: lajanuar
 recommendations: false
 ---
@@ -26,9 +26,9 @@ Document Translation is a cloud-based REST API feature of the Azure AI Translato
 Document Translation SDK supports the following programming languages:
 
 | Language → SDK version | Package|Client library| Supported API version|
-|:----------------------:|:----------|:----------|:-------------|
+|:----------------------|:----------|:----------|:-------------|
 |🆕 [.NET/C# → 2.0.0-beta.1](https://azuresdkdocs.blob.core.windows.net/$web/dotnet/Azure.AI.Translation.Document/2.0.0-beta.1/index.html)| [NuGet](https://www.nuget.org/packages/Azure.AI.Translation.Document/2.0.0-beta.1) | [Azure SDK for .NET](/dotnet/api/overview/azure/ai.translation.document-readme?branch=main&view=azure-dotnet-preview&preserve-view=true) | Document Translation `api-version=2024-05-01`|
-|🆕 [Python → 1.1.0b1](https://azuresdkdocs.blob.core.windows.net/$web/python/azure-ai-translation-document/1.1.0b1/index.html)|[PyPi](https://pypi.org/project/azure-ai-translation-document/1.1.0b1/)|[Azure SDK for Python](/python/api/overview/azure/ai-translation-document-readme?view=azure-python&preserve-view=true)|Document Translation `api-version=2024-05-01`|
+|🆕 [Python → 1.1.0b1](https://azuresdkdocs.blob.core.windows.net/$web/python/azure-ai-translation-document/1.1.0b1/index.html)|[PyPi](https://pypi.org/project/azure-ai-translation-document/1.1.0b1/)|[Azure SDK for Python](/python/api/overview/azure/ai-translation-document-readme?view=azure-python-preview&preserve-view=true)|Document Translation `api-version=2024-05-01`|
 
 ## Changelog and release history
 
@@ -50,11 +50,11 @@ This section provides a version-based description of Document Translation featur
 **Version 1.1.0b1** </br>
 **2024-05-07**
 
-##### [**Changelog/Release History**](https://github.com/Azure/azure-sdk-for-python/blob/azure-ai-translation-document_1.0.0/sdk/translation/azure-ai-translation-document/CHANGELOG.md)
+##### [**Changelog/Release History**](https://github.com/Azure/azure-sdk-for-python/blob/azure-ai-translation-document_1.1.0b1/sdk/translation/azure-ai-translation-document/CHANGELOG.md)
 
-##### [README](https://github.com/Azure/azure-sdk-for-python/blob/azure-ai-translation-document_1.0.0/sdk/translation/azure-ai-translation-document/README.md)
+##### [README](https://github.com/Azure/azure-sdk-for-python/blob/azure-ai-translation-document_1.1.0b1/sdk/translation/azure-ai-translation-document/samples/README.md)
 
-##### [Samples](https://github.com/Azure/azure-sdk-for-python/tree/azure-ai-translation-document_1.0.0/sdk/translation/azure-ai-translation-document/samples)
+##### [Samples](https://github.com/Azure/azure-sdk-for-python/tree/azure-ai-translation-document_1.1.0b1/sdk/translation/azure-ai-translation-document/samples)
 
 ---
 
@@ -77,7 +77,7 @@ Install-Package Azure.AI.Translation.Document -Version 2.0.0-beta.1
 ### [Python](#tab/python)
 
 ```python
-pip install azure-ai-translation-document==1.0.0
+pip install azure-ai-translation-document==1.1.0b1
 ```
 
 ---
@@ -107,6 +107,8 @@ from azure.core.credentials import AzureKeyCredential
 
 Create an instance of the `DocumentTranslationClient` object to interact with the Document Translation SDK, and then call methods on that client object to interact with the service. The `DocumentTranslationClient` is the primary interface for using the Document Translation client library. It provides both synchronous and asynchronous methods to perform operations.
 
+***Asynchronous batch translation***
+
 ```csharp
 private static readonly string endpoint = "<your-custom-endpoint>";
 private static readonly string key = "<your-key>";
@@ -115,15 +117,37 @@ DocumentTranslationClient client = new DocumentTranslationClient(new Uri(endpoin
 
 ```
 
+***Synchronous single document translation***
+
+```csharp
+private static readonly string endpoint = "<your-custom-endpoint>";
+private static readonly string key = "<your-key>";
+
+SingleDocumentTranslationClient client = new SingleDocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));
+
+```
+
 ### [Python](#tab/python)
 
 Create an instance of the `DocumentTranslationClient` object to interact with the Document Translation SDK, and then call methods on that client object to interact with the service. The `DocumentTranslationClient` is the primary interface for using the Document Translation client library. It provides both synchronous and asynchronous methods to perform operations.
 
+***Asynchronous batch translation***
+
+```python
+  endpoint = "<endpoint>"
+  key = "<apiKey>"
+
+  client = DocumentTranslationClient(endpoint, AzureKeyCredential(key))
+
+```
+
+***Synchronous single document translation***
+
 ```python
-endpoint = "<endpoint>"
-key = "<apiKey>"
+  endpoint = "<endpoint>"
+  key = "<apiKey>"
 
-client = DocumentTranslationClient(endpoint, AzureKeyCredential(key))
+  client = SingleDocumentTranslationClient(endpoint, AzureKeyCredential(key))
 
 ```
 
@@ -133,7 +157,9 @@ client = DocumentTranslationClient(endpoint, AzureKeyCredential(key))
 
 ### [C#/.NET](#tab/csharp)
 
-The Document Translation interface requires the following input:
+***Asynchronous batch translation***
+
+Document Translation batch interfaces require the following input:
 
 1. Upload your files to an Azure Blob Storage source container (sourceUri).
 1. Provide a target container where the translated documents can be written (targetUri).
@@ -148,9 +174,15 @@ string targetLanguage = "<target-language-code>";
 DocumentTranslationInput input = new DocumentTranslationInput(sourceUri, targetUri, targetLanguage)
 ```
 
+***Synchronous single document translation***
+
+[Single document translation](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/translation/Azure.AI.Translation.Document/samples/Sample5_SynchronousTranslation.md)
+
 ### [Python](#tab/python)
 
-The Document Translation interface requires the following input:
+***Asynchronous batch translation***
+
+Document Translation batch interfaces require the following input:
 
 1. Upload your files to an Azure Blob Storage source container (sourceUri).
 1. Provide a target container where the translated documents can be written (targetUri).
@@ -166,6 +198,10 @@ result = poller.result()
 
 ```
 
+***Synchronous single document translation***
+
+[Single document translation](https://github.com/Azure/azure-sdk-for-python/blob/azure-ai-translation-document_1.1.0b1/sdk/translation/azure-ai-translation-document/samples/sample_single_document_translation.py)
+
 ---
 
 ## Help options