Skip to content

Microsoft Foundry Advanced Workshop

Welcome to an advanced, docs-first Microsoft Foundry workshop focused on hosted agents.

This workshop is the sequel to the beginner Foundry workshop. It assumes you already have a Foundry resource, project, and model deployment. If you don't, complete the beginner workshop first.

The examples use lightweight healthcare and life-sciences scenarios so the workshop stays consistent across all lessons. Every exercise is based on official Microsoft documentation and the microsoft-foundry/foundry-samples repository.

Workshop source repository: beyondelastic/foundry-advanced-workshop

This workshop is intentionally small, practical, and tied to official Microsoft documentation. Each section includes:

  • a clear goal
  • official reference links
  • one or more runnable Python examples
  • expected results
  • a short verification checklist

Official by default

Every core exercise is mapped to Microsoft Learn or the official Foundry samples repository.

Python only

The examples stay in one language so you can focus on Foundry concepts instead of SDK translation.

Built for practitioners

Each exercise builds on the previous one. The agent evolves from a basic assistant to a tool-equipped, cloud-connected hosted agent.

What this workshop covers

Lesson Topic
00 Prerequisites azd CLI, agent extension, supported regions, environment setup
01 Your First Hosted Agent Deploy a containerized agent with Microsoft Agent Framework
02 Tools & File Persistence @tool decorator, per-session sandbox filesystem, session isolation
03 LangGraph Hosted Agent Same hosted agent concepts rebuilt with LangGraph
04 Foundry Toolbox Code Interpreter, Web Search via Toolbox MCP endpoint

Design goals

  • Keep the flow easy to follow.
  • Favour official documentation over custom theory.
  • Keep examples short and runnable.
  • Use a lightweight docs-first web UI.

Official sources used

Repository layout

.
├── docs/           ← lesson pages (served by MkDocs)
├── examples/
│   ├── 01-first-hosted-agent/
│   ├── 02-tools-and-files/
│   ├── 03-langgraph/
│   └── 04-toolbox/
├── infra/           ← Bicep for ACR + role assignment
├── mkdocs.yml
├── requirements.txt
├── .env.example
└── SETUP.md

Quick start

1. Clone the repository and set up the Python environment:

git clone https://github.com/beyondelastic/foundry-advanced-workshop.git
cd foundry-advanced-workshop
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

2. Sign in to Azure:

az login
azd auth login

3. Configure your environment variables:

cp .env.example .env   # fill in your values

4. Follow the lessons on this site starting with Prerequisites.

Full setup instructions are in SETUP.md.