Merge pull request #284549 from laujan/296926-update-input-include

update include file

Author: denrea

articles/ai-services/document-intelligence/concept-accuracy-confidence.md

@@ -16,9 +16,10 @@ ms.author: lajanuar
 
 A confidence score indicates probability by measuring the degree of statistical certainty that the extracted result is detected correctly. The estimated accuracy is calculated by running a few different combinations of the training data to predict the labeled values. In this article, learn to interpret accuracy and confidence scores and best practices for using those scores to improve accuracy and confidence results.
 
-
 ## Confidence scores
+
 > [!NOTE]
+>
 > * Field level confidence is getting update to take into account word confidence score starting with **2024-07-31-preview** API version for **custom models**.
 > * Confidence scores for tables, table rows and table cells are available starting with the **2024-07-31-preview** API version for **custom models**.
 

articles/ai-services/document-intelligence/concept-retrieval-augmented-generation.md

@@ -6,8 +6,8 @@ author: laujan
 manager: nitinme
 ms.service: azure-ai-document-intelligence
 ms.topic: conceptual
-ms.date: 02/29/2024
-ms.author: luzhan
+ms.date: 08/13/2024
+ms.author: lajanuar
 monikerRange: '>=doc-intel-3.1.0'
 ---
 
@@ -130,27 +130,27 @@ key = "<api_key>"
 
 from langchain_community.document_loaders import AzureAIDocumentIntelligenceLoader
 from langchain.text_splitter import MarkdownHeaderTextSplitter
- 
+
 # Initiate Azure AI Document Intelligence to load the document. You can either specify file_path or url_path to load the document.
 loader = AzureAIDocumentIntelligenceLoader(file_path="<path to your file>", api_key = key, api_endpoint = endpoint, api_model="prebuilt-layout")
 docs = loader.load()
- 
+
 # Split the document into chunks base on markdown headers.
 headers_to_split_on = [
     ("#", "Header 1"),
     ("##", "Header 2"),
     ("###", "Header 3"),
 ]
 text_splitter = MarkdownHeaderTextSplitter(headers_to_split_on=headers_to_split_on)
- 
+
 docs_string = docs[0].page_content
 splits = text_splitter.split_text(docs_string)
 splits
 ```
+
 > [!div class="nextstepaction"]
 > [View samples on GitHub.](https://github.com/Azure-Samples/document-intelligence-code-samples/blob/main/Python(v4.0)/Retrieval_Augmented_Generation_(RAG)_samples/sample_rag_langchain.ipynb)
 
-
 ## Next steps
 
 * Learn more about [Azure AI Document Intelligence](overview.md).

articles/ai-services/document-intelligence/includes/input-requirements.md

@@ -1,39 +1,37 @@
 ---
 author: laujan
 ms.service: azure-ai-document-intelligence
-ms.custom:
-  - ignite-2023
 ms.topic: include
-ms.date: 11/15/2023
+ms.date: 08/13/2024
 ms.author: lajanuar
 ---
 <!-- markdownlint-disable MD041 -->
 
-* For best results, provide one clear photo or high-quality scan per document.
-
 * Supported file formats:
 
-    |Model | PDF |Image: </br>JPEG/JPG, PNG, BMP, TIFF, HEIF | Microsoft Office: </br> Word (DOCX), Excel (XLSX), PowerPoint (PPTX), and HTML|
-    |--------|:----:|:-----:|:---------------:
+    |Model | PDF |Image: </br>`JPEG/JPG`, `PNG`, `BMP`, `TIFF`, `HEIF` | Microsoft Office: </br> Word (`DOCX`), Excel (`XLSX`), PowerPoint (`PPTX`), HTML|
+    |--------|:----:|:-----:|:---------------:|
     |Read            | ✔    | ✔    | ✔  |
-    |Layout          | ✔  | ✔ | ✔ (2024-02-29-preview, 2023-10-31-preview)  |
+    |Layout          | ✔  | ✔ | ✔ (2024-07-31-preview, 2024-02-29-preview, 2023-10-31-preview)  |
     |General&nbsp;Document| ✔  | ✔ |   |
     |Prebuilt        |  ✔  | ✔ |   |
     |Custom extraction |  ✔  | ✔ |   |
-    |Custom classification  |  ✔  | ✔ | ✔ (2024-02-29-preview)  |
+    |Custom classification  |  ✔  | ✔ | ✔ (2024-07-31-preview, 2024-02-29-preview)  |
+
+* For best results, provide one clear photo or high-quality scan per document.
 
-* For PDF and TIFF, up to 2000 pages can be processed (with a free tier subscription, only the first two pages are processed).
+* For PDF and TIFF, up to 2,000 pages can be processed (with a free tier subscription, only the first two pages are processed).
 
-* The file size for analyzing documents is 500 MB for paid (S0) tier and 4 MB for free (F0) tier.
+* The file size for analyzing documents is 500 MB for paid (S0) tier and `4` MB for free (F0) tier.
 
-* Image dimensions must be between 50 x 50 pixels and 10,000 px x 10,000 pixels.
+* Image dimensions must be between 50 pixels x 50 pixels and 10,000 pixels x 10,000 pixels.
 
 * If your PDFs are password-locked, you must remove the lock before submission.
 
-* The minimum height of the text to be extracted is 12 pixels for a 1024 x 768 pixel image. This dimension corresponds to about `8`-point text at 150 dots per inch (DPI).
+* The minimum height of the text to be extracted is 12 pixels for a 1024 x 768 pixel image. This dimension corresponds to about `8` point text at 150 dots per inch (DPI).
 
 * For custom model training, the maximum number of pages for training data is 500 for the custom template model and 50,000 for the custom neural model.
 
-  * For custom extraction model training, the total size of training data is 50 MB for template model and 1G-MB for the neural model.
+  * For custom extraction model training, the total size of training data is 50 MB for template model and `1` GB for the neural model.
 
-  * For custom classification model training, the total size of training data is `1GB`  with a maximum of 10,000 pages.
+  * For custom classification model training, the total size of training data is `1` GB  with a maximum of 10,000 pages. For 2024-07-31-preview and later, the total size of training data is `2` GB with a maximum of 10,000 pages.

articles/ai-services/translator/document-translation/how-to-guides/create-sas-tokens.md

@@ -6,7 +6,7 @@ ms.topic: how-to
 manager: nitinme
 ms.author: lajanuar
 author: laujan
-ms.date: 02/12/2024
+ms.date: 08/13/2024
 ---
 
 # Create SAS tokens for your storage containers
@@ -82,9 +82,9 @@ Go to the [Azure portal](https://portal.azure.com/#home) and navigate to your co
     * Consider setting a longer duration period for the time you're using your storage account for Translator Service operations.
     * The value of the expiry time is determined by whether you're using an **Account key** or **User delegation key** **Signing method**:
        * **Account key**: While a maximum time limit isn't imposed, best practice recommends that you configure an expiration policy to limit the interval and minimize compromise. [Configure an expiration policy for shared access signatures](/azure/storage/common/sas-expiration-policy).
-       * **User delegation key**: The value for the expiry time is a maximum of seven days from the creation of the SAS token. The SAS is invalid after the user delegation key expires, so a SAS with an expiry time of greater than seven days will still only be valid for seven days. For more information,*see* [Use Microsoft Entra credentials to secure a SAS](/azure/storage/blobs/storage-blob-user-delegation-sas-create-cli#use-azure-ad-credentials-to-secure-a-sas).
+       * **User delegation key**: The value for the expiry time is a maximum of seven days from the creation of the SAS token. The SAS is invalid after the user delegation key expires, so a SAS with an expiry time of greater than seven days will still only be valid for seven days. For more information, *see* [Use Microsoft Entra credentials to secure a SAS](/azure/storage/blobs/storage-blob-user-delegation-sas-create-cli#use-azure-ad-credentials-to-secure-a-sas).
 
-1. The **Allowed IP addresses** field is optional and specifies an IP address or a range of IP addresses from which to accept requests. If the request IP address doesn't match the IP address or address range specified on the SAS token, authorization fails. The IP address or a range of IP addresses must be public IPs, not private. For more information,*see*, [**Specify an IP address or IP range**](/rest/api/storageservices/create-account-sas#specify-an-ip-address-or-ip-range).
+1. The **Allowed IP addresses** field is optional and specifies an IP address or a range of IP addresses from which to accept requests. If the request IP address doesn't match the IP address or address range specified on the SAS token, authorization fails. The IP address or a range of IP addresses must be public IPs, not private. For more information, *see*, [**Specify an IP address or IP range**](/rest/api/storageservices/create-account-sas#specify-an-ip-address-or-ip-range).
 
 1. The **Allowed protocols** field is optional and specifies the protocol permitted for a request made with the SAS. The default value is HTTPS.