Merge pull request #50237 from GraemeMalcolm/main

Refresh AI Vision Analyze Images module

Author: JillGrant615

learn-pr/wwl-data-ai/.openpublishing.redirection.wwl-data-ai.json

@@ -5040,6 +5040,10 @@
     {
       "source_path_from_root": "/learn-pr/wwl-data-ai/orchestrate-semantic-kernel-multi-agent-solution/7-summary.yml",
       "redirect_url": "/training/modules/orchestrate-semantic-kernel-multi-agent-solution/8-summary"
+    },
+    {
+      "source_path_from_root": "/learn-pr/wwl-data-ai/analyze-images/4-generate-smart-cropped-thumbnail.yml",
+      "redirect_url": "/azure/ai-services/computer-vision/overview-image-analysis"
     }
   ]
 }

learn-pr/wwl-data-ai/analyze-images/1-introduction.yml

@@ -1,18 +1,18 @@
-### YamlMime:ModuleUnit
-uid: learn.wwl.analyze-images.introduction
-title: Introduction
-metadata:
-  title: Introduction
-  description: Introduction
-  author: wwlpublish
-  ms.author: berryivor
-  ms.date: 02/05/2024
-  ms.topic: unit
-  ms.collection:
-    - wwl-ai-copilot
-azureSandbox: false
-labModal: false
-durationInMinutes: 3
-content: |
-  [!include[](includes/1-introduction.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.wwl.analyze-images.introduction
+title: Introduction
+metadata:
+  title: Introduction
+  description: Introduction
+  author: wwlpublish
+  ms.author: berryivor
+  ms.date: 04/30/2025
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+azureSandbox: false
+labModal: false
+durationInMinutes: 3
+content: |
+  [!include[](includes/1-introduction.md)]
+

learn-pr/wwl-data-ai/analyze-images/2-provision-computer-vision-resource.yml

@@ -1,18 +1,18 @@
-### YamlMime:ModuleUnit
-uid: learn.wwl.analyze-images.provision-computer-vision-resource
-title: Provision an Azure AI Vision resource
-metadata:
-  title: Provision an Azure AI Vision resource
-  description: Provision an Azure AI Vision resource
-  author: wwlpublish
-  ms.author: berryivor
-  ms.date: 02/05/2024
-  ms.topic: unit
-  ms.collection:
-    - wwl-ai-copilot
-azureSandbox: false
-labModal: false
-durationInMinutes: 3
-content: |
-  [!include[](includes/2-provision-computer-vision-resource.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.wwl.analyze-images.provision-computer-vision-resource
+title: Provision an Azure AI Vision resource
+metadata:
+  title: Provision an Azure AI Vision resource
+  description: Provision an Azure AI Vision resource
+  author: wwlpublish
+  ms.author: berryivor
+  ms.date: 04/30/2025
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+azureSandbox: false
+labModal: false
+durationInMinutes: 3
+content: |
+  [!include[](includes/2-provision-computer-vision-resource.md)]
+

learn-pr/wwl-data-ai/analyze-images/3-analyze-image.yml

@@ -1,20 +1,20 @@
-### YamlMime:ModuleUnit
-uid: learn.wwl.analyze-images.analyze-image
-title: Analyze an image
-metadata:
-  title: Analyze an image
-  description: Analyze an image
-  author: wwlpublish
-  ms.author: berryivor
-  ms.date: 02/05/2024
-  ms.topic: unit
-  ms.collection:
-    - wwl-ai-copilot
-  ms.custom: devx-track-python
-  zone_pivot_groups: dev-lang-csharp-python
-azureSandbox: false
-labModal: false
-durationInMinutes: 3
-content: |
-  [!include[](includes/3-analyze-image.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.wwl.analyze-images.analyze-image
+title: Analyze an image
+metadata:
+  title: Analyze an image
+  description: Analyze an image
+  author: wwlpublish
+  ms.author: berryivor
+  ms.date: 04/30/2025
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+  ms.custom: devx-track-python
+  zone_pivot_groups: dev-lang-csharp-python
+azureSandbox: false
+labModal: false
+durationInMinutes: 3
+content: |
+  [!include[](includes/3-analyze-image.md)]
+

learn-pr/wwl-data-ai/analyze-images/4-generate-smart-cropped-thumbnail.yml

@@ -1,19 +1,16 @@
-### YamlMime:ModuleUnit
-uid: learn.wwl.analyze-images.exercise-computer-vision
-title: Exercise - Analyze images with Azure AI Vision
-metadata:
-  title: Exercise - Analyze images with Azure AI Vision
-  description: Exercise - Analyze images with Azure AI Vision
-  author: wwlpublish
-  ms.author: berryivor
-  ms.date: 02/05/2024
-  ms.topic: unit
-  ms.collection:
-    - wwl-ai-copilot
-azureSandbox: false
-labId: 152411
-labModal: true
-durationInMinutes: 30
-content: |
-  [!include[](includes/5-exercise-computer-vision.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.wwl.analyze-images.exercise-computer-vision
+title: Exercise - Analyze images with Azure AI Vision
+metadata:
+  title: Exercise - Analyze images with Azure AI Vision
+  description: Exercise - Analyze images with Azure AI Vision
+  author: wwlpublish
+  ms.author: berryivor
+  ms.date: 04/30/2025
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+durationInMinutes: 30
+content: |
+  [!include[](includes/5-exercise-computer-vision.md)]
+

learn-pr/wwl-data-ai/analyze-images/5-exercise-computer-vision.yml

@@ -1,41 +1,41 @@
-### YamlMime:ModuleUnit
-uid: learn.wwl.analyze-images.knowledge-check
-title: Module assessment
-metadata:
-  title: Module assessment
-  description: Knowledge check
-  author: wwlpublish
-  ms.author: berryivor
-  ms.date: 08/29/2024
-  ms.topic: unit
-  ms.collection:
-    - wwl-ai-copilot
-azureSandbox: false
-labModal: false
-durationInMinutes: 2
-quiz:
-  title: "Check your knowledge"
-  questions:
-  - content: "You want to use the Azure AI Vision Analyze Image function to generate an appropriate caption for an image. Which visual feature should you specify?"
-    choices:
-    - content: "Tags"
-      isCorrect: false
-      explanation: "That's incorrect. To generate a caption, include the DenseCaptions visual feature in your analysis."
-    - content: "DenseCaptions"
-      isCorrect: true
-      explanation: "That's correct. To generate a caption, include the DenseCaptions visual feature in your analysis."
-    - content: "Objects"
-      isCorrect: false
-      explanation: "That's incorrect. To generate a caption, include the DenseCaptions visual feature in your analysis."
-  - content: "What is the purpose of the Azure AI Vision service?"
-    choices:
-    - content: "To provide functionality for audio transcription"
-      isCorrect: false
-      explanation: "Incorrect. The Azure AI Vision service is designed to extract information from images, not audio."
-    - content: "To extract information from images"
-      isCorrect: true
-      explanation: "The Azure AI Vision service is designed to help you extract information from images through various functionalities."
-    - content: "To detect the presence and location of specific sounds within an audio file"
-      isCorrect: false
-      explanation: "Incorrect. The Azure AI Vision service is designed to extract information from images, not audio."
-
+### YamlMime:ModuleUnit
+uid: learn.wwl.analyze-images.knowledge-check
+title: Module assessment
+metadata:
+  title: Module assessment
+  description: Knowledge check
+  author: wwlpublish
+  ms.author: berryivor
+  ms.date: 04/30/2025
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+azureSandbox: false
+labModal: false
+durationInMinutes: 2
+quiz:
+  title: "Check your knowledge"
+  questions:
+  - content: "What is the purpose of the Azure AI Vision service?"
+    choices:
+    - content: "To provide functionality for audio transcription"
+      isCorrect: false
+      explanation: "Incorrect. The Azure AI Vision service is designed to extract information from images, not audio."
+    - content: "To extract information from images"
+      isCorrect: true
+      explanation: "The Azure AI Vision service is designed to help you extract information from images through various functionalities."
+    - content: "To detect the presence and location of specific sounds within an audio file"
+      isCorrect: false
+      explanation: "Incorrect. The Azure AI Vision service is designed to extract information from images, not audio."
+  - content: "You want to use the Azure AI Vision Analyze Image function to generate an appropriate caption for an image. Which visual feature should you specify?"
+    choices:
+    - content: "Tags"
+      isCorrect: false
+      explanation: "Incorrect. To generate a caption, include the DenseCaptions visual feature in your analysis."
+    - content: "DenseCaptions"
+      isCorrect: true
+      explanation: "Correct. To generate a caption, include the DenseCaptions visual feature in your analysis."
+    - content: "Objects"
+      isCorrect: false
+      explanation: "Incorrect. To generate a caption, include the DenseCaptions visual feature in your analysis."
+

learn-pr/wwl-data-ai/analyze-images/6-knowledge-check.yml

@@ -1,18 +1,18 @@
-### YamlMime:ModuleUnit
-uid: learn.wwl.analyze-images.summary
-title: Summary
-metadata:
-  title: Summary
-  description: Summary
-  author: wwlpublish
-  ms.author: berryivor
-  ms.date: 02/05/2024
-  ms.topic: unit
-  ms.collection:
-    - wwl-ai-copilot
-azureSandbox: false
-labModal: false
-durationInMinutes: 3
-content: |
-  [!include[](includes/7-summary.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.wwl.analyze-images.summary
+title: Summary
+metadata:
+  title: Summary
+  description: Summary
+  author: wwlpublish
+  ms.author: berryivor
+  ms.date: 04/30/2025
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+azureSandbox: false
+labModal: false
+durationInMinutes: 3
+content: |
+  [!include[](includes/7-summary.md)]
+

learn-pr/wwl-data-ai/analyze-images/7-summary.yml

@@ -1,10 +1,18 @@
-Azure AI Vision is a branch of artificial intelligence (AI) in which software interprets visual input, often from images or video feeds.
+Computer Vision is a branch of artificial intelligence (AI) in which software interprets visual input, often from images or video feeds. In Microsoft Azure, you can use the **Azure AI Vision** service to implement multiple computer vision scenarios, including:
 
-In this module, you'll learn how to use the **Azure AI Vision** service to extract information from images.
+- Image analysis
+- Optical character recognition (OCR)
+- Face detection and analysis
+- Video analysis
 
-After completing this module, you’ll be able to:
+In this module, we'll focus on *image analysis*, and explore how to build applications that use the Azure AI Vision service to analyze and extract and infer insights from images.
+
+![Diagram of the Azure AI Vision service performing image analysis tasks.](../media/computer-vision.png)
+
+As shown in this conceptual diagram, the Azure AI Vision service provides services that you can use to analyze images and:
+
+1. Generate a *caption* for an image based on its contents.
+2. Suggest appropriate *tags* to associate with an image.
+3. Detect and locate common *objects* in an image.
+4. Detect and locate *people* in an image.
 
-- Provision an Azure AI Vision resource.
-- Analyze an image.
-- Remove an image background.
-- Generate a smart cropped thumbnail.

learn-pr/wwl-data-ai/analyze-images/includes/1-introduction.md

@@ -1,18 +1,30 @@
-The **Azure AI Vision** service is designed to help you extract information from images. It provides functionality that you can use for:
+To use Azure AI Vision image analysis services, you need to provision an Azure AI Vision resource in your Azure subscription. You can choose from multiple provisioning options:
 
-- *Description and tag generation* - determining an appropriate caption for an image, and identifying relevant "tags" that can be used as keywords to indicate its subject.
-- *Object detection* - detecting the presence and location of specific objects within the image.
-- *People detection* - detecting the presence, location, and features of people in the image.
-- *Image metadata, color, and type analysis* - determining the format and size of an image, its dominant color palette, and whether it contains clip art.
-- *Category identification* - identifying an appropriate categorization for the image, and if it contains any known landmarks.
-- *Background removal* - detecting the background in an image and output the image with the background transparent or a greyscale alpha matte image.
-- *Moderation rating* - determine if the image includes any adult or violent content.
-- *Optical character recognition* - reading text in the image.
-- *Smart thumbnail generation* - identifying the main region of interest in the image to create a smaller "thumbnail" version.
+![Diagram of AI Foundry containing AI services, which in turn contain AI Vision.](../media/ai-vision-resources.png)
 
-![A conceptual image of the Azure AI Vision service](../media/computer-vision.png)
+1. Create an **Azure AI Foundry** *project* and an associated *hub*. By default, an Azure AI Foundry hub includes an **Azure AI services** multi-service resource, which includes Azure AI Vision. Azure AI Foundry projects are recommended for development of AI solutions on Azure that combine generative AI, agents, and pre-built Azure AI services, or which involve collaborative development by a team of software engineers and service operators.
+1. If you don't need all of the functionality in an Azure AI Foundry hub, you can create an **Azure AI services** multi-service resource in your Azure subscription. You can then use this resource to access Azure AI Vision services and other AI services through a single endpoint and key.
+1. If you only need to use Azure AI Vision functionality, or you're just experimenting with the service, you can create a standalone **Computer Vision** resource in your Azure subscription. One benefit of this approach is that the standalone service provides a free tier that you can use to explore the service at no cost.
 
-You can provision **Azure AI Vision** as a single-service resource, or you can use the Azure AI Vision API in a multi-service **Azure AI Services** resource.
+> [!TIP]
+> If you're unfamiliar with Azure AI Foundry and Azure AI services, consider completing the **[Plan and prepare to develop AI solutions on Azure](/training/modules/prepare-azure-ai-development/)** module.
+
+## Connecting to your resource
+
+After you've deployed your resource, you can use the [Azure AI Vision REST API](/rest/api/computervision/image-analysis?azure-portal=true) or a language-specific SDK (such as the [Python SDK](/python/api/overview/azure/ai-vision-imageanalysis-readme?azure-portal=true) or [Microsoft .NET SDK](/dotnet/api/overview/azure/ai.vision.imageanalysis-readme?azure-portal=true)) to connect to it from a client application.
+
+Every Azure AI Vision resource provides an *endpoint* to which client applications must connect. You can find the endpoint for your resource in the Azure portal, or if you're working in an Azure AI Foundry project, in the Azure AI Foundry portal. The endpoint is in the form of a URL, and typically looks something like this:
+
+```
+https://<resource_name>.cognitiveservices.azure.com/
+```
+
+To connect to the endpoint, client applications must be authenticated. Options for authentication include:
+
+- **Key-based authentication**: Client applications are authenticated by passing an authorization key (which you can find and manage in the portal).
+- **Microsoft Entra ID authentication**: Client applications are authenticated by using a Microsoft Entra ID token for credentials that have permission to access the Azure AI Vision resource in Azure.
+
+When developing and testing an application, it's common to use key-based authentication or Microsoft Entra ID authentication based on your own Azure credentials. In production, consider using Microsoft Entra ID authentication based on a managed identity for your Azure application or use Azure Key Vault to store authorization keys securely.
 
 > [!NOTE]
-> In this module, we'll focus on the image analysis and thumbnail generation capabilities of the Azure AI Vision service. To learn how to use the Azure AI Vision service for optical character recognition, check out the [Read Text in images and documents with the Azure AI Vision service](/training/modules/read-text-images-documents-with-computer-vision-service/) module.
+> When using an Azure AI services resource in an Azure AI Foundry project, you can use the Azure AI Foundry SDK to connect to the project using Microsoft Entra ID authentication, and then retrieve the connection information for your Azure AI services resource, including the authorization key, from the project.