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
+11-15Lines changed: 11 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,15 +10,12 @@ ms.date: 05/19/2025
10
10
---
11
11
12
12
# Create an Azure AI Content Understanding single-file task in the Azure AI Foundry portal
13
-
14
-
In this quickstart, you will learn how to use the Content Understanding service in the Azure AI Foundry portal to create a single-file task which will allow you to generate structured outputs from your video, audio, image and document data. The Azure AI Foundry is a comprehensive platform for developing and deploying generative AI applications and APIs responsibly.
15
-
16
-
A few terms to know before getting started:
17
-
***Task**: Your Content Understanding task is the top-level structure that all of your Content Understanding related work falls under. This guide will offer a step by step introduction to creating your field schema.
18
-
***Field schema**: A field schema is the definition of all of the outputs that you want to extract or generate from your data. Content Understanding offers several prebuilt schemas and they are all fully customizable to meet your business needs. This quickstart will offer guidance to help you build the schema that is right for your scenario.
19
-
***Analyzer**: The Content Understanding analyzer allows you to call the field schema you define as an API call in your own solution. You can build as many analyzers as needed within your task.
20
-
21
-
This guide will show you how to build and test a Content Understanding analyzer in the AI Foundry. You can then utilize the analyzer in any app or process you build using a simple REST API call, allowing you to extract meaningful outputs on your data at scale. Content Understanding analyzers are fully customizable. You can create an analyzer by building your own schema from scratch or by using a suggested analyzer template offered to address common scenarios across each data type.
13
+
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
+
16
+
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.
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.
22
19
23
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" :::
24
21
@@ -28,7 +25,7 @@ To get started, make sure you have the following resources and permissions:
28
25
29
26
* An Azure subscription. If you don't have an Azure subscription, [create a free account](https://azure.microsoft.com/free/).
30
27
31
-
* An [Azure AI Foundry hub-based project](../../../ai-foundry/how-to/create-projects.md) created in one of the following supported regions: `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, or the [Content Understanding landing page](aka.ms/cu-landing).
28
+
* 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, or the [Content Understanding landing page](https://aka.ms/foundry-home-page).
32
29
33
30
[!INCLUDE [hub based project required](../../../ai-foundry/includes/uses-hub-only.md)]
34
31
@@ -40,18 +37,17 @@ Follow these steps to create a custom task in the Azure AI Foundry. This task wi
40
37
1. Select your hub based project. You might need to select **View all resources** to see your project.
41
38
1. Select **Content Understanding** from the left navigation pane.
42
39
1. Select **+ Create**.
43
-
2. In this guide, you will select 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
44
-
](./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).
40
+
2. In this guide, you will 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).
45
41
1. Enter a name for your task. Optionally, enter a description and change other settings.
46
42
1. Select **Create**.
47
43
48
44
## Create your first analyzer
49
45
50
46
Now that everything is configured to get started, we can walk through how to build your first analyzer.
51
47
52
-
When you create a single-file Content Understanding task, you'll 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. [Compare the output of this invoice analysis use case to the output of a Content Understanding Pro invoice analysis scenario](). For a complete list of supported file types, see [input file limits](../service-limits.md#input-file-limits).
48
+
When you create a single-file Content Understanding task, you'll 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).
53
49
54
-
1. Upload a sample file of an invoice document or any other data relevant to your scenario.
50
+
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.
55
51
56
52
:::image type="content" source="../media/quickstarts/upload-data.png" alt-text="Screenshot of upload step in user experience.":::
57
53
@@ -71,7 +67,7 @@ When you create a single-file Content Understanding task, you'll start by upload
71
67
72
68
* Specify the method to generate the value for each field.
73
69
74
-
For best practices on how to define your field schema, refer to [best practices for Azure AI Content Understanding](./best-practices.md).
70
+
For best practices on how to define your field schema, refer to [best practices for Azure AI Content Understanding](./best-practices.md). It may take a few minutes to build out your schema.
75
71
76
72
1. Once you feel that the schema is ready to test, select **Save**. You can always come back and make changes if needed.
0 commit comments