Customize

Customize Model Deployment

Interactive guided workflow for deploying Azure OpenAI models with full customization control over version, SKU, capacity, content filtering, and advanced options.

Quick Reference

When to Use This Skill

Use this skill when you need precise control over deployment configuration:

• ✅ Choose specific model version (not just latest)
• ✅ Select deployment SKU (GlobalStandard vs Standard vs PTU)
• ✅ Set exact capacity within available range
• ✅ Configure content filtering (RAI policy selection)
• ✅ Enable advanced features (dynamic quota, priority processing, spillover)
• ✅ PTU deployments (Provisioned Throughput Units)

Alternative: Use preset for quick deployment to the best available region with automatic configuration.

Comparison: customize vs preset

Prerequisites

• Azure subscription with Cognitive Services Contributor or Owner role
• Microsoft Foundry project resource ID (format: /subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.CognitiveServices/accounts/{account}/projects/{project})
• Azure CLI installed and authenticated (az login)
• Optional: Set PROJECT_RESOURCE_ID environment variable

Workflow Overview

Complete Flow (14 Phases)

1. Verify Authentication2. Get Project Resource ID3. Verify Project Exists4. Get Model Name (if not provided)5. List Model Versions → User Selects6. List SKUs for Version → User Selects7. Get Capacity Range → User Configures   7b. If no capacity: Cross-Region Fallback → Query all regions → User selects region/project8. List RAI Policies → User Selects9. Configure Advanced Options (if applicable)10. Configure Version Upgrade Policy11. Generate Deployment Name12. Review Configuration13. Execute Deployment & Monitor

Fast Path (Defaults)

If user accepts all defaults (latest version, GlobalStandard SKU, recommended capacity, default RAI policy, standard upgrade policy), deployment completes in ~5 interactions.

Phase Summaries

⚠️ MUST READ: Before executing any phase, load references/customize-workflow.md [blocked] for the full scripts and implementation details. The summaries below describe what each phase does — the reference file contains the how (CLI commands, quota patterns, capacity formulas, cross-region fallback logic).

Error Handling

Common Issues and Resolutions

Troubleshooting Commands

# Check deployment statusaz cognitiveservices account deployment show --name <account> --resource-group <rg> --deployment-name <name>
# List all deploymentsaz cognitiveservices account deployment list --name <account> --resource-group <rg> -o table
# Check quota usageaz cognitiveservices usage list --name <account> --resource-group <rg>
# Delete failed deploymentaz cognitiveservices account deployment delete --name <account> --resource-group <rg> --deployment-name <name>

Selection Guides & Advanced Topics

For SKU comparison tables, PTU sizing formulas, and advanced option details, load references/customize-guides.md [blocked].

SKU selection: GlobalStandard (production/HA) → Standard (dev/test) → ProvisionedManaged (high-volume/guaranteed throughput) → DataZoneStandard (data residency).

Capacity: TPM-based SKUs range from 1K (dev) to 100K+ (large production). PTU-based use formula: (Input TPM × 0.001) + (Output TPM × 0.002) + (Requests/min × 0.1).

Advanced options: Dynamic quota (GlobalStandard only), priority processing (PTU only, extra cost), spillover (overflow to backup deployment).

Related Skills

• preset - Quick deployment to best region with automatic configuration
• microsoft-foundry - Parent skill for all Microsoft Foundry operations
• quota — For quota viewing, increase requests, and troubleshooting quota errors, defer to this skill instead of duplicating guidance
• rbac - Manage permissions and access control

Notes

• Set PROJECT_RESOURCE_ID environment variable to skip prompt
• Not all SKUs available in all regions; capacity varies by subscription/region/model
• Custom RAI policies can be configured in Azure Portal
• Automatic version upgrades occur during maintenance windows
• Use Azure Monitor and Application Insights for production deployments