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 agents, prompt flows, RAG/search, Azure OpenAI deployments, or multi-agent architectures, and other Microsoft Foundry Classic related development tasks. Not for Microsoft Foundry (use microsoft-foundry), Microsoft Foundry Local (use microsoft-foundry-local), Microsoft Foundry Tools (use microsoft-foundry-tools).
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-04-19","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-L47	Diagnosing and fixing Foundry issues: compute/usage in prompt flow, deployments/monitoring, private endpoints, Azure OpenAI fine-tuning, risks & safety alerts, and known bugs/workarounds.
Best Practices	L48-L61	Best practices for prompts, safety, fine-tuning (incl. vision), latency/cost optimization, DeepSeek-R1 use, On Your Data, and evaluating/improving Foundry/Azure OpenAI chat apps
Decision Making	L62-L88	Guides for choosing models, regions, deployments, costs, PTU, streaming, SDKs, and upgrade/migration paths to design, scale, and optimize Foundry and Azure OpenAI solutions.
Architecture & Design Patterns	L89-L98	Architectural guidance for Foundry: multi-agent design, service/resource topology, high availability, and full BCDR (backup, recovery, DR, and resiliency) for Agent Service and Azure OpenAI workloads
Limits & Quotas	L99-L115	Quotas, rate limits, and capacity for Foundry Agents/Models and Azure OpenAI (deployments, regions, VNets, batch, dynamic quota), plus model availability/retirement and how to request increases.
Security	L116-L163	Security, privacy, and compliance for Foundry and Azure OpenAI: auth/RBAC, networking (VNet/Private Link), keys and Key Vault, guardrails/content filters, Azure Policy, and data handling.
Configuration	L164-L221	Configuring, monitoring, and evaluating Foundry classic agents, models, tools, and infrastructure, including BYO resources, RAG, safety, tracing, and Azure OpenAI monitoring.
Integrations & Coding Patterns	L222-L342	Patterns and code to integrate Foundry and Azure OpenAI with tools, data, and frameworks: search/RAG, files, SharePoint, Bing, MCP/OpenAPI, Functions/Logic Apps, SDKs, fine-tuning, and realtime audio.
Deployment	L343-L360	Deploying Foundry hubs, projects, and models (managed/serverless), setting up agents and prompt flows, and automating deployments/evaluations via CLI, Bicep, Terraform, VS Code, and CI/CD.

Troubleshooting

Topic	URL
Resolve common issues in Microsoft Foundry (classic)	https://learn.microsoft.com/en-us/azure/foundry-classic/faq
Troubleshoot compute and usage issues in prompt flow	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 issues in Foundry	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 and workarounds in Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry-classic/reference/foundry-known-issues

Best Practices

Topic	URL
Deploy and use DeepSeek-R1 reasoning model in Foundry	https://learn.microsoft.com/en-us/azure/foundry-classic/foundry-models/tutorials/get-started-deepseek-r1
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-focused system messages in Foundry	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 performance and latency	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
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
Use Foundry model benchmarks and leaderboards	https://learn.microsoft.com/en-us/azure/foundry-classic/concepts/model-benchmarks
Plan for Foundry model deprecation and retirement	https://learn.microsoft.com/en-us/azure/foundry-classic/concepts/model-lifecycle-retirement
Plan Microsoft Foundry classic rollout at scale	https://learn.microsoft.com/en-us/azure/foundry-classic/concepts/planning
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 and residency	https://learn.microsoft.com/en-us/azure/foundry-classic/foundry-models/concepts/deployment-types
Plan and manage model versioning in Foundry Models	https://learn.microsoft.com/en-us/azure/foundry-classic/foundry-models/concepts/model-versions
Plan and manage model versioning in Foundry Models	https://learn.microsoft.com/en-us/azure/foundry-classic/foundry-models/concepts/model-versions
Decide 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

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
Design high availability and resiliency for Foundry projects	https://learn.microsoft.com/en-us/azure/foundry-classic/how-to/high-availability-resiliency
Design BCDR architecture for Azure OpenAI workloads	https://learn.microsoft.com/en-us/azure/foundry-classic/openai/how-to/business-continuity-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 VNet	https://learn.microsoft.com/en-us/azure/foundry-classic/concepts/evaluation-regions-limits-virtual-network
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
Review retired Azure OpenAI model availability	https://learn.microsoft.com/en-us/azure/foundry-classic/openai/concepts/legacy-models
Azure OpenAI model availability and retirement schedule	https://learn.microsoft.com/en-us/azure/foundry-classic/openai/concepts/model-retirements
Azure OpenAI FAQ with usage limits and policies	https://learn.microsoft.com/en-us/azure/foundry-classic/openai/faq
Use Azure OpenAI global batch processing	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 in Foundry classic	https://learn.microsoft.com/en-us/azure/foundry-classic/openai/how-to/quota

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
Set up private networking and VNet integration for Foundry	https://learn.microsoft.com/en-us/azure/foundry-classic/agents/how-to/virtual-networks
Configure authentication and authorization in Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry-classic/concepts/authentication-authorization-foundry
Configure customer-managed keys for Microsoft Foundry	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
Assign and manage RBAC roles in Microsoft Foundry	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

Configuration

Topic	URL
Configure and troubleshoot capability hosts in Foundry	https://learn.microsoft.com/en-us/azure/foundry-classic/agents/concepts/capability-hosts
Configure standard agent setup with customer-managed resources	https://learn.microsoft.com/en-us/azure/foundry-classic/agents/concepts/standard-agent-setup
Configure environment and infrastructure for Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry-classic/agents/environment-setup
Monitor Foundry Agent Service with Azure Monitor and KQL	https://learn.microsoft.com/en-us/azure/foundry-classic/agents/how-to/metrics
Configure Foundry Agent Service to use your own Azure resources	https://learn.microsoft.com/en-us/azure/foundry-classic/agents/how-to/use-your-own-resources
Use Azure Monitor metrics and logs 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
Ground Foundry agents with Azure AI Search content	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
Call Custom Bing Search grounding tool from code	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
Run Python code with Foundry Code Interpreter tool

Deployment

Topic	URL
Evaluate deployment options for Foundry Models	https://learn.microsoft.com/en-us/azure/foundry-classic/concepts/deployments-overview
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 Foundry Models via Microsoft Foundry portal	https://learn.microsoft.com/en-us/azure/foundry-classic/foundry-models/how-to/deploy-foundry-models
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
Deploy models with managed compute in Foundry	https://learn.microsoft.com/en-us/azure/foundry-classic/how-to/deploy-models-managed
Deploy models as serverless APIs in Foundry	https://learn.microsoft.com/en-us/azure/foundry-classic/how-to/deploy-models-serverless
Check region availability for serverless models	https://learn.microsoft.com/en-us/azure/foundry-classic/how-to/deploy-models-serverless-availability
Create, configure, and deploy Foundry agents from VS Code	https://learn.microsoft.com/en-us/azure/foundry-classic/how-to/develop/vs-code-agents
Run Foundry evaluations in Azure DevOps pipelines	https://learn.microsoft.com/en-us/azure/foundry-classic/how-to/evaluation-azure-devops