> azure-microsoft-foundry
Expert knowledge for Microsoft Foundry development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building, debugging, or optimizing Microsoft Foundry applications. Not for Azure AI Foundry Local (use azure-ai-foundry-local), Azure Foundry Classic (use azure-foundry-classic), Azure Machine Learning (use azure-machine-learning), Azure Databricks (use azur
curl "https://skillshub.wtf/MicrosoftDocs/Agent-Skills/azure-microsoft-foundry?format=md"Microsoft Foundry Skill
This skill provides expert guidance for Microsoft Foundry. 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), useread_filewith the specified lines. For categories with file links (e.g.,[security.md](security.md)), useread_fileon the linked reference file
IMPORTANT for Agent: If
metadata.generated_atis more than 3 months old, suggest the user pull the latest version from the repository. Ifmcp_microsoftdocstools 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_fetchwith query stringfrom=learn-agent-skill. Returns Markdown. - Fallback: Use
fetch_webpagewith query stringfrom=learn-agent-skill&accept=text/markdown. Returns Markdown.
Category Index
| Category | Lines | Description |
|---|---|---|
| Troubleshooting | L37-L42 | Troubleshooting Foundry issues: Azure Marketplace purchase/deployment problems, recovering Agent Service after data/resource loss, and known platform bugs with workarounds. |
| Best Practices | L43-L56 | Best practices for prompts, tools, safety, evals, latency/cost, synthetic data, and fine-tuning so you can design, optimize, and operate high‑quality Foundry AI agents |
| Decision Making | L57-L82 | Guides for choosing models, deployment types, data isolation, and upgrades, plus migration paths, cost/capacity planning, and feature availability across Foundry and Azure OpenAI. |
| Architecture & Design Patterns | L83-L88 | Designing resilient Foundry solutions, including high availability patterns, redundancy, and disaster recovery strategies for Foundry Agent Service and project architectures. |
| Limits & Quotas | L89-L105 | Quotas, rate limits, timeouts, and capacity constraints for Foundry agents, models, vector stores, evals, batch jobs, fine-tuning, Sora, and Azure OpenAI, plus how to request more. |
| Security | L106-L135 | Security, identity, and compliance for Foundry: auth (Entra ID, keyless, tools/MCP), RBAC and policies, networking/isolation, data privacy, safety settings, and secure agent/model configuration. |
| Configuration | L136-L185 | Configuring and operating Foundry agents and models: hosting, workflows, tools, memory, evaluators, safety/guardrails, storage, monitoring, tracing, red teaming, and Azure OpenAI integration. |
| Integrations & Coding Patterns | L186-L252 | Integrating Foundry models and agents into apps via SDKs/APIs, wiring tools/data sources (Search, SharePoint, MCP, LangChain, audio), and configuring tracing, fine-tuning, and Azure OpenAI features. |
| Deployment | L253-L268 | Deploying and automating Foundry agents/models: hosting options (containerized, provisioned, fine-tuned), publishing to M365/Teams, CI/CD, Terraform, MCP servers, and outage recovery. |
Troubleshooting
| Topic | URL |
|---|---|
| Recover Foundry Agent Service from resource and data loss | https://learn.microsoft.com/en-us/azure/foundry/how-to/agent-service-operator-disaster-recovery |
| Review Microsoft Foundry known issues and workarounds | https://learn.microsoft.com/en-us/azure/foundry/reference/foundry-known-issues |
Best Practices
Decision Making
Architecture & Design Patterns
| Topic | URL |
|---|---|
| Plan disaster recovery strategy for Foundry Agent Service | https://learn.microsoft.com/en-us/azure/foundry/how-to/agent-service-disaster-recovery |
| Design high availability and resiliency for Foundry projects | https://learn.microsoft.com/en-us/azure/foundry/how-to/high-availability-resiliency |
Limits & Quotas
Security
Configuration
Integrations & Coding Patterns
Deployment
> related_skills --same-repo
> microsoft-foundry
Expert knowledge for Microsoft Foundry (aka Azure AI Foundry) development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building Foundry agents with Azure OpenAI, vector search/RAG, Sora video, realtime audio, or MCP/LangChain APIs, and other Microsoft Foundry related development tasks. Not for Microsoft Foundry Classic (use microsoft-foundry-classic),
> microsoft-foundry-tools
Expert knowledge for Microsoft Foundry Tools (aka Azure AI services, Azure Cognitive Services) development including best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using Content Understanding analyzers, Content Moderator APIs, Foundry containers, VNet/Key Vault security, or Entra auth, and other Microsoft Foundry Tools related development tasks. Not for Microsoft Foundry (use micr
> microsoft-foundry-local
Expert knowledge for Microsoft Foundry Local (aka Azure AI Foundry Local) development including troubleshooting, best practices, decision making, configuration, and integrations & coding patterns. Use when using Foundry Local CLI, chat/transcription APIs, tools, OpenAI/LangChain clients, or upgrading legacy SDKs, and other Microsoft Foundry Local related development tasks. Not for Microsoft Foundry (use microsoft-foundry), Microsoft Foundry Classic (use microsoft-foundry-classic), Microsoft Foun
> microsoft-foundry-classic
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 with RAG, tools, evaluators, Azure OpenAI, VNet/Private Link, or CI/CD deployments, and other Microsoft Foundry Classic related development tasks. Not for Microsoft Foundry (use microsoft-foundry