Merge pull request #519 from MicrosoftDocs/main

9/26/2024 PM Publish

Author: Daidihuang

articles/ai-services/document-intelligence/choose-model-feature.md

@@ -6,7 +6,7 @@ author: laujan
 manager: nitinme
 ms.service: azure-ai-document-intelligence
 ms.topic: overview
-ms.date: 08/07/2024
+ms.date: 09/26/2024
 ms.author: lajanuar
 ---
 

articles/ai-services/document-intelligence/concept-analyze-document-response.md

@@ -6,11 +6,10 @@ author: laujan
 manager: nitinme
 ms.service: azure-ai-document-intelligence
 ms.topic: conceptual
-ms.date: 08/07/2024
+ms.date: 09/26/2024
 ms.author: vikurpad
 ms.custom:
   - references_regions
-  - ignite-2023
 monikerRange: '>=doc-intel-3.0.0'
 ---
 
@@ -22,7 +21,7 @@ In this article, let's examine the different objects returned as part of the `An
 
 ## Analyze document request
 
-The Document Intelligence APIs analyze images, PDFs, and other document files to extract and detect various content, layout, style, and semantic elements. The analyze operation is an async API. Submitting a document returns an **Operation-Location** header that contains the URL to poll for completion. When an analysis request completes successfully, the response contains the elements described in the [model data extraction](concept-model-overview.md#model-data-extraction).
+The Document Intelligence APIs analyze images, PDFs, and other document files to extract and detect various content, layout, style, and semantic elements. The `Analyze` operation is an async API. Submitting a document returns an **Operation-Location** header that contains the URL to poll for completion. When an analysis request completes successfully, the response contains the elements described in the [model data extraction](concept-model-overview.md#model-data-extraction).
 
 ### Response elements
 
@@ -43,7 +42,7 @@ The top-level content property contains a concatenation of all content elements
 
 ## Analyze response
 
-The analyze response for each API returns different objects. API responses contain elements from component models where applicable.
+The `Analyze` response for each API returns different objects. API responses contain elements from component models where applicable.
 
 | Response content | Description | API |
 |--|--|--|
@@ -52,8 +51,8 @@ The analyze response for each API returns different objects. API responses conta
 | **styles**| Identified text element properties. | Read, Layout, General Document, Prebuilt, and Custom models|
 | **languages**| Identified language associated with each span of the text extracted | Read |
 | **tables**| Tabular content identified and extracted from the document. Tables relate to tables identified by the pretrained layout model. Content labeled as tables is extracted as structured fields in the documents object.| Layout, General Document, Invoice, and Custom models |
-| **figures**| Figures (charts, images) identified and extracted from the document, providing visual representations that aid in the understanding of complex information. | Layout model |
-| **sections** | Hierarchical document structure identified and extracted from the document. Section or subsection with the corresponding elements (paragraph, table, figure) attached to it. | Layout model |
+| **figures**| Figures (charts, images) identified and extracted from the document, providing visual representations that aid in the understanding of complex information. | The Layout model |
+| **sections** | Hierarchical document structure identified and extracted from the document. Section or subsection with the corresponding elements (paragraph, table, figure) attached to it. | The Layout model |
 | **keyValuePairs**| Key-value pairs recognized by a pretrained model. The key is a span of text from the document with the associated value. | General document and Invoice models |
 | **documents**| Fields recognized are returned in the `fields` dictionary within the list of documents| Prebuilt models, Custom models.|
 
@@ -142,7 +141,7 @@ Based on its position and styling, a cell can be classified as general content,
 Figures (charts, images) in documents play a crucial role in complementing and enhancing the textual content, providing visual representations that aid in the understanding of complex information. The figures object detected by the Layout model has key properties like `boundingRegions` (the spatial locations of the figure on the document pages, including the page number and the polygon coordinates that outline the figure's boundary), `spans` (details the text spans related to the figure, specifying their offsets and lengths within the document's text. This connection helps in associating the figure with its relevant textual context), `elements` (the identifiers for text elements or paragraphs within the document that are related to or describe the figure) and `caption`, if any.
 
 When *output=figures* is specified during the initial `Analyze` operation, the service generates cropped images for all detected figures that can be accessed via `/analyeResults/{resultId}/figures/{figureId}`.
-`FigureId` will be included in each figure object, following an undocumented convention of `{pageNumber}.{figureIndex}` where `figureIndex` resets to one per page.
+`FigureId` is included in each figure object, following an undocumented convention of `{pageNumber}.{figureIndex}` where `figureIndex` resets to one per page.
 
 ```json
 {
@@ -255,7 +254,7 @@ The semantic schema of a document type is described via the fields it contains.
 | date | Date | ISO 8601 - YYYY-MM-DD | InvoiceDate: "5/7/2022" → "2022-05-07" |
 | time | Time | ISO 8601 - hh:mm:ss | TransactionTime: "9:45 PM" → "21:45:00" |
 | phoneNumber | Phone number | E.164 - +{CountryCode}{SubscriberNumber} | WorkPhone: "(800) 555-7676" → "+18005557676"|
-| countryRegion | Country/region | ISO 3166-1 alpha-3 | CountryRegion: "United States" → "USA" |
+| countryRegion | Country/Region | ISO 3166-1 alpha-3 | CountryRegion: "United States" → "USA" |
 | selectionMark | Is selected | "signed" or "unsigned" | AcceptEula: ☑ → "selected" |
 | signature | Is signed | Same as content | LendeeSignature: {signature} → "signed" |
 | number | Floating point number | Floating point number | Quantity: "1.20" → 1.2|

articles/ai-services/document-intelligence/concept-custom-classifier.md

@@ -1,16 +1,15 @@
 ---
-title: Custom classification model - Document Intelligence 
+title: Custom classification model - Document Intelligence
 titleSuffix: Azure AI services
 description: Use the custom classification model to train a model to identify and split the documents you process within your application.
 author: vkurpad
 manager: nitinme
 ms.service: azure-ai-document-intelligence
 ms.topic: conceptual
-ms.date: 08/07/2024
+ms.date: 09/26/2024
 ms.author: lajanuar
 ms.custom:
   - references_regions
-  - ignite-2023
 monikerRange: '>=doc-intel-3.1.0'
 ---
 
@@ -50,7 +49,6 @@ Custom classification models are deep-learning-model types that combine layout a
 Custom classification models can analyze a single- or multi-file documents to identify if any of the trained document types are contained within an input file. Here are the currently supported scenarios:
 
 * A single file containing one document type, such as a loan application form.
-
 * A single file containing multiple document types. For instance, a loan application package that contains a loan application form, payslip, and bank statement.
 
 * A single file containing multiple instances of the same document. For instance, a collection of scanned invoices.
@@ -59,7 +57,8 @@ Custom classification models can analyze a single- or multi-file documents to id
 
 ✔️ The maximum allowed number of classes is `500`. The maximum allowed number of document samples per class is `100`.
 
-The model classifies each page of the input document, unless specified, to one of the classes in the labeled dataset. You can specify the page numbers to analyze in the input document as well. To set the threshold for your application, use the confidence score from the response. 
+The model classifies each page of the input document, unless specified, to one of the classes in the labeled dataset. You can specify the page numbers to analyze in the input document as well. To set the threshold for your application, use the confidence score from the response.
+
 ### Incremental training
 
 With custom models, you need to maintain access to the training dataset to update your classifier with new samples for an existing class, or add new classes. Classifier models now support incremental training where you can reference an existing classifier and append new samples for an existing class or add new classes with samples. Incremental training enables scenarios where data retention is a challenge and the classifier needs to be updated to align with changing business needs. Incremental training is supported with models trained with API version `2024-02-29-preview` and later.
@@ -250,7 +249,7 @@ Alternatively, if you have a flat list of files or only plan to use a few select
 ```
 
 As an example, the file list `car-maint.jsonl` contains the following files.
- 
+
 ```json
 {"file":"classifier/car-maint/Commercial Motor Vehicle - Adatum.pdf"}
 {"file":"classifier/car-maint/Commercial Motor Vehicle - Fincher.pdf"}

articles/ai-services/document-intelligence/create-document-intelligence-resource.md

@@ -8,7 +8,7 @@ ms.service: azure-ai-document-intelligence
 ms.custom:
   - ignite-2023
 ms.topic: how-to
-ms.date: 04/24/2024
+ms.date: 09/26/2024
 ms.author: lajanuar
 ---
 
@@ -37,10 +37,10 @@ Let's get started:
 
 ## Create a resource
 
-1. Next, you're going to fill out the **Create Document Intelligence** fields with the following values:
+1. Next, you're going to fill out the **`Create Document Intelligence`** fields with the following values:
 
     * **Subscription**. Select your current subscription.
-    * **Resource group**. The [Azure resource group](/azure/cloud-adoption-framework/govern/resource-consistency/resource-access-management#what-is-an-azure-resource-group) that contains your resource. You can create a new group or add it to a pre-existing group.
+    * **Resource group**. The [Azure resource group](/azure/cloud-adoption-framework/govern/resource-consistency/resource-access-management#what-is-an-azure-resource-group) that contains your resource. You can create a new group or add it to an existing group.
     * **Region**. Select your local region.
     * **Name**. Enter a name for your resource. We recommend using a descriptive name, for example *YourNameFormRecognizer*.
     * **Pricing tier**. The cost of your resource depends on the pricing tier you choose and your usage. For more information, see [pricing details](https://azure.microsoft.com/pricing/details/cognitive-services/). You can use the free pricing tier (F0) to try the service, and upgrade later to a paid tier for production.

articles/ai-services/document-intelligence/service-limits.md

@@ -1,5 +1,5 @@
 ---
-title: Service quotas and limits - Document Intelligence 
+title: Service quotas and limits - Document Intelligence
 titleSuffix: Azure AI services
 description: Quick reference, detailed description, and best practices for working within Azure AI Document Intelligence service Quotas and Limits
 #services: cognitive-services
@@ -9,7 +9,7 @@ ms.service: azure-ai-document-intelligence
 ms.custom:
   - ignite-2023
 ms.topic: conceptual
-ms.date: 06/26/2024
+ms.date: 09/26/2024
 ms.author: lajanuar
 monikerRange: '<=doc-intel-4.0.0'
 ---

articles/ai-services/translator/custom-translator/overview.md

@@ -5,7 +5,7 @@ description: Custom Translator offers similar capabilities to what Microsoft Tra
 author: laujan
 manager: nitinme
 ms.service: azure-ai-translator
-ms.date: 07/08/2024
+ms.date: 09/26/2024
 ms.author: lajanuar
 ms.topic: overview
 ---

articles/ai-services/translator/quickstart-text-rest-api.md

@@ -7,7 +7,7 @@ author: laujan
 manager: nitinme
 ms.service: azure-ai-translator
 ms.topic: quickstart
-ms.date: 02/09/2024
+ms.date: 09/26/2024
 ms.author: lajanuar
 ms.devlang: csharp
 # ms.devlang: csharp, golang, java, javascript, python
@@ -122,7 +122,7 @@ For detailed information regarding Azure AI Translator service request limits, *
 
 1. Open the **Program.cs** file.
 
-1. Delete the pre-existing code, including the line `Console.WriteLine("Hello World!")`. Copy and paste the code sample into your application's Program.cs file. Make sure you update the key variable with the value from your Azure portal Translator instance:
+1. Delete the existing code, including the line `Console.WriteLine("Hello World!")`. Copy and paste the code sample into your application's Program.cs file. Make sure you update the key variable with the value from your Azure portal Translator instance:
 
 ```csharp
 using System.Text;
@@ -210,15 +210,15 @@ After a successful call, you should see the following response:
 
 ### Set up your Go environment
 
-You can use any text editor to write Go applications. We recommend using the latest version of [Visual Studio Code and the Go extension](/azure/developer/go/configure-visual-studio-code).
+You can use any text editor to write Go applications. We recommend using the latest version of [Visual Studio Code and Go extension](/azure/developer/go/configure-visual-studio-code).
 
 > [!TIP]
 >
 > If you're new to Go, try the [Get started with Go](/training/modules/go-get-started/) Learn module.
 
 1. Make sure the latest version of [Go](https://go.dev/doc/install) is installed:
 
-    * Download the Go version for your operating system.
+    * Download the `Go` programming language version for your operating system.
     * Once the download is complete, run the installer.
     * Open a command prompt and enter the following to confirm Go was installed:
 
@@ -362,7 +362,7 @@ After a successful call, you should see the following response:
 
   * [**Gradle**](https://docs.gradle.org/current/userguide/installation.html), version 6.8 or later.
 <!-- checked -->
-<!-- 
+<!--
  > [!div class="nextstepaction"]
 > [I ran into an issue](https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=Java&Product=Translator&Page=quickstart-translator&Section=set-up-your-java-environment) -->
 
@@ -633,7 +633,7 @@ Add the following code sample to your `index.js` file. **Make sure you update th
 
 ```
 <!-- checked -->
-<!-- 
+<!--
  > [!div class="nextstepaction"]
 > [I ran into an issue](https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=Python&Product=Translator&Page=quickstart-translator&Section=build-your-javascript-application) -->
 
@@ -671,7 +671,7 @@ After a successful call, you should see the following response:
 
 ```
 <!-- checked -->
-<!-- 
+<!--
  > [!div class="nextstepaction"]
 > [My REST API call was successful](#next-steps) [I ran into an issue](https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=Java&Product=Translator&Page=quickstart-translator&Section=run-your-javascript-application) -->
 
@@ -694,7 +694,7 @@ After a successful call, you should see the following response:
     > [!NOTE]
     > We will also use a Python built-in package called json. It's used to work with JSON data.
 <!-- checked -->
-<!-- 
+<!--
  > [!div class="nextstepaction"]
 > [I ran into an issue](https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=Python&Product=Translator&Page=quickstart-translator&Section=set-up-your-python-project) -->
 
@@ -744,7 +744,7 @@ print(json.dumps(response, sort_keys=True, ensure_ascii=False, indent=4, separat
 
 ```
 <!-- checked -->
-<!-- 
+<!--
  > [!div class="nextstepaction"]
 > [I ran into an issue](https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=Python&Product=Translator&Page=quickstart-translator&Section=build-your-python-application) -->
 
@@ -782,7 +782,7 @@ After a successful call, you should see the following response:
 
 ```
 <!-- checked -->
-<!-- 
+<!--
  > [!div class="nextstepaction"]
 > [My REST API call was successful](#next-steps) [I ran into an issue](https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=Python&Product=Translator&Page=quickstart-translator&Section=run-your-python-application) -->
 

articles/ai-services/translator/quickstart-text-sdk.md

@@ -7,7 +7,7 @@ author: laujan
 manager: nitinme
 ms.service: azure-ai-translator
 ms.topic: quickstart
-ms.date: 07/09/2024
+ms.date: 09/26/2024
 ms.author: lajanuar
 ms.devlang: csharp
 # ms.devlang: csharp, java, javascript, python

articles/ai-services/translator/service-limits.md

@@ -7,7 +7,7 @@ author: laujan
 manager: nitinme
 ms.service: azure-ai-translator
 ms.topic: conceptual
-ms.date: 01/31/2024
+ms.date: 09/26/2024
 ms.author: lajanuar
 ---
 

articles/ai-studio/how-to/develop/llama-index.md

@@ -138,7 +138,7 @@ llm = AzureAICompletionsModel(
 
 ## Use LLMs models
 
-You can use the client directly or [#configure-the-models-used-by-your-code](Configure the models used by your code) in LlamaIndex. To use the model directly, use the `chat` method for chat instruction models:
+You can use the client directly or [Configure the models used by your code](#configure-the-models-used-by-your-code) in LlamaIndex. To use the model directly, use the `chat` method for chat instruction models:
 
 ```python
 from llama_index.core.llms import ChatMessage