Merge branch 'MicrosoftDocs:main' into main

Author: gmndrg

.openpublishing.redirection.json

@@ -4060,7 +4060,7 @@
         },
         {
             "source_path_from_root":"/articles/cosmos-db/high-availability.md",
-            "redirect_url":"/azure/reliability/reliability-cosmos-db-nosql.md",
+            "redirect_url":"/azure/reliability/reliability-cosmos-db-nosql",
             "redirect_document_id":false
         },
         {

articles/ai-services/Anomaly-Detector/includes/quickstarts/anomaly-detector-client-library-python-multivariate.md

@@ -120,6 +120,7 @@ from datetime import datetime, timezone
 from azure.ai.anomalydetector import AnomalyDetectorClient
 from azure.core.credentials import AzureKeyCredential
 from azure.ai.anomalydetector.models import *
+import os
 
 SUBSCRIPTION_KEY =  os.environ['ANOMALY_DETECTOR_API_KEY']
 ANOMALY_DETECTOR_ENDPOINT = os.environ['ANOMALY_DETECTOR_ENDPOINT']
@@ -175,12 +176,12 @@ result = ad_client.detect_multivariate_batch_anomaly(model_id, batch_inference_b
 result_id = result.result_id
 
 # Get results (may need a few seconds)
-r = ad_client.get_multivariate_batch_detection_result(result_id)
+anomaly_results = ad_client.get_multivariate_batch_detection_result(result_id)
 print("Get detection result...(it may take a few seconds)")
 
-while r.summary.status != MultivariateBatchDetectionStatus.READY and r.summary.status != MultivariateBatchDetectionStatus.FAILED and r.summary.status !=MultivariateBatchDetectionStatus.CREATED:
+while anomaly_results.summary.status != MultivariateBatchDetectionStatus.READY and anomaly_results.summary.status != MultivariateBatchDetectionStatus.FAILED:
     anomaly_results = ad_client.get_multivariate_batch_detection_result(result_id)
-    print("Detection is {}".format(r.summary.status))
+    print("Detection is {}".format(anomaly_results.summary.status))
     time.sleep(5)
 
 

articles/ai-services/computer-vision/how-to/image-retrieval.md

@@ -20,12 +20,12 @@ The Multimodal embeddings APIs enable the _vectorization_ of images and text que
 The `2024-02-01` API includes a multi-lingual model that supports text search in 102 languages. The original English-only model is still available, but it cannot be combined with the new model in the same search index. If you vectorized text and images using the English-only model, these vectors won’t be compatible with multi-lingual text and image vectors.
 
 > [!IMPORTANT]
-> These APIs are only available in the following geographic regions: East US, France Central, Korea Central, North Europe, Southeast Asia, West Europe, West US.
+> These APIs are only available in the following geographic regions: SwedenCentral, EastUS, NorthEurope, WestEurope,WestUS, SoutheastAsia, KoreaCentral, FranceCentral, AustraliaEast, WestUS2, SwitzerlandNorth, JapanEast.
 
 ## Prerequisites
 
 * Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services)
-* Once you have your Azure subscription, <a href="https://portal.azure.com/#create/Microsoft.CognitiveServicesComputerVision"  title="Create a Computer Vision resource"  target="_blank">create a Computer Vision resource </a> in the Azure portal to get your key and endpoint. Be sure to create it in one of the permitted geographic regions: East US, France Central, Korea Central, North Europe, Southeast Asia, West Europe, West US. 
+* Once you have your Azure subscription, <a href="https://portal.azure.com/#create/Microsoft.CognitiveServicesComputerVision"  title="Create a Computer Vision resource"  target="_blank">create a Computer Vision resource </a> in the Azure portal to get your key and endpoint. Be sure to create it in one of the permitted geographic regions: SwedenCentral, EastUS, NorthEurope, WestEurope,WestUS, SoutheastAsia, KoreaCentral, FranceCentral, AustraliaEast, WestUS2, SwitzerlandNorth, JapanEast.
    * After it deploys, select **Go to resource**. Copy the key and endpoint to a temporary location to use later on.
 
 ## Try out Multimodal embeddings

articles/ai-services/document-intelligence/concept-id-document.md

@@ -231,6 +231,24 @@ Extract data, including name, birth date, and expiration date, from ID documents
 
 The following are the fields extracted per document type. The Document Intelligence ID model `prebuilt-idDocument` extracts the following fields in the `documents.*.fields`. The json output includes all the extracted text in the documents, words, lines, and styles.
 
+::: moniker-end
+
+::: moniker range="doc-intel-3.1.0"
+
+> [!div class="nextstepaction"]
+> [View samples on GitHub.](https://github.com/Azure-Samples/document-intelligence-code-samples/blob/v3.1(2023-07-31-GA)/Python(v3.1)/Prebuilt_model/sample_analyze_identity_documents.py)
+
+::: moniker-end
+
+::: moniker range="doc-intel-4.0.0"
+
+> [!div class="nextstepaction"]
+> [View samples on GitHub.](https://github.com/Azure-Samples/document-intelligence-code-samples/blob/main/Python(v4.0)/Prebuilt_model/sample_analyze_identity_documents.py)
+
+::: moniker-end
+
+::: moniker range=">=doc-intel-3.0.0"
+
 ### `idDocument.driverLicense`
 
 | Field | Type | Description | Example |

articles/ai-services/document-intelligence/concept-invoice.md

@@ -186,6 +186,21 @@ See how data, including customer information, vendor details, and line items, is
 *See* our [Language Support—prebuilt models](language-support-prebuilt.md) page for a complete list of supported languages.
 
 ## Field extraction
+The Document Intelligence invoice model `prebuilt-invoice` extracts the following fields.
+
+::: moniker range="doc-intel-3.1.0"
+
+> [!div class="nextstepaction"]
+> [View samples on GitHub.](https://github.com/Azure-Samples/document-intelligence-code-samples/blob/v3.1(2023-07-31-GA)/Python(v3.1)/Prebuilt_model/sample_analyze_invoices.py)
+
+::: moniker-end
+
+::: moniker range="doc-intel-4.0.0"
+
+> [!div class="nextstepaction"]
+> [View samples on GitHub.](https://github.com/Azure-Samples/document-intelligence-code-samples/blob/main/Python(v4.0)/Prebuilt_model/sample_analyze_invoices.py)
+
+::: moniker-end
 
 |Name| Type | Description | Standardized output |
 |:-----|:----|:----|:----|

articles/ai-services/document-intelligence/concept-receipt.md

@@ -228,6 +228,24 @@ See how Document Intelligence extracts data, including time and date of transact
  Document Intelligence v3.0 and later versions introduce several new features and capabilities. In addition to thermal receipts, the **Receipt** model supports single-page hotel receipt processing and tax detail extraction for all receipt types.
 
  Document Intelligence v4.0 and later versions introduces support for currency for all price-related fields for thermal and hotel receipts.
+ 
+::: moniker-end
+
+::: moniker range="doc-intel-3.1.0"
+
+> [!div class="nextstepaction"]
+> [View samples on GitHub.](https://github.com/Azure-Samples/document-intelligence-code-samples/blob/v3.1(2023-07-31-GA)/Python(v3.1)/Prebuilt_model/sample_analyze_receipts.py)
+
+::: moniker-end
+
+::: moniker range="doc-intel-4.0.0"
+
+> [!div class="nextstepaction"]
+> [View samples on GitHub.](https://github.com/Azure-Samples/document-intelligence-code-samples/blob/main/Python(v4.0)/Prebuilt_model/sample_analyze_receipts.py)
+
+::: moniker-end
+
+::: moniker range=">=doc-intel-3.0.0"
 
 ### Receipt
 

articles/ai-services/document-intelligence/concept-tax-document.md

@@ -106,6 +106,20 @@ See how data, including customer information, vendor details, and line items, is
 
 The following are the fields extracted from a W-2 tax form in the JSON output response.
 
+::: moniker range="doc-intel-3.1.0"
+
+> [!div class="nextstepaction"]
+> [View samples on GitHub.](https://github.com/Azure-Samples/document-intelligence-code-samples/blob/v3.1(2023-07-31-GA)/Python(v3.1)/Prebuilt_model/sample_analyze_tax_us_w2.py)
+
+::: moniker-end
+
+::: moniker range="doc-intel-4.0.0"
+
+> [!div class="nextstepaction"]
+> [View samples on GitHub.](https://github.com/Azure-Samples/document-intelligence-code-samples/blob/main/Python(v4.0)/Prebuilt_model/sample_analyze_tax_us_w2.py)
+
+::: moniker-end
+
 |Name| Type | Description | Example output |dependents
 |:-----|:----|:----|:---:|
 | `W-2FormVariant`| String | IR W-2 Form variant. This field can have the one of the following values: `W-2`, `W-2AS`, `W-2CM`, `W-2GU`, or `W-2VI`| W-2 |

articles/ai-services/openai/assistants-reference-runs.md

@@ -259,10 +259,30 @@ curl https://YOUR_RESOURCE_NAME.openai.azure.com/openai/threads/{thread_id}/runs
 
 ## Retrieve run
 
+# [Python 1.x](#tab/python)
+
+```python
+from openai import OpenAI
+client = OpenAI()
+
+run = client.beta.threads.runs.retrieve(
+  thread_id="thread_abc123",
+  run_id="run_abc123"
+)
+
+print(run)
+```
+
+# [REST](#tab/rest)
+
 ```http
-GET https://YOUR_RESOURCE_NAME.openai.azure.com/openai/threads/{thread_id}/runs/{run_id}?api-version=2024-05-01-preview
+curl https://YOUR_RESOURCE_NAME.openai.azure.com/openai/threads/{thread_id}/runs/{run_id}?api-version=2024-05-01-preview
+  -H "api-key: $AZURE_OPENAI_API_KEY" \
+  -H 'Content-Type: application/json' 
 ```
 
+---
+
 Retrieves a run.
 
 **Path parameters**
@@ -565,6 +585,7 @@ Represents an execution run on a thread.
 | `tool_choice` | string or object | Controls which (if any) tool is called by the model. `none` means the model won't call any tools and instead generates a message. `auto` is the default value and means the model can pick between generating a message or calling a tool. Specifying a particular tool like `{"type": "file_search"}` or `{"type": "function", "function": {"name": "my_function"}}` forces the model to call that tool. |
 | `max_prompt_tokens` | integer or null | The maximum number of prompt tokens specified to have been used over the course of the run. |
 | `max_completion_tokens` | integer or null | The maximum number of completion tokens specified to have been used over the course of the run. |
+| `usage` | object or null | Usage statistics related to the run. This value will be null if the run is not in a terminal state (for example `in_progress`, `queued`). |
 
 
 ## Run step object

articles/ai-services/openai/assistants-reference.md

@@ -5,7 +5,7 @@ description: Learn how to use Azure OpenAI's Python & REST API with Assistants.
 manager: nitinme
 ms.service: azure-ai-openai
 ms.topic: conceptual
-ms.date: 02/07/2024
+ms.date: 05/22/2024
 author: mrbullwinkle
 ms.author: mbullwin
 recommendations: false
@@ -34,7 +34,7 @@ Create an assistant with a model and instructions.
 | model| string | Required | Model deployment name of the model to use.|
 | name | string or null | Optional | The name of the assistant. The maximum length is 256 characters.|
 | description| string or null | Optional | The description of the assistant. The maximum length is 512 characters.|
-| instructions | string or null | Optional | The system instructions that the assistant uses. The maximum length is 32768 characters.|
+| instructions | string or null | Optional | The system instructions that the assistant uses. The maximum length is 256,000 characters.|
 | tools | array | Optional | Defaults to []. A list of tools enabled on the assistant. There can be a maximum of 128 tools per assistant. Tools can currently be of types `code_interpreter`, or `function`.|
 | file_ids | array | Optional | Defaults to []. A list of file IDs attached to this assistant. There can be a maximum of 20 files attached to the assistant. Files are ordered by their creation date in ascending order.|
 | metadata | map | Optional | Set of 16 key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format. Keys can be a maximum of 64 characters long and values can be a maximum of 512 characters long.|

articles/ai-services/openai/concepts/models.md

@@ -194,8 +194,8 @@ In addition to the regions above which are available to all Azure OpenAI custome
 
 | Model | Region |  
 |---|:---|  
-| `gpt-4` (0314) | East US <br> France Central <br> South Central US <br> UK South |  
-| `gpt-4` (0613) | East US <br> East US 2 <br> Japan East <br> UK South |  
+| `gpt-4` (0314) <br> `gpt-4-32k` (0314) | East US <br> France Central <br> South Central US <br> UK South |  
+| `gpt-4` (0613) <br> `gpt-4-32k` (0613) | East US <br> East US 2 <br> Japan East <br> UK South |  
 
 #### Azure Government regions
 
@@ -309,7 +309,6 @@ For Assistants you need a combination of a supported model, and a supported regi
 | East US  | ✅ | | | | | ✅ |
 | East US 2 | ✅ |  | ✅ | ✅ |✅ | |
 | France Central  | ✅ | ✅ | | ✅ |✅ |  |
-| India South |  | ✅ | | | ✅ | |
 | Japan East | ✅ |  | | | | | 
 | Norway East | |  | | | ✅ |  |
 | Sweden Central  | ✅ |✅ | ✅ |✅ |✅| |