name: microsoft-foundry description: 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 (RAG, evals, vector/file search, fine-tuning, or realtime/audio), and other Microsoft Foundry related development tasks. Not for Microsoft Foundry Classic (use microsoft-foundry-classic), 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 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 | Diagnosing evaluation/observability problems in Foundry (metrics, logging, tracing) and resolving known platform issues with documented workarounds. |
| Best Practices | L43-L54 | Best practices for configuring tools, prompts, evaluation, safety, latency, and fine-tuning (incl. vision models) to build high-quality, efficient Azure AI/Foundry agents |
| Decision Making | L55-L85 | Guides for choosing models, deployments, costs, and tools, plus migration and upgrade paths (Azure OpenAI, GitHub Models, Assistants API) and web/Bing grounding decisions. |
| Architecture & Design Patterns | L86-L97 | Architectural patterns for Foundry agents: standard setup, RAG/indexing, HA/DR, regional recovery, provisioned throughput, spillover traffic, and LLM routing optimization. |
| Limits & Quotas | L98-L112 | Limits, quotas, regions, and availability for Foundry and Azure OpenAI models, agents, evals, vector/file search, batch, fine-tuning, and partner models. |
| Security | L113-L145 | Security, identity, networking, and compliance for Foundry: auth/RBAC, keys & encryption, private networking, guardrails, safety policies, content safety, and data privacy for models and agents |
| Configuration | L146-L192 | Configuring Foundry agents, models, tools, storage, monitoring, security, and Azure OpenAI features (search, memory, tracing, fine-tuning, prompt controls, and external integrations). |
| Integrations & Coding Patterns | L193-L257 | Patterns and code for integrating Foundry agents and models with tools, APIs, LangChain/LangGraph, Azure OpenAI, realtime/audio, search, safety, tracing, and enterprise systems. |
| Deployment | L258-L273 | Deploying agents and models: infra setup, hosting, publishing to Azure/M365/Teams, CI/CD, workflows, custom/fine-tuned/Fireworks models, and managing deployment lifecycle. |
Troubleshooting
| Topic | URL |
|---|---|
| Troubleshoot Foundry evaluation and observability issues | https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/troubleshooting |
| Troubleshoot Microsoft Foundry known issues and workarounds | https://learn.microsoft.com/en-us/azure/foundry/reference/foundry-known-issues |