/microsoft-foundry

Create Foundry Resource

This sub-skill orchestrates creation of Azure AI Services multi-service resources using Azure CLI.

Important: All resource creation operations are control plane (management) operations. Use Azure CLI commands as the primary method.

Note: For monitoring resource usage and quotas, use the microsoft-foundry:quota skill.

Table of Contents: Quick Reference · When to Use · Prerequisites · Core Workflows · Important Notes · Additional Resources

Quick Reference

When to Use

Use this sub-skill when you need to:

• Create Foundry resource - Provision new Azure AI Services multi-service account
• Create resource group - Set up resource group before creating resources
• Register resource provider - Enable Microsoft.CognitiveServices provider
• Manual resource creation - CLI-based resource provisioning

Do NOT use for:

• Creating ML workspace hubs/projects (use microsoft-foundry:project/create)
• Deploying AI models (use microsoft-foundry:models/deploy)
• Managing RBAC permissions (use microsoft-foundry:rbac)
• Monitoring resource usage (use microsoft-foundry:quota)

Prerequisites

• Azure subscription - Active subscription (create free account)
• Azure CLI - Version 2.0 or later installed
• Authentication - Run az login before commands
• RBAC roles - One of:
  • Contributor
  • Owner
  • Custom role with Microsoft.CognitiveServices/accounts/write
• Resource provider - Microsoft.CognitiveServices must be registered in your subscription
  • If not registered, see Workflow #3: Register Resource Provider
  • If you lack permissions, ask a subscription Owner/Contributor to register it or grant you /register/action privilege

Need RBAC help? See microsoft-foundry:rbac for permission management.

Core Workflows

1. Create Resource Group

Command Pattern: "Create a resource group for my Foundry resources"

Steps

1. Ask user preference: Use existing or create new resource group
2. If using existing: List and let user select from available groups (0-4: show all, 5+: show 5 most recent with "Other" option)
3. If creating new: Ask user to choose region, then create

# List existing resource groups
az group list --query "[-5:].{Name:name, Location:location}" --out table

# Or create new
az group create --name <rg-name> --location <location>
az group show --name <rg-name> --query "{Name:name, Location:location, State:properties.provisioningState}"

See Detailed Workflow Steps for complete instructions.

2. Create Foundry Resource

Command Pattern: "Create a new Azure AI Services resource"

Steps

1. Verify prerequisites: Check Azure CLI, authentication, and provider registration
2. Choose location: Always ask user to select region (don't assume resource group location)
3. Create resource: Use --kind AIServices and --sku S0 (only supported tier)
4. Verify and get keys

# Create Foundry resource
az cognitiveservices account create \
  --name <resource-name> \
  --resource-group <rg> \
  --kind AIServices \
  --sku S0 \
  --location <location> \
  --yes

# Verify and get keys
az cognitiveservices account show --name <resource-name> --resource-group <rg>
az cognitiveservices account keys list --name <resource-name> --resource-group <rg>

Important: S0 (Standard) is the only supported SKU - F0 free tier not available for AIServices.

See Detailed Workflow Steps for complete instructions.

3. Register Resource Provider

Command Pattern: "Register Cognitive Services provider"

Required when first creating Cognitive Services in subscription or if you get ResourceProviderNotRegistered error.

# Register provider (requires Owner/Contributor role)
az provider register --namespace Microsoft.CognitiveServices
az provider show --namespace Microsoft.CognitiveServices --query "registrationState"

If you lack permissions, ask a subscription Owner/Contributor to register it or use microsoft-foundry:rbac skill.

See Detailed Workflow Steps for complete instructions.

Important Notes

• Resource kind must be AIServices for multi-service Foundry resources
• SKU must be S0 (Standard) - F0 free tier not available for AIServices
• Always ask user to choose location - different regions may have varying availability

Additional Resources

• Common Patterns - Quick setup patterns and command reference
• Troubleshooting - Common errors and solutions
• Azure AI Services documentation