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-L48 | Diagnosing and fixing Foundry agent and evaluation issues: agent health checks, recovery from data/resource loss, webhook problems, error codes, and known bugs/workarounds. |
| Best Practices | L49-L65 | Best practices for building and running Foundry agents: tools, crash recovery, training data, routing, safety, prompts, vision/medical fine-tuning, and optimizing latency/throughput. |
| Decision Making | L66-L113 | Guidance for choosing models, deployments, hosting, billing, networking, and governance, plus planning migrations, DR, lifecycle/retirements, and rollout of Microsoft Foundry agents and apps. |
| Architecture & Design Patterns | L114-L124 | Architecting Foundry Agent Service: networking/BYO VNet, runtime choices, resilience and HA, auto-triggering with routines, shared sessions, tool search patterns, and private retrieval with Foundry IQ |
| Limits & Quotas | L125-L148 | Quotas, limits, and rate caps for agents, models, vector/durable stores, regions, AI Gateway, Azure OpenAI, and how to manage token usage, throughput, timeouts, and cost safeguards |
| Security | L149-L198 | Securing Foundry agents and models: auth, RBAC, network isolation, guardrails, data privacy, governance (Azure Policy, Entra, Agent 365), and safe tool/trace/grounding configurations. |
| Configuration | L199-L293 | Configuring Microsoft Foundry agents, models, tools, storage, networking, monitoring, evaluations, and Azure OpenAI integrations, including yaml schemas, security, observability, and deployment settings |
| Integrations & Coding Patterns | L294-L385 | Patterns and APIs for integrating Foundry agents/models with tools, MCP servers, LangChain, Azure/OpenAI services, voice/audio, search, knowledge bases, observability, fine-tuning, and evaluation workflows. |
| Deployment | L386-L410 | Deploying and operating Foundry agents/models: infrastructure scaffolding, containers/ACR, long‑running and steerable agents, CI/CD, M365 publishing, evaluations, healthcare models, and outage recovery. |
Troubleshooting
Best Practices
Decision Making
Architecture & Design Patterns
| Topic | URL |
|---|---|
| Plan Foundry Agent Service networking in BYO VNet | https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/agents-networking-deep-dive |
| Design resilient long-running hosted agents in Foundry | https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/long-running-agent-resilience |
| Use routines to trigger Foundry agents automatically | https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/routines |
| Choose runtime components for Foundry Agent Service | https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/runtime-components |
| Pool multiple users onto shared Foundry agent sessions | https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/multiplex-session-users |
| Design scalable tool search patterns for Foundry toolboxes | https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/tool-search |
| Design high availability for Microsoft Foundry agents | https://learn.microsoft.com/en-us/azure/foundry/how-to/high-availability-resiliency |