Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into manlint

Author: dlepow

articles/ai-services/.openpublishing.redirection.ai-services.json

@@ -115,6 +115,11 @@
             "redirect_url": "/azure/ai-services/translator/document-translation/reference/rest-api-guide",
             "redirect_document_id": false
           },
+          {
+            "source_path_from_root": "/articles/ai-services/openai/how-to/monitoring.md",
+            "redirect_url": "/azure/ai-services/openai/how-to/monitor-openai",
+            "redirect_document_id": false
+          },
           {
             "source_path_from_root": "/articles/ai-services/openai/how-to/prepare-dataset.md",
             "redirect_url": "/azure/ai-services/openai/concepts/fine-tuning-considerations",

articles/ai-services/content-safety/overview.md

@@ -156,7 +156,7 @@ To use the Content Safety APIs, you must create your Azure AI Content Safety res
 | France Central | ✅ | | | |✅ | | ✅|
 | West Europe | ✅ | ✅ |✅ | |✅ | |✅ |
 | Japan East | ✅ | | | |✅ | |✅ |
-| Australia East| ✅ | ✅ | | |✅ | ✅| ✅|
+| Australia East| ✅ |  | | |✅ | ✅| ✅|
 | USGov Arizona | ✅ | | | | | | |
 | USGov Virginia | ✅ | | | | | | |
 

articles/ai-services/content-safety/quickstart-groundedness.md

@@ -69,8 +69,9 @@ Create a new Python file named _quickstart.py_. Open the new file in your prefer
     ```Python
     import http.client
     import json
-    
-    conn = http.client.HTTPSConnection("<endpoint>/contentsafety/text:detectGroundedness?api-version=2024-02-15-preview")
+
+    endpoint = "<your_custom_subdomain>.cognitiveservices.azure.com"
+    conn = http.client.HTTPSConnection(endpoint)
     payload = json.dumps({
       "domain": "Generic",
       "task": "QnA",
@@ -81,7 +82,7 @@ Create a new Python file named _quickstart.py_. Open the new file in your prefer
       "groundingSources": [
         "I'm 21 years old and I need to make a decision about the next two years of my life. Within a week. I currently work for a bank that requires strict sales goals to meet. IF they aren't met three times (three months) you're canned. They pay me 10/hour and it's not unheard of to get a raise in 6ish months. The issue is, **I'm not a salesperson**. That's not my personality. I'm amazing at customer service, I have the most positive customer service \"reports\" done about me in the short time I've worked here. A coworker asked \"do you ask for people to fill these out? you have a ton\". That being said, I have a job opportunity at Chase Bank as a part time teller. What makes this decision so hard is that at my current job, I get 40 hours and Chase could only offer me 20 hours/week. Drive time to my current job is also 21 miles **one way** while Chase is literally 1.8 miles from my house, allowing me to go home for lunch. I do have an apartment and an awesome roommate that I know wont be late on his portion of rent, so paying bills with 20hours a week isn't the issue. It's the spending money and being broke all the time.\n\nI previously worked at Wal-Mart and took home just about 400 dollars every other week. So I know i can survive on this income. I just don't know whether I should go for Chase as I could definitely see myself having a career there. I'm a math major likely going to become an actuary, so Chase could provide excellent opportunities for me **eventually**."
       ],
-      "reasoning": false
+      "reasoning": False
     })
     headers = {
       'Ocp-Apim-Subscription-Key': '<your_subscription_key>',

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

@@ -90,7 +90,7 @@ Field extraction custom generative model `2024-07-31-preview` version is only av
 
 * **Field Description**. Provide more contextual information in description to help clarify the field that needs to be extracted. Examples include location in the document, potential field labels it can be associated with, and ways to differentiate with other terms that could be ambiguous.
 
-* **Variation**. Custom generative models can generalize across different document templates of the same document type. As a best practice, create a single model for all variations of a document type. Ideally, include a visual template for each type, especially for ones that
+* **Variation**. Custom generative models can generalize across different document templates of the same document type. As a best practice, create a single model for all variations of a document type. Ideally, include a visual template for each type, especially for ones that involve distinct formatting or structural elements, to improve the model's accuracy and consistency in generating or processing documents.
 
 ## Service guidance
 

articles/ai-services/document-intelligence/concept-mortgage-documents.md

@@ -26,6 +26,8 @@ The Document Intelligence Mortgage models use powerful Optical Character Recogni
 **Supported document types:**
 
 * Uniform Residential Loan Application (Form 1003)
+* Uniform Residential Appraisal Report (Form 1004)
+* Verification of employment form (Form 1005)
 * Uniform Underwriting and Transmittal Summary (Form 1008)
 * Closing Disclosure form
 
@@ -38,7 +40,7 @@ Document Intelligence v4.0 (2024-07-31-preview) supports the following tools, ap
 
 | Feature | Resources | Model ID |
 |----------|-------------|-----------|
-|**Mortgage model**|&bullet; [**Document Intelligence Studio**](https://formrecognizer.appliedai.azure.com)</br>&bullet;  [**REST API**](/rest/api/aiservices/operation-groups?view=rest-aiservices-v4.0%20(2024-07-31-preview)&preserve-view=true)</br>&bullet;  [**C# SDK**](quickstarts/get-started-sdks-rest-api.md?view=doc-intel-4.0.0&preserve-view=true)</br>&bullet;  [**Python SDK**](quickstarts/get-started-sdks-rest-api.md?view=doc-intel-4.0.0&preserve-view=true)</br>&bullet;  [**Java SDK**](quickstarts/get-started-sdks-rest-api.md?view=doc-intel-4.0.0&preserve-view=true)</br>&bullet;  [**JavaScript SDK**](quickstarts/get-started-sdks-rest-api.md?view=doc-intel-4.0.0&preserve-view=true)|**&bullet; prebuilt-mortgage.us.1003</br>&bullet; prebuilt-mortgage.us.1008</br>&bullet; prebuilt-mortgage.us.closingDisclosure**|
+|**Mortgage model**|&bullet; [**Document Intelligence Studio**](https://formrecognizer.appliedai.azure.com)</br>&bullet;  [**REST API**](/rest/api/aiservices/operation-groups?view=rest-aiservices-v4.0%20(2024-07-31-preview)&preserve-view=true)</br>&bullet;  [**C# SDK**](quickstarts/get-started-sdks-rest-api.md?view=doc-intel-4.0.0&preserve-view=true)</br>&bullet;  [**Python SDK**](quickstarts/get-started-sdks-rest-api.md?view=doc-intel-4.0.0&preserve-view=true)</br>&bullet;  [**Java SDK**](quickstarts/get-started-sdks-rest-api.md?view=doc-intel-4.0.0&preserve-view=true)</br>&bullet;  [**JavaScript SDK**](quickstarts/get-started-sdks-rest-api.md?view=doc-intel-4.0.0&preserve-view=true)|**&bullet; prebuilt-mortgage.us.1003</br>&bullet; prebuilt-mortgage.us.1004</br>&bullet; prebuilt-mortgage.us.1005</br>&bullet; prebuilt-mortgage.us.1008</br>&bullet; prebuilt-mortgage.us.closingDisclosure**|
 ::: moniker-end
 
 ## Input requirements
@@ -126,74 +128,6 @@ The following are the fields extracted from a 1003 URLA form in the JSON output
 |`Property.MixedUseProperty`|`selectionGroup`|Is the property a mixed-use property?|:selected: NO:unselected: YES|
 |`Property.ManufacturedHome`|`selectionGroup`|Is the property a manufactured home?|:selected: NO:unselected: YES|
 
-## [2024-02-29-preview](#tab/2024-02-29-preview)
-
-
-### Supported languages and locales
-
-
-
-| Supported Languages | Details |
-|:--------------------|:-------:|
-|English|United States (`en-US`)|
-
-
-### Supported document fields
-
-#### mortgage.us.1003
-
-| Field | Type | Description | Example |
-|:------|:-----|:------------|:--------|
-|`LenderLoanNumber`|`string`|Lender loan number or universal loan identifier|10Bx939c5543TqA1144M999143X38|
-|`AgencyCaseNumber`|`string`|Agency case number|115894|
-|`Borrower`|`object`|||
-|`Borrower.Name`|`string`|Borrower's full name as written on the form|Gwen Stacy|
-|`Borrower.SocialSecurityNumber`|`string`|Borrower's social security number|557-99-7283|
-|`Borrower.BirthDate`|`date`|Borrower's date of birth|11/07/1989|
-|`Borrower.CitizenshipType`|`selectionGroup`|Borrower's citizenship|:selected: U.S. Citizen<br>:unselected: Permanent Resident Alien<br>:unselected: Non-Permanent Resident Alien|
-|`Borrower.CreditApplicationType`|`selectionGroup`|Borrower's credit type|:selected: I'm applying for individual credit.<br>:unselected: I'm applying for joint credit.|
-|`Borrower.NumberOfBorrowers`|`integer`|Total number of borrowers|1|
-|`Borrower.MaritalStatus`|`selectionGroup`|Borrower's marital status|:selected: Married<br>:unselected: Separated<br>:unselected: Unmarried|
-|`Borrower.NumberOfDependents`|`integer`|Total number of borrower's dependents|2|
-|`Borrower.DependentsAges`|`string`|Age of borrower's dependents|10, 11|
-|`Borrower.HomePhoneNumber`|`phoneNumber`|Borrower's home phone number|(818) 246-8900|
-|`Borrower.CellPhoneNumber`|`phoneNumber`|Borrower's cell phone number|(831) 728-4766|
-|`Borrower.WorkPhoneNumber`|`phoneNumber`|Borrower's work phone number|(987) 213-5674|
-|`Borrower.CurrentAddress`|`address`|Borrower's current address|1634 W Glenoaks Blvd<br>Glendale CA 91201 United States|
-|`Borrower.YearsInCurrentAddress`|`integer`|Years in current address|1|
-|`Borrower.MonthsInCurrentAddress`|`integer`|Months in current address|1|
-|`Borrower.CurrentHousingExpenseType`|`selectionGroup`|Borrower's housing expense type|:unselected: No primary housing expense:selected: Own:unselected: Rent|
-|`Borrower.CurrentMonthlyRent`|`number`|Borrower's monthly rent|1,600.00|
-|`Borrower.SignedDate`|`date`|Borrower's signature date|03/16/2021|
-|`CoBorrower`|`object`|||
-|`CoBorrower.Names`|`string`|Coborrowers' names|Peter Parker<br>Mary Jane Watson|
-|`CoBorrower.SignedDate`|`date`|Coborrower's signature date|03/16/2021|
-|`CurrentEmployment`|`object`|||
-|`CurrentEmployment.DoesNotApply`|`boolean`|Checkbox state of 'Doesn't apply'|:selected:|
-|`CurrentEmployment.EmployerName`|`string`|Borrower's employer or business name|Spider Wb Corp.|
-|`CurrentEmployment.EmployerPhoneNumber`|`phoneNumber`|Borrower's employer phone number|(390) 353-2474|
-|`CurrentEmployment.EmployerAddress`|`address`|Borrower's employer address|3533 Band Ave<br>Glendale CA 92506 United States|
-|`CurrentEmployment.PositionOrTitle`|`string`|Borrower's position or title|Language Teacher|
-|`CurrentEmployment.StartDate`|`date`|Borrower's employment start date|01/08/2020|
-|`CurrentEmployment.GrossMonthlyIncomeTotal`|`number`|Borrower's gross monthly income total|4,254.00|
-|`Loan`|`object`|||
-|`Loan.Amount`|`number`|Loan amount|156,000.00|
-|`Loan.PurposeType`|`selectionGroup`|Loan purpose type|:unselected: Purchase:selected: Refinance:unselected: Other|
-|`Loan.OtherPurpose`|`string`|Other loan purpose type|Construction|
-|`Loan.RefinanceType`|`selectionGroup`|Loan refinance type|:selected: No Cash Out<br>:unselected: Limited Cash Out<br>:unselected: Cash Out|
-|`Loan.RefinanceProgramType`|`selectionGroup`|Loan refinance program type|:unselected: Full Documentation:selected: Interest Rate Reduction<br>:unselected: Streamlined without Appraisal<br>:unselected: Other|
-|`Loan.OtherRefinanceProgram`|`string`|Other loan refinance program type|Cash-out refinance|
-|`Property`|`object`|||
-|`Property.Address`|`address`|Property address|1634 W Glenoaks Blvd<br>Glendale CA 91201 Los Angeles|
-|`Property.NumberOfUnits`|`integer`|Number of units|1|
-|`Property.Value`|`number`|Property value|200,000.00|
-|`Property.OccupancyStatus`|`selectionGroup`|Property occupancy status|:selected: Primary Residence<br>:unselected: Second Home<br>:unselected: Investment Property|
-|`Property.IsFhaSecondaryResidence`|`boolean`|Checkbox state of '`FHA` Secondary Residence'|:unselected:|
-|`Property.MixedUseProperty`|`selectionGroup`|Is the property a mixed-use property?|:selected: NO:unselected: YES|
-|`Property.ManufacturedHome`|`selectionGroup`|Is the property a manufactured home?|:selected: NO:unselected: YES|
-
-
-The 1003 URLA key-value pairs and line items extracted are in the `documentResults` section of the JSON output.
 
 ## Field extraction 1004 Uniform Residential Appraisal Report (URAR)
 The following are the fields extracted from a 1004 URAR form in the JSON output response.
@@ -404,4 +338,4 @@ The mortgage closing disclosure key-value pairs and line items extracted are in
 * Try processing your own forms and documents with the [Document Intelligence Studio](https://formrecognizer.appliedai.azure.com/studio).
 
 * Complete a [Document Intelligence quickstart](quickstarts/get-started-sdks-rest-api.md?view=doc-intel-3.0.0&preserve-view=true) and get started creating a document processing app in the development language of your choice.
- 
+ 

articles/ai-services/document-intelligence/index.yml

@@ -7,12 +7,10 @@ metadata:
   title: Document Intelligence documentation - Quickstarts, Tutorials, API Reference - Azure AI services | Microsoft Docs
   description: Azure AI Document Intelligence is a cloud-based Azure AI service that uses machine-learning models to extract key-value pairs, text, and tables from your documents. Document Intelligence analyzes your forms and documents, extracts text and data, maps field relationships as key-value pairs, and returns a structured JSON output. You quickly get accurate results that are tailored to your specific content without excessive manual intervention or extensive data science expertise. Use Document Intelligence to automate your data processing in applications and workflows, enhance data-driven strategies, and enrich document search capabilities.
   ms.service: azure-ai-document-intelligence
-  ms.custom:
-    - ignite-2023
   ms.topic: landing-page
   author: laujan
   ms.author: lajanuar
-  ms.date: 01/31/2024
+  ms.date: 08/21/2024
   monikerRange: '<=doc-intel-4.0.0'
 # linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | tutorial | video | whats-new
 # Limits: https://learn.learn.microsoft.com/help/contribute/contribute-how-to-write-landing-page?branch=main#limits
@@ -33,79 +31,74 @@ landingContent:
         links:
           - text: What's new in Azure AI Document Intelligence?
             url: whats-new.md
-      - linkListType: reference
-        links:
-           - text: 🆕 SDK overview `2024-02-29-preview` (v4.0 preview)
-             url: sdk-overview-v4-0.md
-           - text: SDK overview `2023-07-31` latest (v3.1 GA)
-             url: sdk-overview-v3-1.md
-           - text: SDK overview `2022-08-31` legacy (v3.0 GA)
-             url: sdk-overview-v3-0.md
-
-#Card 2
-   - title: Document Intelligence Studio
-     linkLists:
-      - linkListType: overview
-        links:
-          - text: Studio overview
-            url: studio-overview.md
-          - text: Studio concepts
-            url: concept-document-intelligence-studio.md
 
-  #Card 3
+  #Card 2
    - title: Document Intelligence models
      linkLists:
-     - linkListType: architecture
+     - linkListType: learn
        links:
          - text: Read
            url: concept-read.md
          - text: Layout
            url: concept-layout.md
-         - text: Invoice
-           url: concept-invoice.md
-         - text: Receipt
-           url: concept-receipt.md
-         - text: ID document
-           url: concept-id-document.md
-         - text: Health insurance card
-           url: concept-health-insurance-card.md
-         - text: Contract
-           url: concept-contract.md
-         - text: US tax documents
-           url: concept-tax-document.md
+         - text: Financial Services and Legal
+           url: overview.md#financial-services-and-legal
+         - text: US Tax
+           url: overview.md#us-tax
+         - text: Personal identification
+           url: overview.md#personal-identification
+         - text: Custom field extraction
+           url: overview.md#document-field-extraction-models
+         - text: Custom classification
+           url: overview.md#custom-classification-models
+         - text: Add-on capabilities
+           url: concept-add-on-capabilities.md
+         - text: Query field extraction
+           url:  concept-query-fields.md
 
+  #Card 3
+   - title: Document Intelligence Studio
+     linkLists:
+     - linkListType: overview
+       links:
+         - text: Studio overview
+           url: studio-overview.md
+         - text: Studio concepts
+           url: concept-document-intelligence-studio.md
   #Card 4
    - title: Document Intelligence concepts
      linkLists:
          - linkListType: concept
            links:
-             - text: 🆕 Query field extraction
-               url:  concept-query-fields.md
-             - text: 🆕 Add-on capabilities
-               url:  concept-add-on-capabilities.md
-             - text: 🆕 Retrieve-Augmented Generation (RAG)
+             - text: 🆕 Custom generative model
+               url:  concept-custom-generative.md
+             - text: 🆕 Retrieval-Augmented Generation (RAG)
                url:  concept-retrieval-augmented-generation.md
-         - linkListType: concept
-           links:
-             - text: Pretrained model overview
-               url: concept-model-overview.md
+             - text: 🆕 Batch document analysis
+               url:  concept-batch-analysis.md
              - text: Accuracy and confidence scores
                url: concept-accuracy-confidence.md
-             - text: "API response: analyze document"
+             - text: Use the analyzeDocument response
                url: concept-analyze-document-response.md
              - text: Custom model overview
                url: concept-custom.md
-
-
-  #Card 5
-   - title: Quickstarts and how-to-guides
+  # Card 5
+   - title: Responsible AI
      linkLists:
-      - linkListType: quickstart
+      - linkListType: reference
         links:
-        - text: Document Intelligence Studio
-          url: quickstarts/try-document-intelligence-studio.md
-        - text: Document Intelligence SDK
-          url: quickstarts/get-started-sdks-rest-api.md
+           - text: Transparency notes
+             url: /legal/cognitive-services/document-intelligence/transparency-note?toc=/azure/ai-services/document-intelligence/toc.json&bc=/azure/ai-services/document-intelligence/breadcrumb/toc.json
+           - text: Characteristics and limitations
+             url:  /legal/cognitive-services/document-intelligence/characteristics-and-limitations?toc=/azure/ai-services/document-intelligence/toc.json&bc=/azure/ai-services/document-intelligence/breadcrumb/toc.json
+           - text: Guidance for integration and responsible use
+             url: /legal/cognitive-services/document-intelligence/guidance-integration-responsible-use?toc=/azure/ai-services/document-intelligence/toc.json&bc=/azure/ai-services/document-intelligence/breadcrumb/toc.json
+           - text: Data privacy, compliance, and security
+             url: /legal/cognitive-services/document-intelligence/data-privacy-security?toc=/azure/ai-services/document-intelligence/toc.json&bc=/azure/ai-services/document-intelligence/breadcrumb/toc.json#Card 5
+   
+   # Card 6
+   - title: How-to-guides
+     linkLists:
       - linkListType: how-to-guide
         links:
           - text: Create a Document Intelligence resource
@@ -123,16 +116,4 @@ landingContent:
           - text: Install and run Document Intelligence containers
             url: containers/install-run.md
 
-# Card 6
-   - title: Responsible AI
-     linkLists:
-      - linkListType: reference
-        links:
-           - text: Transparency notes
-             url: /legal/cognitive-services/document-intelligence/transparency-note?toc=/azure/ai-services/document-intelligence/toc.json&bc=/azure/ai-services/document-intelligence/breadcrumb/toc.json
-           - text: Characteristics and limitations
-             url:  /legal/cognitive-services/document-intelligence/characteristics-and-limitations?toc=/azure/ai-services/document-intelligence/toc.json&bc=/azure/ai-services/document-intelligence/breadcrumb/toc.json
-           - text: Guidance for integration and responsible use
-             url: /legal/cognitive-services/document-intelligence/guidance-integration-responsible-use?toc=/azure/ai-services/document-intelligence/toc.json&bc=/azure/ai-services/document-intelligence/breadcrumb/toc.json
-           - text: Data privacy, compliance, and security
-             url: /legal/cognitive-services/document-intelligence/data-privacy-security?toc=/azure/ai-services/document-intelligence/toc.json&bc=/azure/ai-services/document-intelligence/breadcrumb/toc.json
+