🥇 Thanks for delivering this session!
Prior to delivering the workshop please:
- Read this document and all included resources included in their entirety.
- Watch the video presentation
- Ask questions of the content leads! We're here to help!
| Resource | Link | Type | Description |
|---|---|---|---|
| Session Delivery Deck | Deck | External | Main slide deck for the session |
| Full Session Recording | Recording CodeSpaces | External | Full train-the-trainer recorded session |
| Demo source code | /src demo source |
Internal | Demo source code used in the live demos |
| Prerequisites | Prerequisites |
Internal | Tooling and access required to run the demos |
| Installation | Installation |
Internal | Prepare environment and architecture overview |
| Cloud Resources | Needed Cloud Resources |
Internal | Create cloud resources and deploy agents via console app |
| How to run demo locally | 03.HowToRunDemoLocally |
Internal | Step-by-step instructions to build and run the demo locally |
| How to setup demo environment using CodeSpaces | SetupCodespaces | External | Step-by-step instructions to run the demo using codespaces |
The workshop mixes short live demos with recorded segments for reference.
Note: Times are approximate. Use the
Modeguidance to decide whether to run a demo live or play the recorded fallback.
| Time | Segment | Mode | Notes |
|---|---|---|---|
| 07 mins | Introduction & content | Live | Presenter: lead — slides 1–3 |
| 06 mins | Demo — AI Foundry Agents | Live (recorded fallback) | Recorded demo |
| 04 mins | Content | Live | Key point: agent overview |
| 06 mins | Demo — Aspire + Single Agent | Recorded (recommended) | Recorded demo CodeSpaces |
| 03 mins | Content | Live | Transition & Q&A |
| 07 mins | Demo — Multi-Agent Orchestration | Live (recorded fallback) | Recorded demo CodeSpaces |
| 04 mins | Content | Live | Observability & tracing |
| 02 mins | Demo — Azure Monitor & Diagnostics | Recorded | Recorded demo |
| 04 mins | Content / Q&A | Live | Wrap-up & next steps |
Purpose: a short, actionable checklist to get a presenter ready for a live session. The repo contains more detailed setup steps in ./docs/01.Installation.md — use the checklist below as the final pre-session verification.
Pre-session checklist (30–60 minutes before)
- Clone the repository (or pull latest if already cloned)
- Install prerequisites — follow
session-delivery-resources/docs/Prerequisites.md - Deploy required cloud resources (see
session-delivery-resources/docs/02.NeededCloudResources.md) or confirm they already exist - Follow the instructions in
session-delivery-resources/docs/03.HowToRunDemoLocally.mdto run the demo locally and verify health endpoints
Atomic recovery actions for the most common pre-talk failures. Each row is one command you can paste.
| Symptom | Recovery |
|---|---|
| Aspire stuck / won't start | bash src/cleanup-aspire.sh then aspire run |
| Build fails CS0009 / corrupt ref DLL | dotnet build-server shutdown; Remove-Item -Recurse -Force src\*\obj, src\*\bin; dotnet build src\ZavaAppHost\ZavaAppHost.csproj |
| Build permission error (Linux/macOS) | ./infra/fix_permissions.sh |
| Agent auth fails | az account show → if wrong tenant: az login --tenant <tenant-id> |
| Demo 2 running >10 min | Open Store → Settings → switch to "MAF - Local Agents" (30–60% faster) |
| Foundry HTTP 400 invalid_payload / missing input | Confirm latest git pull (sanitizer + entry-point adapter must be in place) |
If none of these apply, see docs/03.HowToRunDemoLocally.md Troubleshooting.
Fallback & recording guidance
- If a live demo fails (service doesn't start, index not ready, or external resource is inaccessible) — play the recorded demo clip for that segment and mark the runbook with the issue.
- For fragile demos (search/indexing, external APIs), prefer the recorded fallback during high-risk sessions.