AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

microsoft-foundry

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and resources end to end. USE FOR: foundry, azd ai agent, azd provision/deploy, hosted agent scaffold/develop/run/deploy/troubleshoot, prompt agent, managed harness agent, Copilot harness, voice agent, create/update/invoke/evaluate agent, add tool to agent, agent insights, batch/continuous eval, continuous monitoring, agent CI/CD, optimize/improve prompt, optimize agent instructions, Agent Optimizer, dataset curation from traces, deploy model, model fine-tuning (SFT/DPO/RFT), Foundry project, RBAC, role assignment, permissions, quota, capacity, region, deployment failure, AI Services, create Foundry resource, knowledge index, customize deployment, onboard, availability, training-data, grader, distillation, large file upload. DO NOT USE FOR: Azure Functions, App Service, general Azure deploy (use azure-deploy), general Azure prep (use azure-prepare).

Original source
microsoft
License
MIT
Pinned revision
3f5b461b2314e01c400564051e92469114c5b68f

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read microsoft--microsoft-foundry at revision 3f5b461b2314e01c400564051e92469114c5b68f, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 151

quota/references/troubleshooting.md

Troubleshooting Quota Errors

Table of Contents: Common Quota Errors · Detailed Error Resolution · Request Quota Increase Process · Diagnostic Commands · External Resources

Common Quota Errors

| Error | Cause | Quick Fix | |-------|-------|-----------| | QuotaExceeded | Regional quota consumed (TPM or PTU) | Delete unused deployments or request increase | | InsufficientQuota | Not enough available for requested capacity | Reduce deployment capacity or free quota | | DeploymentLimitReached | Too many deployment slots used | Delete unused deployments to free slots | | 429 Rate Limit | TPM capacity too low for traffic (Standard only) | Increase TPM capacity or migrate to PTU | | PTU capacity unavailable | No PTU quota in region | Request PTU quota or try different region | | SKU not supported | PTU not available for model/region | Check model availability or use Standard TPM |

Detailed Error Resolution

QuotaExceeded Error

All available TPM or PTU quota consumed in the region.

Resolution:

  1. Check current quota usage:

    subId=$(az account show --query id -o tsv)
    region="eastus"
    az rest --method get \
      --url "https://management.azure.com/subscriptions/$subId/providers/Microsoft.CognitiveServices/locations/$region/usages?api-version=2023-05-01" \
      --query "value[?contains(name.value,'OpenAI')].{Model:name.value, Used:currentValue, Limit:limit}" -o table
    
  2. Choose resolution:

    • Option A: Delete unused deployments to free quota
    • Option B: Reduce requested deployment capacity
    • Option C: Deploy to different region with available quota
    • Option D: Request quota increase through Azure Portal

InsufficientQuota Error

Available quota less than requested capacity.

Resolution:

  1. Check available quota:

    # Calculate available: limit - currentValue
    subId=$(az account show --query id -o tsv)
    region="eastus"
    az rest --method get \
      --url "https://management.azure.com/subscriptions/$subId/providers/Microsoft.CognitiveServices/locations/$region/usages?api-version=2023-05-01" \
      --query "value[?name.value=='OpenAI.Standard.gpt-4o'].{Model:name.value, Used:currentValue, Limit:limit, Available:(limit-currentValue)}" -o table
    
  2. Options:

    • Reduce deployment capacity to fit available quota
    • Delete existing deployments to free capacity
    • Try different region with more available quota
    • Request quota increase

DeploymentLimitReached Error

Resource reached maximum deployment slot limit (10-20 slots).

Resolution:

  1. List existing deployments:

    az cognitiveservices account deployment list \
      --name <resource-name> \
      --resource-group <rg> \
      --query '[].{Name:name, Model:properties.model.name, Capacity:sku.capacity}' \
      --output table
    
  2. Delete unused deployments:

    az cognitiveservices account deployment delete \
      --name <resource-name> \
      --resource-group <rg> \
      --deployment-name <unused-deployment-name>
    
  3. Verify slot freed:

    az cognitiveservices account deployment list \
      --name <resource-name> \
      --resource-group <rg> \
      --query 'length([])'
    

429 Rate Limit Errors

TPM capacity insufficient for traffic volume (Standard TPM only).

Resolution:

  1. Check deployment capacity:

    az cognitiveservices account deployment show \
      --name <resource-name> \
      --resource-group <rg> \
      --deployment-name <deployment-name> \
      --query '{Name:name, Model:properties.model.name, Capacity:sku.capacity, SKU:sku.name}'
    
  2. Options:

    • Option A: Increase TPM capacity on existing deployment
      az cognitiveservices account deployment update \
        --name <resource-name> \
        --resource-group <rg> \
        --deployment-name <deployment-name> \
        --sku-capacity <higher-capacity>
      
    • Option B: Migrate to PTU for guaranteed throughput (no rate limits)
    • Option C: Implement retry logic with exponential backoff in application

PTU Capacity Unavailable Error

No PTU quota allocated in region, or PTU not available for model/region.

Resolution:

  1. Check PTU quota:

    subId=$(az account show --query id -o tsv)
    region="eastus"
    az rest --method get \
      --url "https://management.azure.com/subscriptions/$subId/providers/Microsoft.CognitiveServices/locations/$region/usages?api-version=2023-05-01" \
      --query "value[?contains(name.value,'ProvisionedManaged')].{Model:name.value, Used:currentValue, Limit:limit}" -o table
    
  2. Options:

    • Request PTU quota increase through Azure Portal (include capacity calculator results)
    • Try different region where PTU is available
    • Use Standard TPM instead

SKU Not Supported Error

PTU not available for specific model or region combination.

Resolution:

  1. Check model availability:

  2. Options:

    • Deploy with Standard TPM SKU instead
    • Choose different region where PTU is supported
    • Use alternative model that supports PTU in your region

Request Quota Increase Process

For Standard TPM Quota

  1. Navigate to Azure Portal → Your Foundry resource → Quotas
  2. Identify model needing increase (e.g., "GPT-4o Standard")
  3. Click Request quota increase
  4. Fill form:
    • Model name
    • Requested quota (in TPM)
    • Business justification (required)
  5. Submit and monitor status

Processing Time: Typically 1-2 business days

For PTU Quota

  1. Navigate to Azure Portal → Your Foundry resource → Quotas
  2. Select Provisioned throughput unit tab
  3. Identify model needing PTU increase
  4. Click Request quota increase
  5. Fill form:
    • Model name
    • Requested PTU quota
    • Include capacity calculator results
    • Detailed business justification (workload characteristics)
  6. Submit and monitor status

Processing Time: Typically 3-5 business days (requires stronger justification)

Diagnostic Commands

# Check deployment status
az cognitiveservices account deployment show \
  --name <resource-name> \
  --resource-group <rg> \
  --deployment-name <deployment-name>

# Verify available quota
subId=$(az account show --query id -o tsv)
az rest --method get \
  --url "https://management.azure.com/subscriptions/$subId/providers/Microsoft.CognitiveServices/locations/eastus/usages?api-version=2023-05-01" \
  --query "value[?contains(name.value,'OpenAI')].{Model:name.value, Used:currentValue, Limit:limit, Available:(limit-currentValue)}" \
  --output table

# List all deployments
az cognitiveservices account deployment list \
  --name <resource-name> \
  --resource-group <rg> \
  --query '[].{Name:name, Model:properties.model.name, Capacity:sku.capacity, SKU:sku.name}' \
  --output table

External Resources