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.md
+12-12Lines changed: 12 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,7 +18,7 @@ This quickstart shows you how to use the Content Understanding service in the [*
18
18
19
19
Suppose you have files—such as documents, images, audio, or video—and you want to automatically extract key information from them. 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. The analyzer becomes an API endpoint that you can integrate into your applications or workflows.
20
20
21
-
In this guide, we walk you through building and testing an analyzer for your scenario. You can start from scratch or use suggested templates for common use cases.
21
+
In this guide, you build and test an analyzer for your scenario. You can start from scratch or use suggested templates for common use cases.
22
22
23
23
:::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" :::
24
24
@@ -28,7 +28,7 @@ To get started, make sure you have the following resources and permissions:
28
28
29
29
* An Azure subscription. If you don't have an Azure subscription, [create a free account](https://azure.microsoft.com/free/).
30
30
31
-
* An [Azure AI Foundry hub-based project](../../../ai-foundry/how-to/create-projects.md) created in one of the following [supported regions](../service-limits.md): `westus`, `swedencentral`, or `australiaeast`. A project is used to organize your work and save state while building customized AI apps. You can create a project from the [home page of AI Foundry](https://aka.ms/foundry-home-page), or the [Content Understanding landing page](https://aka.ms/cu-landing).
31
+
* An [Azure AI Foundry hub-based project](../../../ai-foundry/how-to/create-projects.md) created in one of the following [supported regions](../service-limits.md): `westus`, `swedencentral`, or `australiaeast`. Use a project to organize your work and save state while building customized AI apps. You can create a project from the [home page of AI Foundry](https://aka.ms/foundry-home-page), or the [Content Understanding landing page](https://aka.ms/cu-landing).
32
32
33
33
[!INCLUDE [hub based project required](../../../ai-foundry/includes/uses-hub-only.md)]
34
34
@@ -40,15 +40,15 @@ Follow these steps to create a custom task in the Azure AI Foundry. This task is
40
40
1. Select your hub based project. You might need to select **View all resources** to see your project.
41
41
1. Select **Content Understanding** from the left navigation pane.
42
42
1. Select **+ Create**.
43
-
2. In this guide, you create a `Single-file task` utilizing Content Understanding Standard mode, but if you're interested in creating a multi-file task utilizing Pro mode, refer to [Create an Azure AI Content Understanding multi-file task in the Azure AI Foundry portal](./use-ai-foundry-pro-mode.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).
43
+
1. In this guide, you create a `Single-file task` utilizing Content Understanding Standard mode, but if you're interested in creating a multi-file task utilizing Pro mode, refer to [Create an Azure AI Content Understanding multi-file task in the Azure AI Foundry portal](./use-ai-foundry-pro-mode.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).
44
44
1. Enter a name for your task. Optionally, enter a description and change other settings.
45
45
1. Select **Create**.
46
46
47
47
## Create your first analyzer
48
48
49
-
Now that everything is configured to get started, we can walk through how to build your first analyzer.
49
+
Now that everything is configured, you can build your first analyzer.
50
50
51
-
When you create a single-file Content Understanding task, you start by uploading a sample of your data and building your field schema. The schema is the customizable framework that allows the analyzer to extract insights from your data. In this example, the schema is created to extract key data from an invoice document, but you can bring in any type of 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).
51
+
When you create a single-file Content Understanding task, you start by uploading a sample of your data and building your field schema. The schema is the customizable framework that allows the analyzer to extract insights from your data. In this example, you create the schema to extract key data from an invoice document, but you can bring in any type of 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).
52
52
53
53
1. Upload a [sample file of an invoice document](https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf) or any other data relevant to your scenario.
54
54
@@ -60,7 +60,7 @@ When you create a single-file Content Understanding task, you start by uploading
60
60
61
61
:::image type="content" source="../media/quickstarts/invioce-template.png" alt-text="Screenshot of analyzer templates.":::
62
62
63
-
1. Next, you can add fields to your schema to reflect all of the outputs you want to generate.
63
+
1. Next, add fields to your schema to reflect all of the outputs you want to generate.
64
64
65
65
* Specify clear and simple field names. Some example fields might include **vendorName**, **items**, **price**.
66
66
@@ -70,29 +70,29 @@ When you create a single-file Content Understanding task, you start by uploading
70
70
71
71
* Specify the method to generate the value for each field.
72
72
73
-
For best practices on how to define your field schema, refer to [best practices for Azure AI Content Understanding](../concepts//best-practices.md). It may take a few minutes to build out your schema.
73
+
For best practices on how to define your field schema, refer to [best practices for Azure AI Content Understanding](../concepts//best-practices.md). It might take a few minutes to build out your schema.
74
74
75
-
1.Once you feel that the schema is ready to test, select **Save**. You can always come back and make changes if needed.
75
+
1.When your schema is ready to test, select **Save**. You can always come back and make changes if needed.
76
76
77
77
:::image type="content" source="../media/quickstarts/define-invoice-schema.png" alt-text="Screenshot of completed schema.":::
78
78
79
79
1. With the completed schema, Content Understanding now generates the output on your sample data. At this step, you can add more data to test the analyzer's accuracy or make changes to the schema if needed.
80
80
81
81
:::image type="content" source="../media/quickstarts/test-invoice.png" alt-text="Screenshot of schema testing step.":::
82
82
83
-
1.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.
83
+
1.When 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.
84
84
85
85
:::image type="content" source="../media/quickstarts/build-invoice-analyzer.png" alt-text="Screenshot of built analyzer.":::
86
86
87
-
Now you successfully built your first Content Understanding analyzer, and are ready to start extracting insights from your data. Check out [Quickstart: Azure AI Content Understanding REST APIs](./use-rest-api.md) to utilize the REST API to call your analyzer.
87
+
You've successfully built your first Content Understanding analyzer and are ready to start extracting insights from your data. Check out [Quickstart: Azure AI Content Understanding REST APIs](./use-rest-api.md) to utilize the REST API to call your analyzer.
88
88
89
89
## Sharing your project
90
90
91
-
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:
91
+
To share the project you created and manage access, go to the Management Center. You can find it at the bottom of the navigation pane for your project:
92
92
93
93
:::image type="content" source="../media/quickstarts/cu-landing-page.png" alt-text="Screenshot of where to find management center.":::
94
94
95
-
You can manage the users and their individual roles here:
95
+
In the Management Center, you can manage users and assign individual roles:
96
96
97
97
:::image type="content" source="../media/quickstarts/management-center.png" alt-text="Screenshot of Project users section of management center.":::
0 commit comments