AI Instructor Live Labs Included

AI-3026: Agent Development on Microsoft Foundry

Build and orchestrate AI agents on Microsoft Foundry — from single-agent function tools + MCP + RAG through the Microsoft Agent Framework and A2A multi-agent patterns. Anchored in the Halcyon Insurance claims-modernization scenario.

Advanced
11h 30m
12 Lessons
AI-3026
AI-3026: Agent Development on Microsoft Foundry Badge

View badge details

About This Course

Design, build, and orchestrate production-quality AI agents on Microsoft Foundry. You will build single agents with the Foundry Agent Service SDK (function tools, MCP tools, RAG grounding via Foundry IQ), then graduate to the Microsoft Agent Framework for multi-agent orchestration and the Agent-to-Agent (A2A) protocol. Every lesson is anchored in Halcyon Insurance, a mid-sized property + auto carrier building an agent platform to accelerate claim resolution you build the pipeline lesson by lesson (intake triage, policy lookup, damage assessment, adjuster brief). Prepares for AI-500 + APL-3032 + APL-3034.

Course Curriculum

12 Lessons
01
AI Lesson
AI Lesson

The Foundry agent landscape

25m

By the end of this lesson you will be able to distinguish between prompt agents and hosted agents on Microsoft Foundry, describe the two Python SDK tracks used to build agents (the Foundry Agent Service SDK and the Microsoft Agent Framework), and know when to reach for each. You will also learn the current name of every legacy service and role in the Foundry ecosystem, so that instructions written against older documentation still work.

The lesson opens with a tour of the Halcyon Insurance claims-modernization scenario the rest of the course builds against, then walks through the Foundry agent primitives, the two SDK tracks, and the current-vs-legacy naming map so nothing you read in a 2025-era study guide trips you up.

02
Lab Exercise
Lab Exercise

Build your first agent in portal + VS Code - Lab Exercises

50m 5 Exercises

Note: This lab pre-provisions Azure Foundry resources at start — allow up to 10 minutes for the environment to become ready before beginning the exercises.

Get hands-on with Microsoft Foundry by building your very first agent — no code required. You will provision a Foundry project, deploy a chat model, and build the Halcyon Insurance intake-triage agent directly in the Foundry portal, then attach the Foundry Toolkit VS Code extension so you can iterate on your agent from an editor. By the end of this lab you will be able to explain the Foundry account → project → agent resource model, build and test a prompt-driven agent, and connect a local VS Code environment to a live Foundry project.

03
AI Lesson
AI Lesson

Function tools + Responses API contract

25m

Learn how to give AI agents on Microsoft Foundry callable Python functions — how the tool_call → tool_result loop works, how tool_choice steers when the agent invokes a tool, and how the platform converts your typed Python signature into a JSON Schema the model can reason about. By the end of this lesson you will be able to design a function tool for a Foundry agent, choose the right tool_choice mode for a given business rule, and diagnose the common failure modes (silent tool_choice=none, mismatched schemas, tool_calls that hallucinate arguments).

04
Lab Exercise
Lab Exercise

Give your agent a custom function tool - Lab Exercises

1h 40m 5 Exercises

Note: This lab pre-provisions Azure Foundry resources at start — allow up to 10 minutes for the environment to become ready before beginning the exercises.

Learn how to extend a Foundry agent with a custom Python function tool so it can reach real business data — the pattern that separates a chatbot from a working assistant. You'll register a typed Python function on a Foundry agent, watch the LLM decide when to call it, and observe how tool_choice controls tool selection. By the end of this lab you will be able to author function tools that a Foundry agent can call to look up business records, and reason about when to force a tool call versus let the model choose.

05
AI Lesson
AI Lesson

MCP for portable agent tools

25m

Learn what the Model Context Protocol (MCP) is, how it separates tools from the agents that use them, and why that separation matters for portability, discovery, and versioning of your agent's capabilities. By the end of this lesson you will be able to explain when to reach for MCP over per-agent function tools, describe the MCP server–client architecture, and identify how Microsoft Foundry consumes MCP tools via the MCPTool primitive.

06
Lab Exercise
Lab Exercise

Extend an agent with MCP tools - Lab Exercises

1h 50m 5 Exercises

Note: This lab pre-provisions Azure Foundry resources at start — allow up to 10 minutes for the environment to become ready before beginning the exercises.

Model Context Protocol (MCP) is how portable, out-of-process tools become part of an agent's tool catalog. By the end of this lab you will be able to publish a Halcyon Insurance parts-and-repair-cost tool set as an MCP server and consume it from a Foundry agent — reusing the same server across multiple agents without redeploying either.

07
AI Lesson
AI Lesson

Grounding agents with enterprise knowledge

20m

Learn how AI agents move from confident-sounding hallucinations to grounded, cited answers when you connect them to your organization's data. You'll explore why grounding matters for agent-scale automation, how Foundry IQ turns scattered enterprise content into a managed knowledge layer, how vector indexes work under the hood, and when to reach for Foundry IQ versus raw Azure AI Search versus the OpenAI Responses file_search built-in tool. By the end of this lesson you will be able to design a Foundry-native RAG grounding strategy for an agent and pick the right retrieval surface for a given scenario.

08
Lab Exercise
Lab Exercise

Add Foundry IQ RAG to an agent - Lab Exercises

1h 35m 5 Exercises

Note: This lab pre-provisions Azure Foundry resources at start — allow up to 10 minutes for the environment to become ready before beginning the exercises.

Ground an AI agent on your organization's document library using Foundry IQ, Microsoft Foundry's native retrieval-augmented-generation surface. By the end of this lab you will be able to bulk-index a policy document library into a Foundry IQ vector index, attach the index as a tool source on a Foundry agent, and compare grounded vs ungrounded agent responses to see how RAG eliminates hallucinations. You'll work in Halcyon Insurance's policy-lookup workflow — indexing four fictional Halcyon coverage documents and building an agent that cites specific policy numbers when it answers questions about deductibles and coverage limits.

09
AI Lesson
AI Lesson

The Microsoft Agent Framework programming model

25m

By the end of this lesson you will be able to explain why Microsoft Foundry ships two Python agent frameworks, articulate when to reach for the Foundry Agent Service SDK versus the Microsoft Agent Framework, describe the object composition of a FoundryChatClient-backed Agent, and identify which orchestration frameworks (Semantic Kernel, LangChain, LangGraph) are intentionally out of scope for this course.

10
Lab Exercise
Lab Exercise

Build an Agent Framework chat agent - Lab Exercises

1h 25m 5 Exercises

Note: This lab pre-provisions Azure Foundry resources at start — allow up to 10 minutes for the environment to become ready before beginning the exercises.

Learn to build production AI agents with the Microsoft Agent Framework — the newer 2026 GA Python SDK that powers multi-agent orchestration and Agent-to-Agent (A2A) federation on Microsoft Foundry. You will use the FoundryChatClient and Agent primitives to build a Halcyon Insurance adjuster expense-reimbursement categorizer, then add streaming and multi-turn conversation state.

By the end of this lab you will be able to build a Microsoft Agent Framework agent that connects to a Foundry model, categorize inputs consistently across runs, stream token output live to a user, and preserve multi-turn conversation state.

11
AI Lesson
AI Lesson

Multi-agent orchestration + A2A protocol

25m

Understand when to reach for a multi-agent design and how to build one on Microsoft Foundry — sequential orchestration, fan-out and join patterns, and the Agent-to-Agent (A2A) protocol for federating agents across processes or organizations. By the end of this lesson you will be able to choose between in-process sequential workflows and A2A federation for a given scenario, sketch a Halcyon claims-triage pipeline that combines both, and explain why the Foundry-native path (Microsoft Agent Framework + A2A) is preferred over third-party orchestrators for exam-prep and production alike.

12
Lab Exercise
Lab Exercise

Multi-agent solution — sequential + A2A - Lab Exercises

1h 45m 6 Exercises

Note: This lab pre-provisions Azure Foundry resources at start — allow up to 10 minutes for the environment to become ready before beginning the exercises.

This capstone lab ties together every layer you have built across AI-3026 — function tools (L4), MCP tools (L6), Foundry IQ grounding (L8), and the Microsoft Agent Framework (L10) — into a production multi-agent claims triage system for Halcyon Insurance. You will build a SequentialBuilder pipeline that composes two local specialist agents (coverage lookup + adjuster brief), federate a third specialist (damage assessment) into its own process using the Agent-to-Agent (A2A) protocol, and inject a fault to observe how the orchestrator handles a remote agent failure.

By the end of this lab you will be able to design, wire, and fault-test a multi-agent solution on Microsoft Foundry — choosing between in-process sequential orchestration and out-of-process A2A federation, and reasoning about the failure modes that come with distributed agent systems.

This course includes:

  • 24/7 AI Instructor Support
  • Live Lab Environments
  • 6 Hands-on Lessons
  • Completion Badge
AI-3026: Agent Development on Microsoft Foundry Badge

Earn Your Badge

Complete all lessons to unlock the AI-3026: Agent Development on Microsoft Foundry achievement badge.

Skill Level Advanced
Total Duration 11h 30m
AI-3026: Agent Development on Microsoft Foundry Badge
Achievement Badge

AI-3026: Agent Development on Microsoft Foundry

Awarded on completion of AI-3026. Recognizes a learner who can build production AI agents on Microsoft Foundry using both the Foundry Agent Service SDK and the Microsoft Agent Framework, and orchestrate multi-agent solutions with the Agent-to-Agent (A2A) protocol.

Course AI-3026: Agent Development on Microsoft Foundry
Criteria Complete all 12 lessons of AI-3026: Agent Development on Microsoft Foundry.

Skills You'll Earn

Microsoft Foundry Agent Service azure-ai-projects SDK Function tools for agents Model Context Protocol (MCP) tools Foundry IQ RAG grounding Microsoft Agent Framework Multi-agent orchestration Agent-to-Agent (A2A) protocol DefaultAzureCredential auth

Complete all lessons in this course to earn this badge