Merge pull request #50503 from MicrosoftDocs/NEW-ai-information-extraction-lp

New ai information extraction lp

Author: ShannonLeavitt

learn-pr/paths/ai-extract-information/index.yml

@@ -0,0 +1,37 @@
+### YamlMime:LearningPath
+uid: learn.ai-extract-information
+metadata:
+  title: Develop AI information extraction solutions in Azure
+  description: Use Azure AI to extract information from content.
+  brand: azure
+  ms.date: 05/15/2025
+  author: GraemeMalcolm
+  ms.author: gmalc
+  ms.topic: learning-path
+title: Develop AI information extraction solutions in Azure
+summary: |
+  Use Azure AI to extract information from content to support scenarios like:
+  - Data capture
+  - Business process automation
+  - Meeting summarization and analysis
+  - Digital asset management (DAM)
+  - Knowledge Mining
+prerequisites: |
+  Before starting this learning path, you should already have:
+  - Familiarity with Azure and Azure AI Foundry.
+  - Experience programming with C# or Python.
+iconUrl: /training/achievements/generic-badge.svg
+levels:
+- intermediate
+roles:
+- ai-engineer
+- developer
+subjects:
+- artificial-intelligence
+products:
+  - ai-services
+modules:
+- learn.wwl.analyze-content-ai
+- learn.wwl.analyze-content-ai-api
+trophy:
+  uid: learn.ai-extract-information.trophy

learn-pr/wwl-data-ai/analyze-content-ai-api/01-introduction.yml

@@ -0,0 +1,16 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.analyze-content-ai-api.introduction
+title: Introduction
+metadata:
+  title: Introduction
+  description: Introduction to analyzing content with the Azure AI Content Understanding API.
+  author: wwlpublish
+  ms.author: gmalc
+  ms.date: 05/15/2025
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+durationInMinutes: 1
+content: |
+  [!include[](includes/01-introduction.md)]
+

learn-pr/wwl-data-ai/analyze-content-ai-api/02-prepare-content-understanding.yml

@@ -0,0 +1,16 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.analyze-content-ai-api.prepare-content-understanding
+title: Prepare to use the AI Content Understanding REST API
+metadata:
+  title: Prepare to use the AI Content Understanding REST API
+  description: Before you can use the REST API, you must prepare your Azure resource.
+  author: wwlpublish
+  ms.author: gmalc
+  ms.date: 05/15/2025
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+durationInMinutes: 5
+content: |
+  [!include[](includes/02-prepare-content-understanding.md)]
+

learn-pr/wwl-data-ai/analyze-content-ai-api/03-create-analyzer.yml

@@ -0,0 +1,15 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.analyze-content-ai-api.create-analyzer
+title: Create a Content Understanding analyzer
+metadata:
+  title: Create a Content Understanding analyzer
+  description: Use the REST API to create a Content Understanding analyzer.
+  author: wwlpublish
+  ms.author: gmalc
+  ms.date: 05/15/2025
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+durationInMinutes: 5
+content: |
+  [!include[](includes/03-create-analyzer.md)]

learn-pr/wwl-data-ai/analyze-content-ai-api/04-analyze.yml

@@ -0,0 +1,15 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.analyze-content-ai-api.analyze
+title: Analyze content
+metadata:
+  title: Analyze content
+  description: Use the REST API to create a client application for an analyzer.
+  author: wwlpublish
+  ms.author: gmalc
+  ms.date: 05/15/2025
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+durationInMinutes: 5
+content: |
+  [!include[](includes/04-analyze.md)]

learn-pr/wwl-data-ai/analyze-content-ai-api/05-exercise.yml

@@ -0,0 +1,15 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.analyze-content-ai-api.exercise
+title: Exercise - Develop a Content Understanding client application
+metadata:
+  title: Exercise - Develop a Content Understanding client application
+  description: Use the Azure AI Content Understanding REST API to extract information from content.
+  author: wwlpublish
+  ms.author: gmalc
+  ms.date: 05/15/2025
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+durationInMinutes: 40
+content: |
+  [!include[](includes/05-exercise.md)]

learn-pr/wwl-data-ai/analyze-content-ai-api/06-knowledge-check.yml

@@ -0,0 +1,49 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.analyze-content-ai-api.knowledge-check
+title: Module assessment
+metadata:
+  title: Module assessment
+  description: Check your knowledge.
+  author: wwlpublish
+  ms.author: gmalc
+  ms.date: 05/15/2025
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+durationInMinutes: 3
+quiz:
+  questions:
+  - content: "What configuration values are needed to use the Azure AI Content Understanding REST API?"
+    choices:
+    - content: "The name of the resource group where the Azure AI service is deployed."
+      isCorrect: false
+      explanation: "Incorrect. The resource group name isn't required to use the REST API."
+    - content: "The Azure subscription ID and tenant ID."
+      isCorrect: false
+      explanation: "Incorrect. The subscription ID and tenant ID aren't required to use the REST API."
+    - content: "The endpoint and key for the Azure AI service."
+      isCorrect: true
+      explanation: "Correct. The endpoint and key are required to use the REST API."
+  - content: "What must be specified when calling the *analyze* method to extract fields from content?"
+    choices:
+    - content: "The name of the Azure AI services resource."
+      isCorrect: false
+      explanation: "Incorrect. The name of the Azure AI services resource isn't required."
+    - content: "The name of the analyzer."
+      isCorrect: true
+      explanation: "Correct. The name of the analyzer is required to extract fields from content."
+    - content: "The Operation-Location returned when the analyzer was created."
+      isCorrect: false
+      explanation: "Incorrect. The Operation-Location isn't required to extract fields from content."
+  - content: "How are the extracted fields returned?"
+    choices:
+    - content: "As type-specific values."
+      isCorrect: true
+      explanation: "Correct. Each field in the results is of a specific data type."
+    - content: "As a list of strings."
+      isCorrect: false
+      explanation: "Incorrect. The extracted fields aren't returned as a list of strings."
+    - content: "As a single blob."
+      isCorrect: false
+      explanation: "Incorrect. The extracted fields aren't returned as a single blob."
+

learn-pr/wwl-data-ai/analyze-content-ai-api/07-summary.yml

@@ -0,0 +1,15 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.analyze-content-ai-api.summary
+title: Summary
+metadata:
+  title: Summary
+  description: Reflect on what you've learned about developing an Azure AI Content Understanding client application.
+  author: wwlpublish
+  ms.author: gmalc
+  ms.date: 05/15/2025
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+durationInMinutes: 1
+content: |
+  [!include[](includes/07-summary.md)]

learn-pr/wwl-data-ai/analyze-content-ai-api/includes/01-introduction.md

@@ -0,0 +1,13 @@
+Azure AI Content Understanding is a multimodal service that simplifies the creation of AI-powered analyzers that can extract information from multiple content formats, including documents, images, audio files, and videos.
+
+> [!TIP]
+> To learn how to build Azure AI Content Understanding analyzers, complete the **[Create a multimodal analysis solution with Azure AI Content Understanding](/training/modules/analyze-content-ai/)** module.
+
+You can develop client applications that use Azure AI Content Understanding analyzers by using the Azure AI Content Understanding REST API; which is the focus of this module.
+
+![Diagram of Azure AI Content Understanding and a client application.](../media/content-understanding.png)
+
+In this module, you'll learn how to write code that uses the REST API to submit a content file to an analyzer and process the results.
+
+> [!NOTE]
+> Azure AI Content Understanding is currently in public preview. Details described in this module are subject to change.

learn-pr/wwl-data-ai/analyze-content-ai-api/includes/02-prepare-content-understanding.md

@@ -0,0 +1,25 @@
+Before you can use the Azure AI Content Understanding REST API, you need an Azure AI services multi-services resource in your Azure subscription. You can provision this resource in the following ways:
+
+- Create an **Azure AI services** resource in the Azure portal.
+- Create an **Azure AI Foundry** hub, which includes an Azure AI services resource by default.
+
+> [!TIP]
+> Creating an Azure AI Foundry hub enables you to work in an Azure AI Foundry project, in which you can use visual tools to create and manage Azure AI Content Understanding schemas and analyzers.
+
+After you've provisioned an Azure AI services resource, you need the following information to connect to the Azure AI Content Understanding REST API from a client application:
+
+- The Azure AI services resource *endpoint*
+- One of the API *keys* associated with the endpoint.
+
+You can obtain these values from the Azure portal, as shown in the following image:
+
+![Screenshot of the Azure AI services settings in the Azure portal.](../media/azure-portal.png)
+
+ If you're working within an Azure AI Foundry project, you can find the endpoint and key for the associated Azure AI services resource in the Azure AI Foundry portal, as shown in the following image:
+
+![Screenshot of the Azure AI services settings in the Azure AI Foundry portal.](../media/azure-ai-services.png)
+
+When working in an Azure AI Foundry project, you can also write code that uses the Azure AI Foundry SDK to connect to the project using Microsoft Entra ID authentication, and retrieve the connection details for the Azure AI services resource; including the endpoint and key.
+
+> [!TIP]
+> To learn more about programming with the Azure AI Foundry SDK, complete the **[Develop an AI app with the Azure AI Foundry SDK](/training/modules/ai-foundry-sdk/)** module.