new develop agents module

Author: ivorb

.github/agents/learn-module-writer.agent.md

@@ -1,5 +1,5 @@
 ---
-description: Creates a learn unit based on the provided requirementsm by orchestrating multiple subagents.
+description: Creates a learn unit based on the provided requirements by orchestrating multiple subagents.
 model: Claude Sonnet 4.5 (copilot)
 tools:
   ['edit', 'search', 'runTasks', 'microsoft_docs_mcp/*', 'fetch', 'github.vscode-pull-request-github/issue_fetch', 'todos', 'shell', 'synthesia/crt-video', 'synthesia/get-video']

.github/agents/learn-writer.agent.md

@@ -0,0 +1,44 @@
+### YamlMime:LearningPath
+uid: learn.wwl.develop-ai-agents-azure
+hidden: true
+metadata:
+  title: Develop AI Agents on Azure 
+  description: Learn how to develop AI agents on Azure using the Microsoft Foundry Agent Service and Microsoft Agent Framework. AI-3026
+  ms.date: 02/12/2026
+  author: wwlpublish
+  ms.author: berryivor
+  ms.topic: learning-path
+  ms.collection: wwl-ai-copilot
+title: Develop AI agents on Azure
+prerequisites: |
+  Before starting this module, you should be familiar with fundamental AI concepts and services in Azure. Consider completing the [Get started with artificial intelligence](/training/paths/get-started-with-artificial-intelligence-on-azure) learning path first.
+summary: |
+  Generative Artificial Intelligence (AI) is becoming more functional and accessible, and AI agents are a key component of this evolution. This learning path will help you understand the AI agents, including when to use them and how to build them, using Microsoft Foundry Agent Service and Microsoft Agent Framework. By the end of this learning path, you will have the skills needed to develop AI agents on Azure.
+iconUrl: /training/achievements/generic-badge.svg
+levels:
+- intermediate
+roles:
+- ai-engineer
+products:
+- ai-services
+- azure-ai-foundry
+- azure-ai-foundry-agent-service
+- azure-ai-foundry-sdk
+subjects:
+- artificial-intelligence
+- machine-learning
+- natural-language-processing
+modules:
+- learn.wwl.develop-ai-agents-azure-vs-code
+- learn.wwl.build-agent-with-custom-tools
+- learn.wwl.connect-agent-to-mcp-tools
+- learn.wwl.introduction-foundry-iq
+- learn.wwl.build-agent-workflows-microsoft-foundry
+- learn.wwl.develop-multi-agent-azure-ai-foundry
+- learn.wwl.develop-ai-agent-with-semantic-kernel
+- learn.wwl.orchestrate-sk-multi-agent-solution
+- learn.wwl.discover-agents-with-a2a
+
+trophy:
+  uid: learn.wwl.develop-ai-agents-azure.trophy
+

learn-pr/paths/develop-ai-agents-azure/index.yml

@@ -0,0 +1,14 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.develop-ai-agents-azure-vs-code.introduction
+title: Introduction
+metadata:
+  title: Introduction
+  description: Introduction to developing AI agents with Microsoft Foundry and Visual Studio Code.
+  ms.date: 02/12/2026
+  author: ivorb
+  ms.author: berryivor
+  ms.topic: unit
+  ai-usage: ai-generated
+durationInMinutes: 3
+content: |
+  [!include[](includes/1-introduction.md)]

learn-pr/wwl-data-ai/ai-information-extraction/media/azure-ai-vision.png

@@ -0,0 +1,71 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.develop-ai-agents-azure-vs-code.knowledge-check
+title: Knowledge check
+metadata:
+  title: Knowledge Check
+  description: Check your knowledge of AI agent development with Microsoft Foundry.
+  ms.date: 02/12/2026
+  author: ivorb
+  ms.author: berryivor
+  ms.topic: unit
+  ai-usage: ai-generated
+durationInMinutes: 3
+quiz:
+  title: Check your knowledge
+  questions:
+  - content: What is the primary benefit of using Microsoft Foundry Agent Service compared to building agents with standard APIs?
+    choices:
+    - content: It provides access to more powerful AI models
+      isCorrect: false
+      explanation: Incorrect. Microsoft Foundry Agent Service uses the same models available through standard APIs.
+    - content: It requires no Azure subscription
+      isCorrect: false
+      explanation: Incorrect. You need an Azure subscription to use Microsoft Foundry Agent Service.
+    - content: It handles tool calling, state management, and infrastructure automatically
+      isCorrect: true
+      explanation: Correct. Microsoft Foundry Agent Service manages the complexity of tool calling, conversation state, and infrastructure, reducing development effort.
+    - content: It only works with the Azure portal
+      isCorrect: false
+      explanation: Incorrect. Microsoft Foundry Agent Service works with both the Azure portal and Visual Studio Code extension.
+  - content: How does Microsoft Foundry Agent Service handle conversation state?
+    choices:
+    - content: By requiring developers to manually manage conversation history
+      isCorrect: false
+      explanation: Incorrect. The service handles conversation state automatically.
+    - content: Through external database connections
+      isCorrect: false
+      explanation: Incorrect. The service manages state internally without requiring external databases.
+    - content: Through the Responses API which automatically manages conversation context
+      isCorrect: true
+      explanation: Correct. The Responses API handles conversation context automatically, removing the need for manual state management.
+    - content: Using local file storage on the client device
+      isCorrect: false
+      explanation: Incorrect. Conversation state is managed by the service, not stored locally on client devices.
+  - content: Which of the following is NOT a recommended security practice for AI agents?
+    choices:
+    - content: Using role-based access controls
+      isCorrect: false
+      explanation: Incorrect. This is a recommended security practice.
+    - content: Implementing prompt filtering and validation
+      isCorrect: false
+      explanation: Incorrect. This is a recommended security practice to prevent injection attacks.
+    - content: Maintaining comprehensive logging and traceability
+      isCorrect: false
+      explanation: Incorrect. This is a recommended security practice for auditability.
+    - content: Allowing agents unrestricted access to all enterprise data
+      isCorrect: true
+      explanation: Correct. This is NOT recommended. Agents should follow least privilege principles with restricted access based on their specific needs.
+  - content: What happens when an agent determines it needs a tool to respond to a user request?
+    choices:
+    - content: The agent asks the user for permission to use the tool
+      isCorrect: false
+      explanation: Incorrect. Agents don't request permission; they automatically use configured tools.
+    - content: The agent stops processing and waits for developer input
+      isCorrect: false
+      explanation: Incorrect. Agents handle tool invocation automatically without developer intervention.
+    - content: The agent automatically invokes the tool, processes results, and incorporates them into its response
+      isCorrect: true
+      explanation: Correct. Microsoft Foundry Agent Service handles the complete tool-calling lifecycle automatically.
+    - content: The agent sends the request to a separate processing queue
+      isCorrect: false
+      explanation: Incorrect. Tool execution happens synchronously as part of the response generation process.

learn-pr/wwl-data-ai/ai-information-extraction/media/content-understanding.png

@@ -0,0 +1,14 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.develop-ai-agents-azure-vs-code.summary
+title: Summary
+metadata:
+  title: Summary
+  description: Summary of key concepts and next steps for AI agent development.
+  ms.date: 02/12/2026
+  author: ivorb
+  ms.author: berryivor
+  ms.topic: unit
+  ai-usage: ai-generated
+durationInMinutes: 2
+content: |
+  [!include[](includes/11-summary.md)]

learn-pr/wwl-data-ai/ai-information-extraction/media/document-intelligence.png

@@ -0,0 +1,14 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.develop-ai-agents-azure-vs-code.understand-ai-agents-foundry
+title: Understand AI agents and Microsoft Foundry Agent Service
+metadata:
+  title: Understand AI Agents and Microsoft Foundry Agent Service
+  description: Learn about AI agents, their capabilities, use cases, and the features of Microsoft Foundry Agent Service.
+  ms.date: 02/12/2026
+  author: ivorb
+  ms.author: berryivor
+  ms.topic: unit
+  ai-usage: ai-generated
+durationInMinutes: 8
+content: |
+  [!include[](includes/2-understand-ai-agents-foundry.md)]