Skip to content

About

Starter templates for Cloud Foundation and App Platform building blocks, including ACA Sandboxes, AI Gateway, Functions and more from Azure.

Resources

Code of conduct

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

29 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Azure App Platform Templates & Reference Architecture

Agentic Cloud Application: front end to agent to AI Gateway, governing models and tools (ACA Sandboxes, Hosted Skills, and workflows)

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.


Try the Azure App Platform Canvas in GitHub Copilot

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.

  1. Install from the built-in awesome-copilot marketplace:
    • 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
  2. Open the canvas by asking in chat:
    open Azure App Platform
    
  3. 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.


Core Design Principles

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-latest and gpt-mini-latest aliases backed by gpt-6.2-sol and gpt-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.

Repository Layout

  • templates/: All starter templates, the complete Dealership E2E reference app, capability building blocks (build-blocks/), shared port loaders (shared/), and the machine-readable templates/catalog.json manifest.
  • docs/: Architecture reference design, Sandbox & AI Gateway pattern guides, boundary validation steps, SRE Agent self-awareness walkthrough, and SVG architecture diagrams (docs/images/).

Available Templates (/templates)

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.

Standalone Quickstart (Without Canvas)

  1. Provision or connect an Azure AI Gateway for the Dealership sample so templates/dealership-e2e/src/agent/.env is configured (see templates/dealership-e2e/TESTING.md and templates/dealership-e2e/src/README.md):
    cd templates/dealership-e2e/infra-ai-gateway
    azd env new app-platform-aigateway
    azd provision
    cd ..
  2. Start the full local live stack (Azurite + all 4 Azure Functions MCP Hosted Skills + deal-finder agent + 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
  3. Open http://localhost:3000 and try:
    Find me an EV under $40,000 with at least 250 miles of range
    
    (Starting src/web alone without the live deal-finder agent surfaces an explicit agent_error banner with startup guidance rather than simulated replies; loan application submission remains visibly disabled until a submission workflow is connected.)

Documentation (/docs)

About

Starter templates for Cloud Foundation and App Platform building blocks, including ACA Sandboxes, AI Gateway, Functions and more from Azure.

Resources

Code of conduct

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages