microsoft-foundry-classic

name	microsoft-foundry-classic
description	Expert knowledge for Microsoft Foundry Classic (aka Azure AI Foundry classic) development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building Foundry hubs/agents, model routing, Azure OpenAI integrations, RAG apps, or secure private endpoints, and other Microsoft Foundry Classic related development tasks. Not for Microsoft Foundry (use microsoft-foundry), Microsoft Foundry Local (use microsoft-foundry-local), Content Safety in Foundry Control Plane (use azure-content-safety), Azure Speech in Foundry Tools (use azure-speech).
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-08-09","generator":"docs2skills/1.0.0"}

Microsoft Foundry Classic Skill

This skill provides expert guidance for Microsoft Foundry Classic. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

• Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
• Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

Category	Lines	Description
Troubleshooting	L37-L46	Diagnosing and fixing Foundry classic issues: prompt flow compute, deployments/monitoring, private endpoints, Azure OpenAI (incl. fine-tuning), risks & safety alerts, and known portal bugs.
Best Practices	L47-L60	Best practices for designing system/safety prompts, fine-tuning and using GPT/DeepSeek models, optimizing latency/throughput, and evaluating/operating Foundry chat apps in production
Decision Making	L61-L87	Guides for choosing models, regions, deployment and billing options, sizing PTU, and planning migrations (Prompt Flow, hubs, APIs) and lifecycle for Foundry and Azure OpenAI workloads.
Architecture & Design Patterns	L88-L95	Designing multi-agent architectures, configuring Foundry Agent Service for resilience, and understanding model router behavior, failover, and disaster recovery strategies.
Limits & Quotas	L96-L111	Quotas, rate limits, and regional availability for Foundry agents and models (incl. Azure OpenAI/Claude), plus how to monitor, request, and increase deployment and throughput limits.
Security	L112-L157	Security, privacy, and compliance for Foundry: auth/RBAC, encryption and keys, network isolation/Private Link, Azure Policy guardrails, content filters/PII, and secure use of tools and models.
Configuration	L158-L209	Configuring and monitoring Foundry classic/AI apps: hosts, agents, evaluators, storage, networking, tracing, OpenAI settings, and continuous quality/usage monitoring.
Integrations & Coding Patterns	L210-L319	Patterns and code to integrate Foundry/ Azure OpenAI agents and models with tools and data (Search, Bing, SharePoint, MCP, Functions, Logic Apps, LangChain, RAG, fine-tuning, realtime audio, images).
Deployment	L320-L340	Deploying Foundry hubs/models with Bicep, CLI, Terraform; using managed/serverless compute; integrating with Azure DevOps/GitHub; upgrading Azure OpenAI; and checking regional availability.

Troubleshooting

Topic	URL
Troubleshoot Prompt Flow compute session issues in Foundry	https://learn.microsoft.com/en-us/azure/foundry-classic/how-to/prompt-flow-troubleshoot
Troubleshoot Foundry deployments and monitoring issues	https://learn.microsoft.com/en-us/azure/foundry-classic/how-to/troubleshoot-deploy-and-monitor
Troubleshoot Foundry private endpoint connection errors	https://learn.microsoft.com/en-us/azure/foundry-classic/how-to/troubleshoot-secure-connection-project
Troubleshoot Azure OpenAI fine-tuning in Foundry classic	https://learn.microsoft.com/en-us/azure/foundry-classic/openai/how-to/fine-tuning-troubleshoot
Monitor and troubleshoot Risks & Safety in Foundry	https://learn.microsoft.com/en-us/azure/foundry-classic/openai/how-to/risks-safety-monitor
Resolve known issues in Microsoft Foundry classic portal	https://learn.microsoft.com/en-us/azure/foundry-classic/reference/foundry-known-issues

Best Practices

Topic	URL
Design effective system messages for Azure OpenAI	https://learn.microsoft.com/en-us/azure/foundry-classic/openai/concepts/advanced-prompt-engineering
Apply safety system message templates in Azure OpenAI	https://learn.microsoft.com/en-us/azure/foundry-classic/openai/concepts/safety-system-message-templates
Author safety system messages for Azure OpenAI	https://learn.microsoft.com/en-us/azure/foundry-classic/openai/concepts/system-message
Apply safety evaluation when fine-tuning Foundry models	https://learn.microsoft.com/en-us/azure/foundry-classic/openai/how-to/fine-tuning-safety-evaluation
Fine-tune GPT-4 vision models with image data	https://learn.microsoft.com/en-us/azure/foundry-classic/openai/how-to/fine-tuning-vision
Optimize Azure OpenAI latency and throughput in Foundry	https://learn.microsoft.com/en-us/azure/foundry-classic/openai/how-to/latency
Apply best practices for Azure OpenAI On Your Data	https://learn.microsoft.com/en-us/azure/foundry-classic/openai/how-to/on-your-data-best-practices
Optimize Azure OpenAI predicted outputs for latency	https://learn.microsoft.com/en-us/azure/foundry-classic/openai/how-to/predicted-outputs
Operate Foundry provisioned throughput in production	https://learn.microsoft.com/en-us/azure/foundry-classic/openai/how-to/provisioned-get-started
Evaluate and improve Foundry-based chat apps with SDK	https://learn.microsoft.com/en-us/azure/foundry-classic/tutorials/copilot-sdk-evaluate

Decision Making

Topic	URL
Select Azure OpenAI models and regions for Foundry Agents	https://learn.microsoft.com/en-us/azure/foundry-classic/agents/concepts/model-region-support
Decide when and how to fine-tune models in Foundry	https://learn.microsoft.com/en-us/azure/foundry-classic/concepts/fine-tuning-overview
Compare Foundry models using benchmarks and leaderboards	https://learn.microsoft.com/en-us/azure/foundry-classic/concepts/model-benchmarks
Manage lifecycle of managed compute Foundry models	https://learn.microsoft.com/en-us/azure/foundry-classic/concepts/model-retirement-managed-compute
Choose the right Azure resource type for Foundry	https://learn.microsoft.com/en-us/azure/foundry-classic/concepts/resource-types
Choose Microsoft Foundry deployment types	https://learn.microsoft.com/en-us/azure/foundry-classic/foundry-models/concepts/deployment-types
Select Azure-sold Foundry models by capability	https://learn.microsoft.com/en-us/azure/foundry-classic/foundry-models/concepts/models-sold-directly-by-azure
Choose Foundry model regions and deployment types	https://learn.microsoft.com/en-us/azure/foundry-classic/foundry-models/concepts/models-sold-directly-by-azure-region-availability
Choose between GPT-5 and GPT-4.1 in Foundry	https://learn.microsoft.com/en-us/azure/foundry-classic/foundry-models/how-to/model-choice-guide
Compare models with Foundry leaderboards	https://learn.microsoft.com/en-us/azure/foundry-classic/how-to/benchmark-model-in-catalog

Architecture & Design Patterns

Topic	URL
Design multi-agent systems with Foundry connected agents	https://learn.microsoft.com/en-us/azure/foundry-classic/agents/how-to/connected-agents
Plan disaster recovery for Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry-classic/how-to/agent-service-disaster-recovery
Recover Foundry Agent Service from resource and data loss	https://learn.microsoft.com/en-us/azure/foundry-classic/how-to/agent-service-operator-disaster-recovery
Recover Foundry Agent Service from platform outages	https://learn.microsoft.com/en-us/azure/foundry-classic/how-to/agent-service-platform-disaster-recovery

Limits & Quotas

Topic	URL
Review quotas and limits for Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry-classic/agents/quotas-limits
Evaluate Foundry classic with regional limits and quotas	https://learn.microsoft.com/en-us/azure/foundry-classic/concepts/evaluation-regions-limits-virtual-network
Compare Claude model capabilities, quotas, and regions in Foundry	https://learn.microsoft.com/en-us/azure/foundry-classic/foundry-models/concepts/claude-models
Reference quotas and limits for Foundry Models	https://learn.microsoft.com/en-us/azure/foundry-classic/foundry-models/quotas-limits
Manage and request quotas for Microsoft Foundry hub resources	https://learn.microsoft.com/en-us/azure/foundry-classic/how-to/hub-quota
Manage and increase model deployment quotas in Foundry	https://learn.microsoft.com/en-us/azure/foundry-classic/how-to/quota
Understand Foundry provisioned throughput limits and quotas	https://learn.microsoft.com/en-us/azure/foundry-classic/openai/concepts/provisioned-throughput
Use Azure OpenAI global batch processing quotas	https://learn.microsoft.com/en-us/azure/foundry-classic/openai/how-to/batch
Use dynamic quota for Azure OpenAI deployments	https://learn.microsoft.com/en-us/azure/foundry-classic/openai/how-to/dynamic-quota
Manage Azure OpenAI quota and rate limits in Foundry	https://learn.microsoft.com/en-us/azure/foundry-classic/openai/how-to/quota
Use reinforcement fine-tuning with Azure OpenAI reasoning models

Security

Topic	URL
Configure Browser Automation tool securely for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry-classic/agents/how-to/tools-classic/browser-automation
Securely use Foundry Computer Use tool with agents	https://learn.microsoft.com/en-us/azure/foundry-classic/agents/how-to/tools-classic/computer-use
Configure authentication and authorization for Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry-classic/concepts/authentication-authorization-foundry
Configure customer-managed keys for Foundry encryption	https://learn.microsoft.com/en-us/azure/foundry-classic/concepts/encryption-keys-portal
Configure customer-managed keys for Foundry hub projects	https://learn.microsoft.com/en-us/azure/foundry-classic/concepts/hub-encryption-keys-portal
Configure RBAC for Microsoft Foundry hubs and projects	https://learn.microsoft.com/en-us/azure/foundry-classic/concepts/hub-rbac-foundry
Configure guardrails for Azure-sold Foundry models	https://learn.microsoft.com/en-us/azure/foundry-classic/concepts/model-catalog-content-safety
Configure RBAC roles for Microsoft Foundry projects	https://learn.microsoft.com/en-us/azure/foundry-classic/concepts/rbac-foundry
Understand vulnerability management for Microsoft Foundry images	https://learn.microsoft.com/en-us/azure/foundry-classic/concepts/vulnerability-management
Use default safety policies for Foundry Models	https://learn.microsoft.com/en-us/azure/foundry-classic/foundry-models/concepts/default-safety-policies

Configuration

Topic	URL
Configure and manage Foundry classic capability hosts	https://learn.microsoft.com/en-us/azure/foundry-classic/agents/concepts/capability-hosts
Configure standard agent resources for Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry-classic/agents/concepts/standard-agent-setup
Monitor Foundry Agent Service with Azure Monitor and KQL	https://learn.microsoft.com/en-us/azure/foundry-classic/agents/how-to/metrics
Connect and configure your own Azure resources for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry-classic/agents/how-to/use-your-own-resources
Configure private networking for Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry-classic/agents/how-to/virtual-networks
Reference monitoring data for Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry-classic/agents/reference/monitor-service
Configure and use built-in Foundry evaluators	https://learn.microsoft.com/en-us/azure/foundry-classic/concepts/built-in-evaluators
Configure agent evaluators for Azure AI agents	https://learn.microsoft.com/en-us/azure/foundry-classic/concepts/evaluation-evaluators/agent-evaluators
Use Azure OpenAI graders for model evaluation	https://learn.microsoft.com/en-us/azure/foundry-classic/concepts/evaluation-evaluators/azure-openai-graders
Create and configure custom evaluators in Foundry	https://learn.microsoft.com/en-us/azure/foundry-classic/concepts/evaluation-evaluators/custom-evaluators

Integrations & Coding Patterns

Topic	URL
Connect Foundry agents to existing Azure AI Search indexes	https://learn.microsoft.com/en-us/azure/foundry-classic/agents/how-to/tools-classic/azure-ai-search
Integrate Azure AI Search with Foundry classic agents	https://learn.microsoft.com/en-us/azure/foundry-classic/agents/how-to/tools-classic/azure-ai-search-samples
Integrate Azure Functions as tools with Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry-classic/agents/how-to/tools-classic/azure-functions
Use Azure Functions and Storage Queues with Foundry agents	https://learn.microsoft.com/en-us/azure/foundry-classic/agents/how-to/tools-classic/azure-functions-samples
Use Bing Search grounding tool with code samples	https://learn.microsoft.com/en-us/azure/foundry-classic/agents/how-to/tools-classic/bing-code-samples
Configure Custom Bing Search grounding for agents	https://learn.microsoft.com/en-us/azure/foundry-classic/agents/how-to/tools-classic/bing-custom-search
Use Bing Custom Search grounding in Foundry classic agents	https://learn.microsoft.com/en-us/azure/foundry-classic/agents/how-to/tools-classic/bing-custom-search-samples
Ground Foundry agents with Bing Search results	https://learn.microsoft.com/en-us/azure/foundry-classic/agents/how-to/tools-classic/bing-grounding
Automate website tasks with Foundry Browser Automation tool	https://learn.microsoft.com/en-us/azure/foundry-classic/agents/how-to/tools-classic/browser-automation-samples

Deployment

Topic	URL
Evaluate deployment options for Foundry Models	https://learn.microsoft.com/en-us/azure/foundry-classic/concepts/deployments-overview
Plan organization-wide deployment of Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry-classic/concepts/planning
Deploy Foundry Models using Azure CLI and Bicep	https://learn.microsoft.com/en-us/azure/foundry-classic/foundry-models/how-to/create-model-deployments
Deploy a Microsoft Foundry hub using Bicep	https://learn.microsoft.com/en-us/azure/foundry-classic/how-to/create-azure-ai-hub-template
Provision a Foundry hub and project with Terraform	https://learn.microsoft.com/en-us/azure/foundry-classic/how-to/create-hub-terraform
Provision Microsoft Foundry classic resources with Terraform	https://learn.microsoft.com/en-us/azure/foundry-classic/how-to/create-resource-terraform
Deploy models with managed compute in Foundry	https://learn.microsoft.com/en-us/azure/foundry-classic/how-to/deploy-models-managed
Deploy Hugging Face Hub models to Foundry managed endpoints	https://learn.microsoft.com/en-us/azure/foundry-classic/how-to/deploy-models-managed-hugging-face
Deploy Foundry models to managed pay-as-you-go compute	https://learn.microsoft.com/en-us/azure/foundry-classic/how-to/deploy-models-managed-pay-go
Deploy models as serverless APIs in Foundry	https://learn.microsoft.com/en-us/azure/foundry-classic/how-to/deploy-models-serverless
Run Foundry evaluations in Azure DevOps pipelines