You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/ai-services/content-understanding/quickstart/use-ai-foundry-pro-mode.md
+18-18Lines changed: 18 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,9 +13,9 @@ ms.date: 05/29/2025
13
13
14
14
This quickstart shows you how to use the Content Understanding service in the Azure AI Foundry portal to extract structured information from your data. Azure AI Foundry enables you to build and deploy generative AI applications and APIs responsibly.
15
15
16
-
Suppose you have document files and you want to automatically extract key information from them, while also comparing to reference data to infer conclusions from your files. With Content Understanding, you can create a task to organize your data processing, define a field schema that specifies the information to extract or generate, and then build an analyzer that will apply reasoning to your data to output key inferences and conclusions. The analyzer becomes an API endpoint that you can integrate into your applications or workflows.
16
+
Suppose you have document files and you want to automatically extract key information from them, while also comparing to reference data to infer conclusions from your files. Using Content Understanding, you can create a task to streamline your data processing, define a field schema to specify the information to extract or generate, and develop an analyzer that applies reasoning to your data, delivering key insights and conclusions. The analyzer becomes an API endpoint that you can integrate into your applications or workflows.
17
17
18
-
In this guide, you'll walk through building and testing an analyzer for your scenario. You can start from scratch or use suggested templates for common use cases.
18
+
In this guide, we walk through building and testing an analyzer for your scenario. You can start from scratch or use suggested templates for common use cases.
19
19
20
20
:::image type="content" source="../media/overview/component-overview-updated.png" alt-text="Screenshot of Content Understanding overview, process, and workflow." lightbox="../media/overview/component-overview-updated.png" :::
21
21
@@ -31,25 +31,25 @@ To get started, make sure you have the following resources and permissions:
31
31
32
32
## Create your multi-file task powered by Content Understanding Pro mode
33
33
34
-
Follow these steps to create a custom task in the Azure AI Foundry. This task will be used to build your first analyzer.
34
+
Follow these steps to create a custom task in the Azure AI Foundry. This task is used to build your first analyzer.
35
35
36
36
1. Go to the **Home** page of [Azure AI Foundry](https://ai.azure.com).
37
37
1. Select your hub based project. You might need to select **View all resources** to see your project.
38
38
1. Select **Content Understanding** from the left navigation pane.
39
39
1. Select **+ Create**.
40
-
2. In this guide, you will select a `multi-file task` utilizing Content Understanding Pro mode, but if you're interested in creating a single-file task utilizing Standard mode, refer to [Create an Azure AI Content Understanding single-file task in the Azure AI Foundry portal](./use-ai-foundry.md). For more information on which mode is right for your scenario, check out [Azure AI Content Understanding pro and standard modes](../concepts/standard-pro-modes.md).
40
+
2. In this guide, we use a `multi-file task` utilizing Content Understanding Pro mode, but if you're interested in creating a single-file task utilizing Standard mode, refer to [Create an Azure AI Content Understanding single-file task in the Azure AI Foundry portal](./use-ai-foundry.md). For more information on which mode is right for your scenario, check out [Azure AI Content Understanding pro and standard modes](../concepts/standard-pro-modes.md).
41
41
1. Enter a name for your task. Optionally, enter a description and change other settings.
42
42
1. Select **Create**.
43
43
44
44
## Create your first analyzer
45
45
46
-
When you create a multi-file Content Understanding task, you'll start by uploading one or more samples of data and building your field schema. The schema is the customizable framework that guides the analyzer to extract the preferred insights from your data.
46
+
To create a multi-file Content Understanding task, start by uploading one or more samples of data and building your field schema. The schema is the customizable framework that guides the analyzer to extract the preferred insights from your data.
47
47
48
48
In this example, the schema is created to extract key fields from an invoice document, but you can bring in any document based data and the steps remain the same. For a complete list of supported file types, see [input file limits](../service-limits.md#input-file-limits).
49
49
50
50
1. Upload one or multiple sample files of invoice documents or any other document data relevant to your scenario.
51
51
52
-
:::image type="content" source="../media/quickstarts/upload-test-data.png" alt-text="Screenshot of upload step in user experience.":::
52
+
:::image type="content" source="../media/quickstarts/upload-test-data.png" alt-text="Screenshot of upload step in user experience." lightbox="../media/quickstarts/upload-test-data.png":::
53
53
54
54
2. Add fields to your schema:
55
55
@@ -60,29 +60,29 @@ In this example, the schema is created to extract key fields from an invoice doc
60
60
**[Optional]* Provide field descriptions to explain the desired behavior, including any exceptions or rules.
61
61
62
62
* Specify the method to generate the value for each field.
63
-
64
-
:::image type="content" source="../media/quickstarts/add-fields.png" alt-text="Screenshot of create schema step in user experience.":::
65
63
66
-
64
+
:::image type="content" source="../media/quickstarts/add-fields.png" alt-text="Screenshot of create schema step in user experience." lightbox="../media/quickstarts/add-fields.png":::
65
+
66
+
67
67
3. Once you feel that the schema is ready to test, select **Save**. You can always come back and make changes if needed.
68
68
69
-
:::image type="content" source="../media/quickstarts/save-schema.png" alt-text="Screenshot of completed schema.":::
69
+
:::image type="content" source="../media/quickstarts/save-schema.png" alt-text="Screenshot of completed schema." lightbox="../media/quickstarts/save-schema.png":::
70
70
71
71
4. Upload one or more documents for reference data for the service to analyze. Adding reference data allows the model to compare and apply multi-step reasoning to your test data in order to infer conclusions about that data.
72
72
73
-
:::image type="content" source="../media/quickstarts/reference-data.png" alt-text="Screenshot of user adding reference data.":::
73
+
:::image type="content" source="../media/quickstarts/reference-data.png" alt-text="Screenshot of user adding reference data." lightbox="../media/quickstarts/reference-data.png":::
74
74
75
-
5. Run analysis on your data. Kicking off analysis generates an output on your test files based on the schema that you just created, and applies predictions by comparing that output to your reference data.
75
+
5. Run analysis on your data. Kicking off analysis generates an output on your test files based on the schema that you created, and applies predictions by comparing that output to your reference data.
76
76
77
-
:::image type="content" source="../media/quickstarts/prediction.png" alt-text="Screenshot of user running analysis on their data.":::
77
+
:::image type="content" source="../media/quickstarts/prediction.png" alt-text="Screenshot of user running analysis on their data." lightbox="../media/quickstarts/prediction.png":::
78
78
79
79
6. Once you're satisfied with the quality of your output, select **Build analyzer**. This action creates an analyzer ID that you can integrate into your own applications, allowing you to call the analyzer from your code.
80
80
81
-
:::image type="content" source="../media/quickstarts/build-analyzer.png" alt-text="Screenshot of built analyzer.":::
81
+
:::image type="content" source="../media/quickstarts/build-analyzer.png" alt-text="Screenshot of built analyzer." lightbox="../media/quickstarts/build-analyzer.png":::
82
82
83
-
Now you successfully built your first Content Understanding analyzer, and are ready to start extracting insights from your data. When you select the analyzer you just created, you can view sample code to get started with implenting this in code.
83
+
Now you successfully built your first Content Understanding analyzer, and are ready to start extracting insights from your data. You can select the analyzer you created and view sample code to get started.
84
84
85
-
:::image type="content" source="../media/quickstarts/view-code.png" alt-text="Screenshot of sample code.":::
85
+
:::image type="content" source="../media/quickstarts/view-code.png" alt-text="Screenshot of sample code." lightbox="../media/quickstarts/view-code.png":::
86
86
87
87
Check out [Quickstart: Azure AI Content Understanding REST APIs](./use-rest-api.md) to utilize the REST API to call your analyzer.
88
88
@@ -91,12 +91,12 @@ Check out [Quickstart: Azure AI Content Understanding REST APIs](./use-rest-api.
91
91
92
92
In order to share and manage access to the project you created, navigate to the Management Center, found at the bottom of the navigation for your project:
93
93
94
-
:::image type="content" source="../media/quickstarts/cu-landing-page.png" alt-text="Screenshot of where to find management center.":::
94
+
:::image type="content" source="../media/quickstarts/cu-landing-page.png" alt-text="Screenshot of where to find management center." lightbox="../media/quickstarts/cu-landing-page.png":::
95
95
96
96
97
97
You can manage the users and their individual roles here:
98
98
99
-
:::image type="content" source="../media/quickstarts/management-center.png" alt-text="Screenshot of Project users section of management center.":::
99
+
:::image type="content" source="../media/quickstarts/management-center.png" alt-text="Screenshot of Project users section of management center." lightbox="../media/quickstarts/management-center.png":::
0 commit comments