Official starter templates, end-to-end reference sample, and architecture documentation for the Azure App Platform Copilot Canvas in microsoft/azure-dev-tools: an opinionated serverless and AI-native application platform built around Azure App Service Builder, Microsoft Foundry Hosted Agents / Azure Container Apps, Azure AI Gateway, ACA Sandboxes, Azure Functions Hosted Skills (MCP), Durable Task Scheduler (DTS), Managed Connectors, and Azure SRE Agent.
The interactive Azure App Platform canvas lets you create apps from these templates in isolated Git worktrees, connect Azure AI Gateway and ACA Sandboxes, run and test locally, inspect a live evidence-backed App Map, and deploy to Azure.
- Install from the built-in
awesome-copilotmarketplace:- In GitHub Copilot App: Open Customize -> Plugins, find Azure App Platform in the awesome-copilot marketplace, and select Install.
- Or via Copilot CLI:
copilot plugin install azure-app-platform@awesome-copilot
- Open the canvas by asking in chat:
open Azure App Platform - Choose Create a new app, pick one of the starter templates or the complete Dealership reference sample below, and customize, run, and deploy directly from the side panel.
Canvas source code, companion skills, and release documentation live in microsoft/azure-dev-tools/canvases/azure-app-platform.
Every template follows three architectural guarantees:
- Single governed choke point (
AI Gateway): Front ends talk to the agent, and every outbound call from the agent to models (gpt-latestandgpt-mini-latestaliases backed bygpt-6.2-solandgpt-5-mini) and tools (ACA Sandboxes, Hosted Skills, and workflows) passes through Azure AI Gateway for authentication, Prompt Shields, quotas, routing, and OpenTelemetry tracing. - Environment safety (
ACA Sandboxes): Sensitive PII computation and untrusted document/code execution run inside ephemeral microVMs with no host credentials and a default-deny egress proxy. - Operational self-awareness (
Azure SRE Agent): Telemetry, continuous evaluations, and human-reviewed or autonomous remediation span every application tier from day one.
templates/: All starter templates, the complete Dealership E2E reference app, capability building blocks (build-blocks/), shared port loaders (shared/), and the machine-readabletemplates/catalog.jsonmanifest.docs/: Architecture reference design, Sandbox & AI Gateway pattern guides, boundary validation steps, SRE Agent self-awareness walkthrough, and SVG architecture diagrams (docs/images/).
| Template | Path | Capabilities | What You Get |
|---|---|---|---|
| Sandboxes & AI Gateway Starter | templates/sandbox-gateway-minimal |
Agent · ACA Sandboxes · AI Gateway | Headless Python agent + sandboxed document validation/redaction tool with all model and tool calls governed behind AI Gateway. |
| Sandboxes Minimal Starter | templates/sandboxes-minimal |
Agent · ACA Sandboxes | Single-agent starter dispatching untrusted work to ACA Sandboxes with default-deny egress proxy isolation. |
| App Service Builder: Vite Starter | templates/app-service-builder-vite |
Web (builder.yaml) |
Fast Vite + TypeScript web starter configured for Azure App Service Builder and ready to extend with Hosted Skills. |
| App Service Builder: Agent & AI Gateway | templates/app-service-builder-ai-gateway |
Web (builder.yaml) · Agent · AI Gateway |
Python FastAPI + Microsoft Agent Framework streaming chat app deployable to App Service Builder and wired to AI Gateway. |
| Dealership E2E Reference Sample | templates/dealership-e2e |
Web · Agent · AI Gateway · 4 Hosted Skills · Sandbox · DTS Workflows · Connectors · SRE Agent | Complete runnable car-buying application (driveline-web, deal-finder, inventory-search, trade-in-value, rate-sheet, deal-doc, prequal sandbox, and loan-approval + InventoryReplenishment DTS workflows). |
| Empty Starter App | templates/empty-starter-app |
Web · Agent · AI Gateway · Hosted Skill | Minimal multi-service workspace shell ready to assemble with templates/build-blocks. |
- Provision or connect an Azure AI Gateway for the Dealership sample so
templates/dealership-e2e/src/agent/.envis configured (seetemplates/dealership-e2e/TESTING.mdandtemplates/dealership-e2e/src/README.md):cd templates/dealership-e2e/infra-ai-gateway azd env new app-platform-aigateway azd provision cd ..
- Start the full local live stack (Azurite + all 4 Azure Functions MCP Hosted Skills +
deal-finderagent + Next.js web app):- macOS / Linux:
cd templates/dealership-e2e ./scripts/dev-start.sh - Windows PowerShell 7:
cd templates\dealership-e2e .\scripts\dev-start.ps1
- macOS / Linux:
- Open
http://localhost:3000and try:(StartingFind me an EV under $40,000 with at least 250 miles of rangesrc/webalone without the livedeal-finderagent surfaces an explicitagent_errorbanner with startup guidance rather than simulated replies; loan application submission remains visibly disabled until a submission workflow is connected.)