Information Extraction with Content Understanding
Azure Content Understanding in Foundry Tools is the flagship new topic on AI-901. It did not exist on the old exam, and it is the clearest sign that AI-901 is a builder-focused exam about Microsoft Foundry.
What Content Understanding is
Azure Content Understanding in Foundry Tools is generally available. Its one-line pitch is simple: one service turns documents, images, audio, and video into structured data you define.
That last phrase matters. You define the data shape. Content Understanding is not just OCR, and it is not just a raw generative prompt. It processes content through an analyzer and returns structured JSON that matches the schema you specified. The response can also include confidence scores, grounding, Markdown for retrieval-augmented generation, and content-safety flags.
| Approach | What you ask for | Typical result | Exam distinction |
|---|---|---|---|
| Plain OCR | Read text from a page or image. | Text and layout signals. | Useful, but it does not decide your business fields by itself. |
| Raw generative prompt | Ask a model to summarize or inspect content. | Prose, unless you carefully prompt for structure. | Flexible, but the output shape is not a managed analyzer contract. |
| Content Understanding | Extract, classify, or generate fields defined in a schema. | JSON fields, confidence, grounding, and optional RAG-ready output. | Best answer when the scenario says multimodal, schema-driven extraction. |
Use it when the content is unstructured, mixed-format, or multimodal. A contract, product image, call recording, and training video can all be handled through the same service family. The app does not need separate code paths for every content type if the goal is to turn content into downstream fields.
Analyzers are the core unit
An analyzer is a reusable, configurable processing unit. It sets the content type through baseAnalyzerId, what to pull out through a field schema, the output shape, and which models to use. You create it once and call it repeatedly from your app.
A field schema is a JSON definition of the named fields you want. Fields have types, descriptions, and methods. The description is important because custom analyzers can work zero-shot: you describe the field in plain language, and the analyzer uses that description without requiring labeled training data.
{
"fields": {
"vendorName": {
"type": "string",
"method": "extract",
"description": "The supplier or company name printed on the invoice."
},
"documentType": {
"type": "string",
"method": "classify",
"enum": ["invoice", "receipt", "contract"]
},
"executiveSummary": {
"type": "string",
"method": "generate",
"description": "A concise summary of the content for a business reviewer."
}
}
}The three field methods
| Method | What it does | Use when | Example |
|---|---|---|---|
extract | Copies a value that literally appears in the content. In the brief, this is called out for documents. | The field should come directly from the source. | Invoice number, contract effective date, printed vendor name. |
classify | Assigns one of a predefined set of categories. | The app needs a controlled label. | Document type, product condition, call reason, video scene category. |
generate | Produces a new value using generative AI. | The desired value is not copied directly and requires synthesis. | Summary, risk note, recommended routing explanation. |
Prebuilt and custom analyzers
Prebuilt analyzers are ready-made. Know the families rather than trying to memorize every variant. Content extraction analyzers include prebuilt-read and prebuilt-layout. The four base analyzers are prebuilt-document, prebuilt-image, prebuilt-audio, and prebuilt-video. The four RAG analyzers are prebuilt-documentSearch, prebuilt-imageSearch, prebuilt-audioSearch, and prebuilt-videoSearch. Domain-specific analyzers include prebuilt-invoice, prebuilt-receipt, prebuilt-idDocument, and prebuilt-contract.
Custom analyzers are the exam surprise. They work zero-shot. You can describe the fields in plain language and use the analyzer without labeled examples. Labeled examples are optional and can improve accuracy, but they are not required to start.
Confidence tells you how certain the service is about a field. Grounding tells you where the value came from. In documents and images that can mean bounding boxes. In audio and video it can mean timestamps. This matters because a real extraction app often needs a reviewer experience, not just a final JSON object.
The four content types
Content Understanding is multimodal. The exam may describe a document, image, recording, or video and ask which analyzer family fits. Choose the analyzer that matches the content type and whether the goal is field extraction or RAG indexing.
| Modality | Base analyzer | RAG analyzer | What you would extract |
|---|---|---|---|
| Documents | prebuilt-document | prebuilt-documentSearch | Parties, dates, totals, clauses, obligations, policy topics, invoice fields. |
| Images | prebuilt-image | prebuilt-imageSearch | Product attributes, visible defects, chart values, label text, safety issues. |
| Audio | prebuilt-audio | prebuilt-audioSearch | Call reason, sentiment cue, action items, compliance statements, speaker moments. |
| Video | prebuilt-video | prebuilt-videoSearch | Scenes, actions, timestamps, demonstrated steps, visible issues, training topics. |
Document scenario
A procurement app receives supplier contracts. You define fields for party names, effective date, renewal terms, governing law, and risky clauses. Content Understanding returns those fields in JSON and can ground each value to the source location. For a simpler invoice scenario, you could use a prebuilt invoice analyzer, then route totals and vendor details to an approval workflow.
Image scenario
A retailer receives product photos from stores. You define fields for product type, visible damage, shelf placement, and whether a required label is visible. The analyzer returns structured values instead of a loose caption. For a chart image, you can extract the title, key trend, and visible data points.
Audio scenario
A support center analyzes call recordings. The analyzer can identify the call reason, escalation risk, promised follow-up, and summary. Grounding can point to timestamps so a supervisor can review the moment that produced a field.
Video scenario
A training team processes field service videos. You can extract demonstrated procedure steps, scene timestamps, safety violations, and final outcome. This is different from a generic video summary because the output follows your app schema.
Choosing Content Understanding or Document Intelligence
This is the highest-value exam distinction in objective 2.4. Azure Content Understanding in Foundry Tools and Azure Document Intelligence in Foundry Tools are both active. They are complementary, not replacements for every scenario.
| Situation | Answer | Why |
|---|---|---|
| Images, audio, or video | Content Understanding | Document Intelligence is documents-only. Content Understanding covers all four modalities. |
| No labeled training data | Content Understanding | Custom analyzers work zero-shot from field descriptions. |
| Unstructured documents such as contracts, policies, or legal files | Content Understanding | Generative extraction handles varied language and layouts well. |
| Multimodal RAG | Content Understanding | The RAG analyzer families produce Markdown and searchable representations across modalities. |
| OCR-only or layout extraction | Content Understanding prebuilt-read or prebuilt-layout | These prebuilt analyzers cover text and layout extraction within the Content Understanding family. |
| Standard structured forms needing top accuracy and low latency | Document Intelligence | Purpose-trained prebuilt document models are optimized for common structured forms. |
| Custom extraction with labeled samples on highly structured documents | Document Intelligence custom neural model | When you have labeled examples and a consistent document type, purpose-trained document extraction can be the stronger fit. |
| On-premises or air-gapped deployment | Document Intelligence containers | Document Intelligence has container options. Content Understanding has no container option. |
If a question says document, do not jump too quickly. Ask what kind of document and what constraints matter. A standard receipt at scale points toward Document Intelligence. A long contract with custom business fields and no labeled examples points toward Content Understanding. If the input is not a document, Document Intelligence is not the answer.
Build a lightweight extraction app
AI-901 is a fundamentals exam, but it expects builder thinking. You should recognize the flow of an extraction app even if you are not asked to write production code.
- Create the resource. Work in Microsoft Foundry and use the appropriate Foundry resource and project context.
- Pick or create an analyzer. Choose a prebuilt analyzer when it matches, or create a custom analyzer for your app fields.
- Define the field schema. Name the fields, choose types, write descriptions, and choose
extract,classify, orgenerate. - Call the analyze operation. Send the document, image, audio, or video to the analyzer from your app.
- Read the structured JSON. Inspect field values, confidence scores, grounding, and safety flags.
- Route it downstream. Store fields, trigger approvals, index Markdown for RAG, show low-confidence values for review, or call another workflow.
You can author analyzers in the portal without code. Code still matters for calling the analyzer, handling results, and integrating the output into the rest of the app.
{
"analyzerId": "contract-risk-analyzer",
"status": "succeeded",
"result": {
"fields": {
"counterparty": {
"value": "Contoso Ltd.",
"confidence": 0.94,
"grounding": [{ "page": 1, "box": [1.2, 2.4, 4.8, 2.8] }]
},
"renewalRisk": {
"value": "auto-renewal requires 90 days notice",
"confidence": 0.82,
"grounding": [{ "page": 6, "box": [0.9, 5.1, 7.2, 5.8] }]
}
},
"contentSafety": {
"flagged": false
}
}
}In a real app, you should not treat every field the same. High-confidence grounded fields can flow through automatically. Low-confidence or high-risk fields can be routed to a human reviewer. Generated summaries should be shown with source grounding when the decision matters.
Traps candidates make
- Confusing OCR with extraction. OCR returns text. Content Understanding returns fields you defined.
- Confusing a prompt with an analyzer. A raw prompt can produce prose. An analyzer is reusable and configured with a field schema.
- Assuming custom means trained. Content Understanding custom analyzers can work zero-shot. Labeled examples are optional.
- Ignoring modality. Document Intelligence is documents-only. Content Understanding also handles images, audio, and video.
- Missing grounding. Bounding boxes and timestamps help prove where a field came from.
- Choosing Content Understanding for air-gapped deployment. Content Understanding has no container option; Document Intelligence containers are the answer.
- Using Video Indexer for custom fields. Video Indexer gives prebuilt insights. Content Understanding gives schema-driven extraction.
The night-before cheat sheet
| Concept | Recall |
|---|---|
| Content Understanding | GA Foundry Tool that turns documents, images, audio, and video into structured JSON you define. |
| Analyzer | Reusable processing unit with baseAnalyzerId, field schema, output shape, and model choices. |
| Field schema | JSON definition of named, typed fields and their descriptions. |
| Field methods | extract copies literal values, classify assigns categories, generate creates a new synthesized value. |
| Document analyzers | prebuilt-document and prebuilt-documentSearch. |
| Image analyzers | prebuilt-image and prebuilt-imageSearch. |
| Audio analyzers | prebuilt-audio and prebuilt-audioSearch. |
| Video analyzers | prebuilt-video and prebuilt-videoSearch. |
| Prebuilt analyzers | Include prebuilt-read, prebuilt-layout, base analyzers, RAG analyzers, and domain analyzers such as invoice, receipt, ID document, and contract. |
| Custom analyzers | Work zero-shot from plain-language field descriptions; labeled examples are optional for accuracy. |
| Response contents | Structured fields, confidence scores, grounding, Markdown for RAG, and content-safety flags. |
| CU vs DI rule | Content Understanding is generative and multimodal; Document Intelligence is purpose-trained, deterministic, and documents-only. |