microsoft-foundry

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), 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-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

Best Practices

Topic	URL
Apply tool configuration best practices for agents	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/tool-best-practice
Evaluate Azure AI agents with task-specific metrics	https://learn.microsoft.com/en-us/azure/foundry/concepts/evaluation-evaluators/agent-evaluators
Evaluate Foundry agents with built-in quality and safety tests	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/evaluate-agent
Improve Foundry agent prompts with Prompt Optimizer	https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/prompt-optimizer
Design effective system messages for Azure OpenAI in Foundry	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/advanced-prompt-engineering
Apply prompt engineering techniques for vision-enabled GPT models	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/gpt-4-v-prompt-engineering
Fine-tune GPT-4 vision models with images	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/fine-tuning-vision
Optimize Azure OpenAI latency and throughput in Foundry	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/latency

Decision Making

Topic	URL
Migrate from Assistants API to Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/migrate
Use Bing grounding tools with agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/bing-tools
Choose web grounding tools for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/web-overview
Use Foundry model benchmarks and leaderboards for selection	https://learn.microsoft.com/en-us/azure/foundry/concepts/model-benchmarks
Plan for Foundry model deprecation and retirement	https://learn.microsoft.com/en-us/azure/foundry/concepts/model-lifecycle-retirement
Plan Microsoft Foundry rollout and environment strategy	https://learn.microsoft.com/en-us/azure/foundry/concepts/planning
Optimize Foundry model cost and performance	https://learn.microsoft.com/en-us/azure/foundry/control-plane/how-to-optimize-cost-performance
Choose Foundry deployment types and data residency options	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/deployment-types
Choose Foundry deployment types in Azure Government	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/deployment-types-gov
Manage model versioning and upgrade policies in Foundry	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/model-versions
Decide on model versioning and upgrade policies in Azure Government	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/model-versions-gov

Architecture & Design Patterns

Topic	URL
Design standard agent setup with isolated resources	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/standard-agent-setup
Apply RAG and indexing patterns in Foundry	https://learn.microsoft.com/en-us/azure/foundry/concepts/retrieval-augmented-generation
Plan disaster recovery for Foundry Agent Service in standard mode	https://learn.microsoft.com/en-us/azure/foundry/how-to/agent-service-disaster-recovery
Recover Foundry Agent Service from resource and data loss	https://learn.microsoft.com/en-us/azure/foundry/how-to/agent-service-operator-disaster-recovery
Recover Foundry Agent Service from regional platform outages	https://learn.microsoft.com/en-us/azure/foundry/how-to/agent-service-platform-disaster-recovery
Plan high availability and resiliency for Foundry projects and agents	https://learn.microsoft.com/en-us/azure/foundry/how-to/high-availability-resiliency
Plan provisioned throughput architecture for Foundry models	https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/provisioned-throughput
Design spillover traffic management for provisioned deployments	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/spillover-traffic-management

Limits & Quotas

Topic	URL
Quotas, limits, and regions for Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/limits-quotas-regions
Use vector stores and file search limits in agents	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/vector-stores
Evaluation rate limits and region support in Foundry	https://learn.microsoft.com/en-us/azure/foundry/concepts/evaluation-regions-limits-virtual-network
Configure token rate limits and quotas for Foundry models	https://learn.microsoft.com/en-us/azure/foundry/control-plane/how-to-enforce-limits-models
Capabilities and availability of partner Foundry models	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/models-from-partners
Model catalog details for Azure-sold Foundry models	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/models-sold-directly-by-azure
Reference quotas and limits for Foundry Models	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/quotas-limits
Use Azure OpenAI global batch processing efficiently	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/batch
Use reinforcement fine-tuning with cost limits	https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/reinforcement-fine-tuning
Reference Azure OpenAI quotas and limits in Foundry	https://learn.microsoft.com/en-us/azure/foundry/openai/quotas-limits
Understand limited access policy for Azure OpenAI

Security

Topic	URL
Configure and govern agent identities in Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/agent-identity
Configure authentication methods for Agent2Agent tools	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/agent-to-agent-authentication
Configure authentication for MCP servers in Foundry	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/mcp-authentication
Configure computer use tool securely for agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/computer-use
Govern MCP tools with an AI gateway in Foundry	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/governance
Set up private networking for Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/virtual-networks
Configure authentication and authorization for Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry/concepts/authentication-authorization-foundry
Configure customer-managed keys for Microsoft Foundry encryption	https://learn.microsoft.com/en-us/azure/foundry/concepts/encryption-keys-portal
Configure RBAC roles and scopes for Microsoft Foundry	https://learn.microsoft.com/en-us/azure/foundry/concepts/rbac-foundry
Administer Foundry agent infrastructure with Entra roles	https://learn.microsoft.com/en-us/azure/foundry/control-plane/govern-agent-infrastructure-entra-admin
Manage Foundry compliance and security integrations

Configuration

Topic	URL
Configure capability hosts for Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/capability-hosts
Manage and disable Grounding with Bing in Foundry	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/manage-grounding-with-bing
Configure and manage memory in Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/memory-usage
Configure a private tool catalog with Azure API Center	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/private-tool-catalog
Configure structured inputs for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/structured-inputs
Configure custom MCP-based code interpreter runtime	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/custom-code-interpreter
Configure file search tool for Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/file-search
Configure and use web search tool in Foundry	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/web-search
Configure Foundry Agent Service to use existing Azure resources	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/use-your-own-resources
Configure declarative agent workflows in VS Code	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/vs-code-agents-workflow-low-code
Reference for all Foundry built-in evaluators	https://learn.microsoft.com/en-us/azure/foundry/concepts/built-in-evaluators

Integrations & Coding Patterns

Topic	URL
Use agents, conversations, and responses in Foundry	https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/runtime-components
Integrate enterprise AI gateways with Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/ai-gateway
Connect Foundry agents to Foundry IQ knowledge bases	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/foundry-iq-connect
Invoke Foundry Agent Applications via Responses API protocol	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/publish-responses
Connect Foundry agents to external A2A endpoints	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/agent-to-agent
Connect Azure AI Search indexes to agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/ai-search
Integrate Azure Speech MCP tool with Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/azure-ai-speech
Integrate Azure Functions as tools for agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/azure-functions
Use Browser Automation tool with Foundry agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/browser-automation
Enable Code Interpreter tool for agents	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/code-interpreter
Connect Microsoft Fabric data agent to Foundry	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/fabric

Deployment

Topic	URL
Set up infrastructure for Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry/agents/environment-setup
Deploy Foundry agents as digital workers in Agent 365	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/agent-365
Deploy custom hosted agents to Foundry Agent Service	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/deploy-hosted-agent
Manage lifecycle of hosted agent deployments	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/manage-hosted-agent
Publish Foundry agents as managed Azure resources	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/publish-agent
Publish Foundry agents to Microsoft 365 Copilot and Teams	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/publish-copilot
Create and deploy hosted Foundry agent workflows in VS Code	https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/vs-code-agents-workflow-pro-code
Deploy Foundry Models using Azure CLI and Bicep templates	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/create-model-deployments
Deploy Foundry Models via Foundry portal for inference	https://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/deploy-foundry-models
Run Foundry evaluations in Azure DevOps pipelines	https://learn.microsoft.com/en-us/azure/foundry/how-to/evaluation-azure-devops
Run Foundry evaluations in GitHub Actions CI	https://learn.microsoft.com/en-us/azure/foundry/how-to/evaluation-github-action