Merge pull request #230304 from laujan/69653-second-pass-release-update

JamesJBarnett · web-flow · commit e5d907ad941e · 2023-03-12T14:30:50.000-07:00
update with new models and capabilities
diff --git a/articles/applied-ai-services/form-recognizer/concept-add-on-capabilities.md b/articles/applied-ai-services/form-recognizer/concept-add-on-capabilities.md
@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: conceptual
-ms.date: 03/06/2023
+ms.date: 03/03/2023
 ms.author: lajanuar
 monikerRange: 'form-recog-3.0.0'
 recommendations: false
diff --git a/articles/applied-ai-services/form-recognizer/concept-business-card.md b/articles/applied-ai-services/form-recognizer/concept-business-card.md
@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: conceptual
-ms.date: 03/06/2023
+ms.date: 03/03/2023
 ms.author: lajanuar
 recommendations: false
 ---
diff --git a/articles/applied-ai-services/form-recognizer/concept-composed-models.md b/articles/applied-ai-services/form-recognizer/concept-composed-models.md
@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: conceptual
-ms.date: 03/08/2023
+ms.date: 03/03/2023
 ms.author: lajanuar
 recommendations: false
 ---
diff --git a/articles/applied-ai-services/form-recognizer/concept-custom-classifier.md b/articles/applied-ai-services/form-recognizer/concept-custom-classifier.md
@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: conceptual
-ms.date: 03/08/2023
+ms.date: 03/03/2023
 ms.author: lajanuar
 ms.custom: references_regions
 monikerRange: 'form-recog-3.0.0'
diff --git a/articles/applied-ai-services/form-recognizer/concept-custom-label.md b/articles/applied-ai-services/form-recognizer/concept-custom-label.md
@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: conceptual
-ms.date: 03/09/2023
+ms.date: 03/03/2023
 ms.author: vikurpad
 ms.custom: references_regions
 monikerRange: 'form-recog-3.0.0'
diff --git a/articles/applied-ai-services/form-recognizer/concept-custom-neural.md b/articles/applied-ai-services/form-recognizer/concept-custom-neural.md
@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: conceptual
-ms.date: 03/08/2023
+ms.date: 03/03/2023
 ms.author: lajanuar
 ms.custom: references_regions
 monikerRange: 'form-recog-3.0.0'
diff --git a/articles/applied-ai-services/form-recognizer/concept-custom.md b/articles/applied-ai-services/form-recognizer/concept-custom.md
@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: conceptual
-ms.date: 03/08/2023
+ms.date: 03/03/2023
 monikerRange: '>=form-recog-2.1.0'
 ms.author: lajanuar
 recommendations: false
diff --git a/articles/applied-ai-services/form-recognizer/concept-form-recognizer-studio.md b/articles/applied-ai-services/form-recognizer/concept-form-recognizer-studio.md
@@ -7,7 +7,7 @@ manager: netahw
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: conceptual
-ms.date: 10/14/2022
+ms.date: 03/03/2023
 ms.author: sajagtap
 monikerRange: 'form-recog-3.0.0'
 recommendations: false
@@ -17,7 +17,7 @@ recommendations: false
 
 **This article applies to:** ![Form Recognizer v3.0 checkmark](media/yes-icon.png) **Form Recognizer v3.0**.
 
-[Form Recognizer Studio](https://formrecognizer.appliedai.azure.com/) is an online tool for visually exploring, understanding, and integrating features from the Form Recognizer service into your applications. Use the [Form Recognizer Studio quickstart](quickstarts/try-v3-form-recognizer-studio.md) to get started analyzing documents with pre-trained models. Build custom template models and reference the models in your applications using the [Python SDK v3.0](quickstarts/get-started-sdks-rest-api.md?view=form-recog-3.0.0&preserve-view=true) and other quickstarts.
+[Form Recognizer Studio](https://formrecognizer.appliedai.azure.com/) is an online tool for visually exploring, understanding, and integrating features from the Form Recognizer service into your applications. Use the [Form Recognizer Studio quickstart](quickstarts/try-v3-form-recognizer-studio.md) to get started analyzing documents with pretrained models. Build custom template models and reference the models in your applications using the [Python SDK v3.0](quickstarts/get-started-sdks-rest-api.md?view=form-recog-3.0.0&preserve-view=true) and other quickstarts.
 
 The following image shows the Invoice prebuilt model feature at work.
 
diff --git a/articles/applied-ai-services/form-recognizer/concept-insurance-card.md b/articles/applied-ai-services/form-recognizer/concept-insurance-card.md
@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: conceptual
-ms.date: 03/06/2023
+ms.date: 03/03/2023
 ms.author: lajanuar
 monikerRange: 'form-recog-3.0.0'
 recommendations: false
diff --git a/articles/applied-ai-services/form-recognizer/concept-model-overview.md b/articles/applied-ai-services/form-recognizer/concept-model-overview.md
@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: conceptual
-ms.date: 03/08/2023
+ms.date: 03/03/2023
 ms.author: lajanuar
 recommendations: false
 ---
@@ -48,7 +48,9 @@ recommendations: false
 | [Identity document (ID)](#identity-document-id)  | Extract identity (ID) fields from US driver licenses and international passports. |
 | [Business card](#business-card)  | Scan business cards to extract key fields and data into your applications. |
 |**Custom models**||
-| [Custom models](#custom-models) |  Extract data from forms and documents specific to your business. Custom models are trained for your distinct data and use cases. |
+| [Custom model (overview)](#custom-models) |  Extract data from forms and documents specific to your business. Custom models are trained for your distinct data and use cases. |
+| [Custom extraction models](#custom-extraction)| &#9679; **Custom template models** use layout cues to extract values from documents and are suitable to extract fields from highly structured documents with defined visual templates.</br>&#9679; **Custom neural models** are  trained on various document types to extract fields from structured, semi-structured and unstructured documents.|
+| [Custom classifier model](#custom-classifier)| The **Custom classifier model** can classify each page in an input file to identify the document(s) within and can also identify multiple documents or multiple instances of a single document within an input file.
 | [Composed models](#composed-models) | Combine several custom models into a single model to automate processing of diverse document types with a single composed model.
 
 ### Read OCR
@@ -184,6 +186,31 @@ Version v3.0 custom model supports signature detection in custom forms (template
 > [!div class="nextstepaction"]
 > [Learn more: custom model](concept-custom.md)
 
+#### Custom extraction
+
+[:::image type="icon" source="media/studio/custom-extraction.png":::](https://formrecognizer.appliedai.azure.com/studio/custommodel/projects)
+
+Custom extraction model can be one of two types, **custom template** or **custom neural**. To create a custom extraction model, label a dataset of documents with the values you want extracted and train the model on the labeled dataset. You only need five examples of the same form or document type to get started.
+
+***Sample custom extraction processed using [Form Recognizer Studio](https://formrecognizer.appliedai.azure.com/studio/customform/projects)***:
+
+:::image type="content" source="media/studio/custom-extraction-models.png" alt-text="Screenshot of custom extraction model analysis in Form Recognizer Studio.":::
+
+> [!div class="nextstepaction"]
+> [Learn more: custom template model](concept-custom-template.md)
+
+> [!div class="nextstepaction"]
+> [Learn more: custom neural model](./concept-custom-neural.md)
+
+#### Custom classifier
+
+[:::image type="icon" source="media/studio/custom-classifier.png":::](https://formrecognizer.appliedai.azure.com/studio/custommodel/projects)
+
+The custom classifier model enables you to identify the document type prior to invoking the extraction model.  The classifier model is available starting with the 2023-02-28-preview. Training a custom classifier model requires at least two distinct classes and a minimum of five samples per class.
+
+> [!div class="nextstepaction"]
+> [Learn more: custom classifier model](concept-custom-classifier.md)
+
 #### Composed models
 
 A composed model is created by taking a collection of custom models and assigning them to a single model built from your form types. You can assign multiple custom models to a composed model called with a single model ID. You can assign up to 200 trained custom models to a single composed model.
diff --git a/articles/applied-ai-services/form-recognizer/concept-query-fields.md b/articles/applied-ai-services/form-recognizer/concept-query-fields.md
@@ -41,8 +41,6 @@ For query field extraction, specify the fields you want to extract and Form Reco
 
 * In addition to the query fields, the response includes text, tables, selection marks, general document key-value pairs, and other relevant data.
 
-   :::image type="content" source="media/studio/query-field-analyze.png" alt-text="Screenshot of query field analysis in Form Recognizer Studio.":::
-
 ## Next steps
 
 > [!div class="nextstepaction"]
diff --git a/articles/applied-ai-services/form-recognizer/concept-receipt.md b/articles/applied-ai-services/form-recognizer/concept-receipt.md
@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: conceptual
-ms.date: 03/06/2023
+ms.date: 03/03/2023
 ms.author: lajanuar
 recommendations: false
 ---
diff --git a/articles/applied-ai-services/form-recognizer/faq.yml b/articles/applied-ai-services/form-recognizer/faq.yml
@@ -7,7 +7,7 @@ metadata:
   ms.service: applied-ai-services
   ms.subservice: forms-recognizer
   ms.topic: faq
-  ms.date: 03/09/2023
+  ms.date: 03/03/2023
   ms.author: lajanuar
   monikerRange: '>=form-recog-2.1.0'
   recommendations: false
diff --git a/articles/applied-ai-services/form-recognizer/how-to-guides/build-a-custom-classifier.md b/articles/applied-ai-services/form-recognizer/how-to-guides/build-a-custom-classifier.md
@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: how-to
-ms.date: 03/08/2023
+ms.date: 03/03/2023
 ms.author: lajanuar
 monikerRange: 'form-recog-3.0.0'
 recommendations: false
diff --git a/articles/applied-ai-services/form-recognizer/how-to-guides/compose-custom-models.md b/articles/applied-ai-services/form-recognizer/how-to-guides/compose-custom-models.md
@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: how-to
-ms.date: 03/08/2023
+ms.date: 03/03/2023
 ms.author: lajanuar
 recommendations: false
 ---
diff --git a/articles/applied-ai-services/form-recognizer/how-to-guides/use-sdk-rest-api.md b/articles/applied-ai-services/form-recognizer/how-to-guides/use-sdk-rest-api.md
@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: how-to
-ms.date: 11/18/2022
+ms.date: 03/03/2023
 ms.author: lajanuar
 zone_pivot_groups: programming-languages-set-formre
 recommendations: false
@@ -21,7 +21,7 @@ recommendations: false
 ::: moniker-end
 
 ::: moniker range="form-recog-3.0.0"
- In this guide, you'll learn how to add Form Recognizer models to your applications and workflows using a programming language SDK of your choice or the REST API. Azure Form Recognizer is a cloud-based Azure Applied AI Service that uses machine learning to extract key text and structure elements from documents. We recommend that you use the free service as you're learning the technology. Remember that the number of free pages is limited to 500 per month.
+ In this guide, you learn how to add Form Recognizer models to your applications and workflows using a programming language SDK of your choice or the REST API. Azure Form Recognizer is a cloud-based Azure Applied AI Service that uses machine learning to extract key text and structure elements from documents. We recommend that you use the free service as you're learning the technology. Remember that the number of free pages is limited to 500 per month.
 
 Choose from the following Form Recognizer models to analyze and extract data and values from forms and documents:
 
@@ -33,6 +33,8 @@ Choose from the following Form Recognizer models to analyze and extract data and
 >
 > * The [prebuilt-document](../concept-general-document.md) model extracts key-value pairs, tables, and selection marks from documents and can be used as an alternative to training a custom model without labels.
 >
+> * The [prebuilt-healthInsuranceCard.us](../concept-insurance-card.md) model extracts key information from US health insurance cards.
+>
 > * The [prebuilt-tax.us.w2](../concept-w2.md) model extracts information reported on US Internal Revenue Service (IRS) tax forms.
 >
 > * The [prebuilt-invoice](../concept-invoice.md) model extracts key fields and line items from sales invoices in various formats and quality including phone-captured images, scanned documents, and digital PDFs.
@@ -102,9 +104,9 @@ Congratulations! You've learned to use Form Recognizer models to analyze various
 ::: moniker-end
 
 ::: moniker range="form-recog-2.1.0"
-In this how-to guide, you'll learn how to add Form Recognizer to your applications and workflows using an SDK, in a programming language of your choice, or the REST API. Azure Form Recognizer is a cloud-based Azure Applied AI Service that uses machine learning to extract key-value pairs, text, and tables from your documents. We recommend that you use the free service when you're learning the technology. Remember that the number of free pages is limited to 500 per month.
+In this how-to guide, you learn how to add Form Recognizer to your applications and workflows using an SDK, in a programming language of your choice, or the REST API. Azure Form Recognizer is a cloud-based Azure Applied AI Service that uses machine learning to extract key-value pairs, text, and tables from your documents. We recommend that you use the free service when you're learning the technology. Remember that the number of free pages is limited to 500 per month.
 
-You'll use the following APIs to extract structured data from forms and documents:
+You use the following APIs to extract structured data from forms and documents:
 
 * [Authenticate the client](#authenticate-the-client)
 * [Analyze Layout](#analyze-layout)
diff --git a/articles/applied-ai-services/form-recognizer/includes/input-requirements.md b/articles/applied-ai-services/form-recognizer/includes/input-requirements.md
@@ -3,7 +3,7 @@ author: laujan
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: include
-ms.date: 03/08/2023
+ms.date: 03/03/2023
 ms.author: lajanuar
 ---
 <!-- markdownlint-disable MD041 -->
diff --git a/articles/applied-ai-services/form-recognizer/includes/model-type-name.md b/articles/applied-ai-services/form-recognizer/includes/model-type-name.md
@@ -0,0 +1,17 @@
+---
+author: laujan
+ms.service: applied-ai-services
+ms.subservice: forms-recognizer
+ms.topic: include
+ms.date: 03/03/2023
+ms.author: lajanuar
+---
+
+<!-- markdownlint-disable MD041 -->
+
+| Model type |Model name |
+|------------|-----------|
+|**Document analysis models**| &#9679; [**Read OCR**](../concept-read.md)</br> &#9679; [**Layout analysis**](../concept-layout.md) </br> &#9679; [**General document**](../concept-general-document.md)</br>|
+| **Prebuilt models** |  &#9679; [**Health insurance card**](../concept-insurance-card.md) </br>&#9679; [**W-2 form**](../concept-w2.md) </br>&#9679; [**Invoice**](../concept-invoice.md)</br>&#9679; [**Receipt**](../concept-receipt.md) </br>&#9679; [**Identity (ID) document**](../concept-id-document.md) </br>&#9679; [**Business card**](../concept-business-card.md) </br>
+| **Custom models** | &#9679; [**Custom model overview**](../concept-custom.md)</br> </br>&#9679; **Extraction models**</br>&#8198;&#8198;&Tab;&#65518; [**Custom template**](../concept-custom-template.md)</br>&#8198;&#8198;&Tab;&#65518; [**Custom neural**](../concept-custom-neural.md)</br></br>&#9679; **Classifier model**</br>&#8198;&#8198;&Tab;&#65518; [**Custom classifier**](../concept-custom-classifier.md)</br> </br>&#9679; [**Composed model**](../concept-model-overview.md)|
+|**Gated preview models**</br></br> To request access for gated preview models </br>in Form Recognizer Studio, complete and submit the </br>[**Form Recognizer private preview request form**](https://aka.ms/form-recognizer/preview/survey).|&#9679; [**General document with query fields**](https://formrecognizer.appliedai.azure.com/studio)</br>&#9679; [**Contract**](https://formrecognizer.appliedai.azure.com/studio)</br>&#9679; [**Vaccination card**](https://formrecognizer.appliedai.azure.com/studio)</br>&#9679; [**US 1098 tax form**](https://formrecognizer.appliedai.azure.com/studio)</br>&#9679; [**US 1098-E tax form**](https://formrecognizer.appliedai.azure.com/studio)</br>&#9679; [**US 1098-T tax form**](https://formrecognizer.appliedai.azure.com/studio)
diff --git a/articles/applied-ai-services/form-recognizer/label-tool.md b/articles/applied-ai-services/form-recognizer/label-tool.md
@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: how-to
-ms.date: 03/08/2023
+ms.date: 03/03/2023
 ms.author: lajanuar
 monikerRange: 'form-recog-2.1.0'
 recommendations: false
diff --git a/articles/applied-ai-services/form-recognizer/language-support.md b/articles/applied-ai-services/form-recognizer/language-support.md
@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: reference
-ms.date: 03/09/2023
+ms.date: 03/03/2023
 ---
 
 # Language support for Form Recognizer
diff --git a/articles/applied-ai-services/form-recognizer/managed-identities-secured-access.md b/articles/applied-ai-services/form-recognizer/managed-identities-secured-access.md
@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: how-to
-ms.date: 02/28/2023
+ms.date: 03/03/2023
 ms.author: vikurpad
 monikerRange: '>=form-recog-2.1.0'
 recommendations: false
diff --git a/articles/applied-ai-services/form-recognizer/media/studio/custom-classifier.png b/articles/applied-ai-services/form-recognizer/media/studio/custom-classifier.png
diff --git a/articles/applied-ai-services/form-recognizer/media/studio/custom-extraction-models.png b/articles/applied-ai-services/form-recognizer/media/studio/custom-extraction-models.png
diff --git a/articles/applied-ai-services/form-recognizer/media/studio/custom-extraction.png b/articles/applied-ai-services/form-recognizer/media/studio/custom-extraction.png
diff --git a/articles/applied-ai-services/form-recognizer/media/studio/query-field-analyze.png b/articles/applied-ai-services/form-recognizer/media/studio/query-field-analyze.png
diff --git a/articles/applied-ai-services/form-recognizer/media/studio/welcome-to-studio.png b/articles/applied-ai-services/form-recognizer/media/studio/welcome-to-studio.png
diff --git a/articles/applied-ai-services/form-recognizer/overview.md b/articles/applied-ai-services/form-recognizer/overview.md
@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: overview
-ms.date: 03/08/2023
+ms.date: 03/03/2023
 ms.author: lajanuar
 recommendations: false
 ---
@@ -24,13 +24,9 @@ recommendations: false
 
 ::: moniker range="form-recog-3.0.0"
 
-Azure Form Recognizer is a cloud-based [Azure Applied AI Service](../../applied-ai-services/index.yml) for developers to build intelligent document processing solutions. Form Recognizer applies machine-learning-based optical character recognition (OCR) and document understanding technologies to extract text, tables, structure, and key-value pairs from documents. You can also label and train custom models to automate data extraction from structured, semi-structured, and unstructured documents. To learn more about each model, *see* the Concepts articles:
+Azure Form Recognizer is a cloud-based [Azure Applied AI Service](../../applied-ai-services/index.yml) for developers to build intelligent document processing solutions. Form Recognizer applies machine-learning-based optical character recognition (OCR) and document understanding technologies to classify documents, extract text, tables, structure, and key-value pairs from documents. You can also label and train custom models to automate data extraction from structured, semi-structured, and unstructured documents. To learn more about each model, *see* the Concepts articles:
 
-| Model type | Model name |
-|------------|-----------|
-|**Document analysis models**| &#9679; [**Read OCR model**](concept-read.md)</br> &#9679; [**General document model**](concept-general-document.md)</br> &#9679; [**Layout analysis model**](concept-layout.md) </br>  |
-| **Prebuilt models** | &#9679; [**W-2 form model**](concept-w2.md) </br>&#9679; [**Invoice model**](concept-invoice.md)</br>&#9679; [**Receipt model**](concept-receipt.md) </br>&#9679; [**Identity (ID) document model**](concept-id-document.md) </br>&#9679; [**Business card model**](concept-business-card.md) </br>
-| **Custom models** | &#9679; [**Custom model**](concept-custom.md) </br>&#9679; [**Composed model**](concept-model-overview.md)|
+[!INCLUDE [Models](includes/model-type-name.md)]
 
 ## Which Form Recognizer model should I use?
 
@@ -46,7 +42,8 @@ This section helps you decide which **Form Recognizer v3.0** supported model you
  |**Receipt**|You want to extract key information such as merchant name, transaction date, and transaction total from a sales or single-page hotel receipt. |The receipt is written or printed in a [supported language](language-support.md#receipt-model). |[**Receipt model**](concept-receipt.md)|
 |**Identity document (ID)** like a passport or driver's license. |You want to extract key information such as first name, last name, and date of birth from US drivers' licenses or international passports. |Your ID document is a US driver's license or the biographical page from an international passport (not a visa).| [**Identity document (ID) model**](concept-id-document.md)|
 |**Business card**|You want to extract key information such as first name, last name, company name, email address, and phone number from business cards.|The business card document is in English or Japanese text. | [**Business card model**](concept-business-card.md)|
-|**Mixed-type document(s)**| You want to extract key-value pairs, selection marks, tables, signature fields, and selected regions not extracted by prebuilt or general document models.| You have various documents with structured, semi-structured, and/or unstructured elements.| [**Custom model**](concept-custom.md)|
+|**Application specific documents**| You want to extract key-value pairs, selection marks, tables, signature fields, and selected regions not extracted by prebuilt or general document models.| You have various documents with structured, semi-structured, and/or unstructured elements.| [**Custom extraction model**](concept-custom.md)|
+|**Mixed-type document(s)**| You want to classify documents or split a file into individual documents.| You have various documents with structured, semi-structured, and/or unstructured elements.| [**Custom classification model**](concept-custom.md)|
 
 >[!Tip]
 >
diff --git a/articles/applied-ai-services/form-recognizer/quickstarts/try-form-recognizer-studio.md b/articles/applied-ai-services/form-recognizer/quickstarts/try-form-recognizer-studio.md
diff --git a/articles/applied-ai-services/form-recognizer/sdk-overview.md b/articles/applied-ai-services/form-recognizer/sdk-overview.md
diff --git a/articles/applied-ai-services/form-recognizer/service-limits.md b/articles/applied-ai-services/form-recognizer/service-limits.md
diff --git a/articles/applied-ai-services/form-recognizer/studio-overview.md b/articles/applied-ai-services/form-recognizer/studio-overview.md
diff --git a/articles/applied-ai-services/form-recognizer/toc.yml b/articles/applied-ai-services/form-recognizer/toc.yml
diff --git a/articles/applied-ai-services/form-recognizer/whats-new.md b/articles/applied-ai-services/form-recognizer/whats-new.md
