MCPInstall

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, voice/telephony, Realtime, MCP tools, or LangChain integrations, and other Microsoft Foundry related development tasks. Not for Content Safety in Foundry Control Plane (use azure-content-safety), Azure Content Understanding in Foundry Tools (use azure-content-understanding), Azure Speech in Foundry Tools (use azure-speech), Microsoft Foundry Classic (use microsoft-foundry-classic).

Installs
263
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/microsoftdocs/agent-skills --skill microsoft-foundry
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads microsoft-foundry automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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

CategoryLocationDescription
TroubleshootingL37-L52Diagnosing and fixing Foundry agent issues: health checks, publishing/Copilot auth errors, training/eval problems, HTTP/webhook failures, data loss recovery, and debugging/tracing in VS Code.
Best PracticesL53-L72Best practices for building, operating, and optimizing Foundry agents: prompts, tools, safety, routing, voice, evaluations, fine-tuning, reliability, performance, and production operations.
Decision MakingL73-L125Guides for choosing models, deployments, networking, billing modes, and governance, plus planning migrations, lifecycle/retirement, DR, and rollout strategies for Microsoft Foundry and agents
Architecture & Design PatternsL126-L135Designing secure, scalable Foundry agents and toolboxes: networking in BYO VNets, data isolation, resilient long-running agents, tool search patterns, network isolation, and programmatic tool calling.
Limits & QuotasL136-L165Quotas, limits, and timeouts for Foundry agents and models, including tokens, rate limits, storage, sessions, audio streaming, Azure OpenAI/Claude/Fireworks usage, and deployment capacity.
SecurityL166-L229Security, identity, and governance for Foundry: auth/authorization patterns, Entra/RBAC, isolation, networking, data privacy, guardrails, safety policies, and secure tool/agent integrations.
ConfigurationL230-L320Configuring, deploying, securing, and monitoring Microsoft Foundry agents and models, including hosted/voice agents, networking, storage, evaluations, observability, and Azure OpenAI integrations.
Integrations & Coding Patternsintegrations.mdAPIs and patterns for integrating Foundry agents/models with tools, data, voice/telephony, Realtime, Azure/OpenAI services, MCP, LangChain, and managing them via REST and observability.
Deploymentdeployment.mdDeploying and operating Foundry agents/models: infra setup (azd, Bicep, Terraform), CI/CD, regional/ACR options, long‑running/steerable agents, evaluations, healthcare models, and outage recovery.

Troubleshooting

TopicURL
Check hosted agent project health with agent doctorhttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/agent-doctor
Troubleshoot Microsoft Foundry hosted agent issueshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/debug-hosted-agent
Troubleshoot publishing Foundry agents to Copilot and Teamshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/troubleshoot-publish-copilot
Resolve authorization errors for Foundry agents in Copilothttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/troubleshoot-publish-copilot-authorization
Troubleshoot Foundry interactive training errorshttps://learn.microsoft.com/en-us/azure/foundry/fine-tuning/interactive-post-training/troubleshoot
Recover Foundry Agent Service from resource and data losshttps://learn.microsoft.com/en-us/azure/foundry/how-to/agent-service-operator-disaster-recovery
Debug Foundry agents with Agent Inspector in VS Codehttps://learn.microsoft.com/en-us/azure/foundry/how-to/develop/vs-code-agent-inspector
Collect and analyze Foundry agent traces in VS Codehttps://learn.microsoft.com/en-us/azure/foundry/how-to/develop/vs-code-tracing
Troubleshoot Foundry evaluation and observability issueshttps://learn.microsoft.com/en-us/azure/foundry/observability/how-to/troubleshooting
Troubleshoot HTTP errors for Azure OpenAI in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/openai/how-to/troubleshoot-errors
Set up and troubleshoot Azure OpenAI webhookshttps://learn.microsoft.com/en-us/azure/foundry/openai/how-to/webhooks
Resolve known issues and workarounds for Microsoft Foundryhttps://learn.microsoft.com/en-us/azure/foundry/reference/foundry-known-issues

Best Practices

TopicURL
Apply tool usage best practices in Foundry agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/concepts/tool-best-practice
Apply best practices for Microsoft Foundry voice agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/concepts/voice-agent-best-practice
Create evaluation datasets for Foundry agent optimizerhttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/create-optimizer-dataset
Optimize instructions and prompts for Foundry voice agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/optimize-voice-agent-instructions
Recover long-running Foundry agents after crasheshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/recover-long-running-work
Steer in-flight turns for hosted agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/steer-hosted-agent
Use Task Adherence signals for Foundry agentshttps://learn.microsoft.com/en-us/azure/foundry/guardrails/task-adherence
Use Foundry Skill prompts for common workflowshttps://learn.microsoft.com/en-us/azure/foundry/how-to/develop/foundry-skills-scenarios-example-prompts
Fine-tune MedImageInsight Premium for medical imaginghttps://learn.microsoft.com/en-us/azure/foundry/how-to/healthcare-ai/fine-tune-medimageinsight-premium
Plan high availability and resiliency for Foundryhttps://learn.microsoft.com/en-us/azure/foundry/how-to/high-availability-resiliency
Design effective system messages for Azure OpenAIhttps://learn.microsoft.com/en-us/azure/foundry/openai/concepts/advanced-prompt-engineering
Understand and optimize Foundry model router behaviorhttps://learn.microsoft.com/en-us/azure/foundry/openai/concepts/model-router-how-it-works
Apply safety system message templates in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/openai/concepts/safety-system-message-templates
Apply vision fine-tuning best practices in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/openai/how-to/fine-tuning-vision
Optimize Azure OpenAI latency and throughput in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/openai/how-to/latency
Operate provisioned throughput deployments in productionhttps://learn.microsoft.com/en-us/azure/foundry/openai/how-to/provisioned-get-started

Decision Making

TopicURL
Choose networking options for Foundry Agent Servicehttps://learn.microsoft.com/en-us/azure/foundry/agents/concepts/networking-options
Understand pricing for Foundry voice agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/concepts/voice-agent-pricing
Plan migration to Foundry Agent Servicehttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/migrate
Decide and migrate to new Foundry agent modelhttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/migrate-agent-applications
Migrate from Voice Live to Foundry voice agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/migrate-from-voice-live
Choose the right web grounding tool for Foundry agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/web-overview
Choose the right Microsoft Foundry capabilityhttps://learn.microsoft.com/en-us/azure/foundry/concepts/capabilities
Use Foundry in Azure Government regions and endpointshttps://learn.microsoft.com/en-us/azure/foundry/concepts/foundry-azure-government
Plan general availability adoption of Microsoft Foundryhttps://learn.microsoft.com/en-us/azure/foundry/concepts/general-availability
Compare Foundry models using benchmarks and leaderboardshttps://learn.microsoft.com/en-us/azure/foundry/concepts/model-benchmarks
Plan Microsoft Foundry rollout topology and governancehttps://learn.microsoft.com/en-us/azure/foundry/concepts/planning
Estimate and manage Foundry fine-tuning costshttps://learn.microsoft.com/en-us/azure/foundry/fine-tuning/cost-management
Use Foundry to generate synthetic training datahttps://learn.microsoft.com/en-us/azure/foundry/fine-tuning/data-generation
Understand interactive training options in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/fine-tuning/interactive-post-training/overview
Choose fine-tuning methods and tiers in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/fine-tuning/overview
Choose and compare Claude models in Microsoft Foundryhttps://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/claude-models
Plan and understand Claude CCU billing in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/claude-models-billing
Compare Azure and Anthropic hosting for Claude modelshttps://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/claude-models-hosting-comparison
Choose Foundry model deployment types by scenariohttps://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/deployment-types
Select Foundry deployment types in Azure Governmenthttps://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/deployment-types-gov
Plan and execute model migration in Microsoft Foundryhttps://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/model-migration
Manage model versioning and upgrade policies in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/model-versions
Choose and manage model version policies in Foundry Govhttps://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/model-versions-gov
Choose partner and community Foundry modelshttps://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/models-from-partners
Select Azure-sold Foundry models by capabilities and regionshttps://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/models-sold-directly-by-azure
Choose Azure Government Foundry models by region and typehttps://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/models-sold-directly-by-azure-gov
Migrate applications from GitHub Models to Foundryhttps://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/quickstart-github-models
Plan disaster recovery for Foundry Agent Servicehttps://learn.microsoft.com/en-us/azure/foundry/how-to/agent-service-disaster-recovery
Use Foundry model leaderboard for selectionhttps://learn.microsoft.com/en-us/azure/foundry/how-to/benchmark-model-in-catalog
Choose Microsoft Foundry SDKs and project endpointshttps://learn.microsoft.com/en-us/azure/foundry/how-to/develop/sdk-overview
Select and use healthcare AI models in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/how-to/healthcare-ai/healthcare-ai-models
Choose and implement Foundry app integration patternshttps://learn.microsoft.com/en-us/azure/foundry/how-to/integrate-with-other-apps
Plan and execute migration from Foundry classic portalhttps://learn.microsoft.com/en-us/azure/foundry/how-to/navigate-from-classic
Upgrade Azure OpenAI resources to Microsoft Foundryhttps://learn.microsoft.com/en-us/azure/foundry/how-to/upgrade-azure-openai
Choose content streaming mode for Azure OpenAIhttps://learn.microsoft.com/en-us/azure/foundry/openai/concepts/content-streaming
Choose GPT Realtime Transcribe for low-latency streaminghttps://learn.microsoft.com/en-us/azure/foundry/openai/concepts/gpt-realtime-whisper
Plan for Foundry model retirement and replacementshttps://learn.microsoft.com/en-us/azure/foundry/openai/concepts/model-retirement-schedule
Use Azure Government model retirement schedule for migrationshttps://learn.microsoft.com/en-us/azure/foundry/openai/concepts/model-retirement-schedule-gov
Plan around Foundry Models lifecycle and retirementshttps://learn.microsoft.com/en-us/azure/foundry/openai/concepts/model-retirements
Plan for Foundry model lifecycle in Azure Governmenthttps://learn.microsoft.com/en-us/azure/foundry/openai/concepts/model-retirements-gov
Enable and evaluate priority processing in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/openai/concepts/priority-processing
Decide when to use Azure OpenAI prompt transformationhttps://learn.microsoft.com/en-us/azure/foundry/openai/concepts/prompt-transformation
Choose PTU billing mode and manage costshttps://learn.microsoft.com/en-us/azure/foundry/openai/concepts/provisioned-throughput-billing
Identify retired Foundry models and alternativeshttps://learn.microsoft.com/en-us/azure/foundry/openai/concepts/retired-models
Evaluate model router for quality, cost, and latencyhttps://learn.microsoft.com/en-us/azure/foundry/openai/how-to/evaluate-model-router
Choose and use Flex processing for Azure OpenAIhttps://learn.microsoft.com/en-us/azure/foundry/openai/how-to/flex-processing
Use model router with Foundry agents effectivelyhttps://learn.microsoft.com/en-us/azure/foundry/openai/how-to/model-router-agents
Size provisioned throughput units for Foundry workloadshttps://learn.microsoft.com/en-us/azure/foundry/openai/how-to/provisioned-throughput-sizing
Migrate from preview to GA GPT Realtime API protocolhttps://learn.microsoft.com/en-us/azure/foundry/openai/how-to/realtime-audio-preview-api-migration-guide

Architecture & Design Patterns

Limits & Quotas

TopicURL
Evaluate agent optimizer cost and token usagehttps://learn.microsoft.com/en-us/azure/foundry/agents/concepts/agent-optimizer-costs
Understand durable state store limits for hosted agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/concepts/agent-state-store
Quotas and limits for Microsoft Foundry Agent Servicehttps://learn.microsoft.com/en-us/azure/foundry/agents/concepts/limits-quotas-regions
Understand vector store limits and expiration in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/agents/concepts/vector-stores
Manage Foundry hosted agents and idle timeoutshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/manage-hosted-agent
Manage Foundry hosted agent sessions and timeoutshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/manage-hosted-sessions
Use function calling with Microsoft Foundry agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/function-calling
Evaluate Foundry with region support and rate limitshttps://learn.microsoft.com/en-us/azure/foundry/concepts/evaluation-regions-limits-virtual-network
Set AI Gateway token limits and quotas in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/configuration/enable-ai-api-management-gateway-portal
Configure token rate limits and quotas in Foundry Control Planehttps://learn.microsoft.com/en-us/azure/foundry/control-plane/how-to-enforce-limits-models
Understand Claude model quotas and rate limits in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/claude-models-quotas-limits
Reference quotas and limits for Foundry Modelshttps://learn.microsoft.com/en-us/azure/foundry/foundry-models/quotas-limits
Compare Fireworks model catalog limits and regionshttps://learn.microsoft.com/en-us/azure/foundry/how-to/fireworks/fireworks-model-catalog
Fine-tune and deploy CxrReportGen Premium with quotashttps://learn.microsoft.com/en-us/azure/foundry/how-to/healthcare-ai/fine-tune-cxrreportgen-premium
Manage Foundry model deployment quotas and TPM limitshttps://learn.microsoft.com/en-us/azure/foundry/how-to/quota
Manage provisioned throughput quotas for Foundry modelshttps://learn.microsoft.com/en-us/azure/foundry/openai/concepts/provisioned-throughput
Use Azure OpenAI global batch processing quotashttps://learn.microsoft.com/en-us/azure/foundry/openai/how-to/batch
Manage Azure OpenAI quota and rate limits in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/openai/how-to/quota
Review Azure OpenAI quotas and limits in Microsoft Foundryhttps://learn.microsoft.com/en-us/azure/foundry/openai/quotas-limits
Reference quotas and limits for Azure OpenAI in US Governmenthttps://learn.microsoft.com/en-us/azure/foundry/openai/quotas-limits-gov
Stream audio for Azure Foundry voice agent itemhttps://learn.microsoft.com/en-us/azure/foundry/reference/rest/agent-endpoint-conversations-get-agent-conversation-audio-item-content
Stream generated audio for Azure Foundry voice agenthttps://learn.microsoft.com/en-us/azure/foundry/reference/rest/agent-endpoint-conversations-get-agent-conversation-generated-audio-item-content
Delete files and directories in Azure Foundry agent session sandboxhttps://learn.microsoft.com/en-us/azure/foundry/reference/rest/agent-session-files-delete-session-file
Upload file to Azure Foundry agent session sandboxhttps://learn.microsoft.com/en-us/azure/foundry/reference/rest/agent-session-files-upload-session-file
Establish WebSocket connection to Azure Foundry hosted agenthttps://learn.microsoft.com/en-us/azure/foundry/reference/rest/agent-websocket-connect-endpoint-websocket
Stream console logs via SSE for Azure Foundry hosted agent sessionhttps://learn.microsoft.com/en-us/azure/foundry/reference/rest/agents-get-session-log-stream

Security

TopicURL
Integrate Foundry agents with Microsoft Agent 365https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/agent-365-integration
Choose authorization options for Foundry agent endpointshttps://learn.microsoft.com/en-us/azure/foundry/agents/concepts/agent-endpoint-authorization
Understand and govern Foundry agent identitieshttps://learn.microsoft.com/en-us/azure/foundry/agents/concepts/agent-identity
Choose authentication methods for A2A tools in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/agents/concepts/agent-to-agent-authentication
Manage Entra consent for delegated agent accesshttps://learn.microsoft.com/en-us/azure/foundry/agents/concepts/entra-delegated-access-consent
Reference permissions for Foundry hosted agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/concepts/hosted-agent-permissions
Use hosted-agent token service for downstream accesshttps://learn.microsoft.com/en-us/azure/foundry/agents/concepts/hosted-agent-token-service
Select user delegation methods for Foundry toolshttps://learn.microsoft.com/en-us/azure/foundry/agents/concepts/user-delegation
Set up secure environment for Foundry Agent Servicehttps://learn.microsoft.com/en-us/azure/foundry/agents/environment-setup
Attach RAI guardrails to Foundry hosted agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/add-hosted-agent-guardrails
Publish and secure Microsoft Foundry agent applicationshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/agent-applications
Configure Agent 365 data collection for Foundryhttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/configure-agent-365-data-collection
Configure endpoint authorization for Foundry agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/configure-agent-endpoint-authorization
Configure user delegation for Foundry agent toolshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/configure-user-delegation
Assign Agent 365 observability app role in Entrahttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/grant-agent-365-permissions
Isolate Microsoft Foundry hosted agent sessionshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/isolate-sessions-per-user
Control and disable Grounding with Bing accesshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/manage-grounding-with-bing
Configure MCP server authentication for Foundry agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/mcp-authentication
Multiplex users safely in Foundry agent sessionshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/multiplex-session-users
Migrate Foundry agent isolation keys to identitieshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/pass-isolation-keys
Secure private container registries for Foundry hosted agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/private-registry-connections
Securely use the computer use tool in Foundry agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/computer-use
Govern MCP tools via AI gateway and API Managementhttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/governance
Ground Foundry agents with SharePoint while preserving access controlshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/sharepoint
Configure toolbox authentication and identity passthroughhttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/tool-authentication
Configure private networking for Foundry Agent Servicehttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/virtual-networks
Map elevated Azure roles to Foundry admin taskshttps://learn.microsoft.com/en-us/azure/foundry/concepts/administrator-guide
Configure authentication and RBAC for Microsoft Foundryhttps://learn.microsoft.com/en-us/azure/foundry/concepts/authentication-authorization-foundry
Configure VNet support for Foundry evaluationshttps://learn.microsoft.com/en-us/azure/foundry/concepts/evaluation-virtual-network
Configure RBAC roles and scopes in Microsoft Foundryhttps://learn.microsoft.com/en-us/azure/foundry/concepts/rbac-foundry
Control Foundry agent availability with Entra governancehttps://learn.microsoft.com/en-us/azure/foundry/control-plane/govern-agent-infrastructure-entra-admin
Configure compliance and security for Foundry control planehttps://learn.microsoft.com/en-us/azure/foundry/control-plane/how-to-manage-compliance-security
Create and apply Foundry guardrail policieshttps://learn.microsoft.com/en-us/azure/foundry/control-plane/quickstart-create-guardrail-policy
Configure Entra ID keyless auth for Foundry Modelshttps://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/configure-entra-id
Understand default safety policies in Microsoft Foundryhttps://learn.microsoft.com/en-us/azure/foundry/guardrails/default-safety-policies
Configure guided safety and security guardrails for agentshttps://learn.microsoft.com/en-us/azure/foundry/guardrails/guided-set-up
Add Microsoft Foundry resources to network security perimetershttps://learn.microsoft.com/en-us/azure/foundry/how-to/add-foundry-to-network-security-perimeter
Create custom Azure Policies for Microsoft Foundry governancehttps://learn.microsoft.com/en-us/azure/foundry/how-to/custom-policy-definition
Apply Foundry Content Safety middleware in LangChainhttps://learn.microsoft.com/en-us/azure/foundry/how-to/develop/langchain-middleware
Restrict preview features in Microsoft Foundry environmentshttps://learn.microsoft.com/en-us/azure/foundry/how-to/disable-preview-features
Configure managed virtual networks for Microsoft Foundryhttps://learn.microsoft.com/en-us/azure/foundry/how-to/managed-virtual-network
Use built-in Azure Policies to govern Foundry model deploymenthttps://learn.microsoft.com/en-us/azure/foundry/how-to/model-deployment-policy
Govern Foundry model router deployments with Azure Policyhttps://learn.microsoft.com/en-us/azure/foundry/how-to/model-router-policy
Apply security and governance to Foundry MCP Server toolshttps://learn.microsoft.com/en-us/azure/foundry/mcp/security-best-practices
Control and govern trace data collection in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/observability/concepts/trace-data
Assign roles for Microsoft Foundry evaluation workflowshttps://learn.microsoft.com/en-us/azure/foundry/observability/how-to/evaluation-permissions
Configure Entra auth for Foundry trace ingestionhttps://learn.microsoft.com/en-us/azure/foundry/observability/how-to/trace-ingestion-entra-authentication
Restrict access to sensitive content in Foundry traceshttps://learn.microsoft.com/en-us/azure/foundry/observability/how-to/traces-sensitive-content
Design safety system messages for Azure OpenAI in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/openai/concepts/system-message
Apply safety evaluation to fine-tuned modelshttps://learn.microsoft.com/en-us/azure/foundry/openai/how-to/fine-tuning-safety-evaluation
Create hosted session for Azure Foundry agent endpointhttps://learn.microsoft.com/en-us/azure/foundry/reference/rest/agents-create-session
Retrieve SAS credentials for Azure Foundry datasetshttps://learn.microsoft.com/en-us/azure/foundry/reference/rest/datasets-get-credentials
Get temporary storage credentials for Azure Foundry model assetshttps://learn.microsoft.com/en-us/azure/foundry/reference/rest/models-get-credentials
Create short-lived Realtime client secrets for Azure Foundry sessionshttps://learn.microsoft.com/en-us/azure/foundry/reference/rest/realtime-create-realtime-client-secret
Create ephemeral tokens and Realtime sessions for Azure Foundry clientshttps://learn.microsoft.com/en-us/azure/foundry/reference/rest/realtime-create-realtime-session
Create ephemeral transcription sessions and tokens in Azure Foundryhttps://learn.microsoft.com/en-us/azure/foundry/reference/rest/realtime-create-realtime-transcription-session
Create short-lived translation client secrets and sessions in Azure Foundryhttps://learn.microsoft.com/en-us/azure/foundry/reference/rest/realtime-create-realtime-translation-client-secret
Configure data privacy and security for Foundry Agent Servicehttps://learn.microsoft.com/en-us/azure/foundry/responsible-ai/agents/data-privacy-security
Understand data privacy for Claude models in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/responsible-ai/claude-models/data-privacy
Understand data privacy and security for Foundry Modelshttps://learn.microsoft.com/en-us/azure/foundry/responsible-ai/openai/data-privacy

Configuration

TopicURL
Define Foundry hosted agents with agent.yaml schemahttps://learn.microsoft.com/en-us/azure/foundry/agents/concepts/agent-yaml-reference
Configure hosted agents with azd azure.yaml referencehttps://learn.microsoft.com/en-us/azure/foundry/agents/concepts/azure-yaml-reference
Configure capability hosts for Foundry Agent Servicehttps://learn.microsoft.com/en-us/azure/foundry/agents/concepts/capability-hosts
Implement hosted agent runtime contract in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/agents/concepts/hosted-agent-contract
Monitor and evaluate Foundry voice agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/concepts/voice-agent-observability
Add human-in-the-loop pauses to Foundry agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/add-human-in-the-loop
Inspect local Foundry agents with Agent Inspectorhttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/agent-inspector
Author azure.yaml configuration for Foundry hosted agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/author-azure-yaml
Configure Foundry project context for azdhttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/cli-project-context
Configure and publish Microsoft Foundry agent endpointshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/configure-agent
Configure environment variables for Foundry hosted agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/configure-hosted-agent-env-variables
Configure OpenTelemetry export for Foundry hosted agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/configure-hosted-agent-telemetry
Configure Microsoft Foundry voice agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/configure-voice-agent
Configure Connected Foundry Models in Agent Servicehttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/connected-models
Disable classic agents and assistants in Azure OpenAIhttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/disable-classic-agents
Configure private inbound connectivity for Foundry IQhttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/foundry-iq-tutorial-private-inbound
Configure private outbound dependencies for Foundry IQhttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/foundry-iq-tutorial-private-outbound
Initialize a hosted agent project with azdhttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/init-agent-project
Install and verify azd Foundry AI extensionshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/install-cli-foundry-extensions
Configure durable state for long-running Foundry agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/manage-task-state
Stream and filter logs for Foundry hosted agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/monitor-hosted-agent-logs
Configure a private skill catalog for Foundry agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/private-skill-catalog
Create a private MCP tool catalog with API Centerhttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/private-tool-catalog
Publish Foundry agents to Microsoft 365 and Teams via RESThttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/publish-copilot-virtual-network
Register external agents for Foundry observabilityhttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/register-external-agent
Configure local run settings for Foundry hosted agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/run-hosted-agent-locally
Configure reconnectable streaming for Foundry agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/stream-with-reconnect
Configure structured inputs for Foundry agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/structured-inputs
Configure custom MCP code interpreter for Foundry agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/custom-code-interpreter
Author and manage skills for Microsoft Foundry agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/skills
Configure and manage Microsoft Foundry toolboxeshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/toolbox
Configure and manage toolboxes for Foundry hosted agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/toolbox
Update Foundry hosted agent endpoints via azdhttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/update-agent-endpoint-cli
Reconfigure model deployment for Foundry hosted agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/update-hosted-agent-model
Automate azd AI usage with coding agents and scriptshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/use-cli-with-coding-agents
Configure and manage Foundry agent routineshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/use-routines
Configure subagents within Microsoft Foundry voice agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/use-subagent-voice-first-agent
Configure Foundry Agent Service with your own Azure resourceshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/use-your-own-resources
Publish and share Foundry voice agentshttps://learn.microsoft.com/en-us/azure/foundry/agents/how-to/voice-agent-channels-publish
Configure customer-managed keys for Foundry resourceshttps://learn.microsoft.com/en-us/azure/foundry/concepts/encryption-keys-portal
Register and configure custom agents in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/control-plane/register-custom-agent
Configure Claude Code CLI and VS Code for Foundryhttps://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/configure-claude-code
Configure Claude Desktop to use Microsoft Foundry inferencehttps://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/configure-claude-desktop
Configure monitoring for Foundry model deploymentshttps://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/monitor-models
Deploy and use FLUX image models in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/use-foundry-models-flux
Configure and use MAI-Thinking-1 in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/use-foundry-models-mai-thinking
Configure guardrails and controls in Microsoft Foundryhttps://learn.microsoft.com/en-us/azure/foundry/guardrails/how-to-create-guardrails
Connect Microsoft Foundry to customer-managed storagehttps://learn.microsoft.com/en-us/azure/foundry/how-to/bring-your-own-azure-storage-foundry
Configure BYOS storage for Foundry Speech and Languagehttps://learn.microsoft.com/en-us/azure/foundry/how-to/bring-your-own-azure-storage-speech-language-services
Configure Private Link network isolation for Foundryhttps://learn.microsoft.com/en-us/azure/foundry/how-to/configure-private-link
Configure and add connections in Microsoft Foundryhttps://learn.microsoft.com/en-us/azure/foundry/how-to/connections-add
Create and configure Microsoft Foundry projectshttps://learn.microsoft.com/en-us/azure/foundry/how-to/create-projects
Provision Microsoft Foundry resources with Terraformhttps://learn.microsoft.com/en-us/azure/foundry/how-to/create-resource-terraform
Prepare a development environment for Foundryhttps://learn.microsoft.com/en-us/azure/foundry/how-to/develop/install-cli-sdk
Use Microsoft Foundry Skill with coding agentshttps://learn.microsoft.com/en-us/azure/foundry/how-to/develop/use-microsoft-foundry-skill
Configure diagnostic logging for Microsoft Foundryhttps://learn.microsoft.com/en-us/azure/foundry/how-to/diagnostic-logging
Run evaluations from Microsoft Foundry portalhttps://learn.microsoft.com/en-us/azure/foundry/how-to/evaluate-generative-ai-app
View and analyze evaluation results in Foundry portalhttps://learn.microsoft.com/en-us/azure/foundry/how-to/evaluate-results
Import and deploy custom Fireworks models in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/how-to/fireworks/import-custom-models
Configure health and performance alerts for Foundryhttps://learn.microsoft.com/en-us/azure/foundry/how-to/stay-informed-service-health
Configure and use Insights for Foundry agentshttps://learn.microsoft.com/en-us/azure/foundry/observability/how-to/agent-insights
Configure and run benchmark evaluations in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/observability/how-to/benchmark-evaluations
Set up cloud evaluations with Foundry SDKhttps://learn.microsoft.com/en-us/azure/foundry/observability/how-to/cloud-evaluation
Evaluate deployed interactions via Foundry SDKhttps://learn.microsoft.com/en-us/azure/foundry/observability/how-to/cloud-evaluation-deployed-interactions
Retrieve and interpret Foundry cloud evaluation resultshttps://learn.microsoft.com/en-us/azure/foundry/observability/how-to/cloud-evaluation-results
Use Foundry evaluation dataset schema and fieldshttps://learn.microsoft.com/en-us/azure/foundry/observability/how-to/evaluation-dataset-schema
Prepare and structure Foundry evaluation datasetshttps://learn.microsoft.com/en-us/azure/foundry/observability/how-to/evaluation-datasets
Monitor Foundry agents with Agent Monitoring Dashboardhttps://learn.microsoft.com/en-us/azure/foundry/observability/how-to/how-to-monitor-agents-dashboard
Set up human evaluation for Foundry agentshttps://learn.microsoft.com/en-us/azure/foundry/observability/how-to/human-evaluation
Configure end user feedback logging with OpenTelemetryhttps://learn.microsoft.com/en-us/azure/foundry/observability/how-to/log-end-user-feedback
Analyze agent traces with Trace Replay in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/observability/how-to/trace-agent-replay
Set up tracing for AI agents with Application Insightshttps://learn.microsoft.com/en-us/azure/foundry/observability/how-to/trace-agent-setup
Convert Foundry agent traces into evaluation datasetshttps://learn.microsoft.com/en-us/azure/foundry/observability/how-to/traces-to-dataset
Configure and run evaluations for a hosted agenthttps://learn.microsoft.com/en-us/azure/foundry/observability/quickstarts/quickstart-evaluate-hosted-agent
Configure and use Azure OpenAI v1 API in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/openai/api-version-lifecycle
Configure groundedness detection for RAG in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/openai/concepts/content-filter-groundedness
Configure GPT-Live events and session settingshttps://learn.microsoft.com/en-us/azure/foundry/openai/gpt-live-reference
Automate Azure OpenAI deployments and TPM quota settingshttps://learn.microsoft.com/en-us/azure/foundry/openai/how-to/automate-quota-deployments
Configure Azure OpenAI image generation modelshttps://learn.microsoft.com/en-us/azure/foundry/openai/how-to/dall-e
Configure GPT-Live delegation and client actionshttps://learn.microsoft.com/en-us/azure/foundry/openai/how-to/gpt-live-delegation
Configure and use model router in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/openai/how-to/model-router
Inspect model router metadata for routing analysishttps://learn.microsoft.com/en-us/azure/foundry/openai/how-to/monitor-model-router
Create and manage reusable skills for Responses API shellhttps://learn.microsoft.com/en-us/azure/foundry/openai/how-to/skills
Configure spillover traffic management for provisioned Azure OpenAI deploymentshttps://learn.microsoft.com/en-us/azure/foundry/openai/how-to/spillover-traffic-management
Monitor Azure OpenAI Foundry with Azure Monitorhttps://learn.microsoft.com/en-us/azure/foundry/openai/monitor-openai-reference
Configure Azure OpenAI Realtime API events in Foundryhttps://learn.microsoft.com/en-us/azure/foundry/openai/realtime-audio-reference
Configure text watermarking for Foundry GPT deploymentshttps://learn.microsoft.com/en-us/azure/foundry/responsible-ai/content-safety/enable-text-watermarking-gpt-models

FAQ

What does the microsoft-foundry skill do?

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, voice/telephony, Realtime, MCP tools, or LangChain integrations, and other Microsoft Foundry related development tasks. Not for Content Safety in Foundry Control Plane (use azure-content-safety), Azure Content Understanding in Foundry Tools (use azure-content-understanding), Azure Speech in Foundry Tools (use azure-speech), Microsoft Foundry Classic (use microsoft-foundry-classic).

How do I install microsoft-foundry?

Run npx skills add https://github.com/microsoftdocs/agent-skills --skill microsoft-foundry in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/microsoft-foundry/ (personal) or .claude/skills/microsoft-foundry/ (project).

Which AI agents can use microsoft-foundry?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is microsoft-foundry safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains microsoft-foundry?

It is published by microsoftdocs in microsoftdocs/agent-skills. It has 263 recorded installs.

More from microsoftdocs/agent-skills

View all →

azure-container-apps

microsoftdocs/agent-skills

Expert knowledge for Azure Container Apps development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when configuring ACA auth/networking, workload profiles/GPUs, CI/CD deployments, KEDA/Dapr scaling, or Java microservices, and other Azure Container Apps related development tasks. Not for Azure App Service (use azure-app-service), Azure Functions (use azure-functions), Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure Spring Apps (use azure-spring-apps).

DevOps & Cloud1.3K installs

azure-sql-database

microsoftdocs/agent-skills

Expert knowledge for Azure SQL Database development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when choosing DTU/vCore tiers, configuring serverless or Hyperscale, geo-replication/DR, CI/CD, or Terraform, and other Azure SQL Database related development tasks. Not for Azure SQL Managed Instance (use azure-sql-managed-instance), SQL Server on Azure Virtual Machines (use azure-sql-virtual-machines), Azure Cosmos DB (use azure-cosmos-db), Azure Data Factory (use azure-data-factory).

Data & Databases1.3K installs

azure-well-architected

microsoftdocs/agent-skills

Expert guidance for designing, assessing, and optimizing Azure workloads using Azure Well Architected. Covers design review checklists, recommendations, design principles, tradeoffs, service guides, workload patterns, and assessment questions. Use when designing AI/HPC/SaaS workloads, AVD/AVS deployments, WAF assessments, or App Service/AKS/SQL architectures, and other Azure Well Architected related development tasks.

DevOps & Cloud646 installs

azure-pipelines

microsoftdocs/agent-skills

Expert knowledge for Azure Pipelines development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when configuring YAML pipelines, agents, service connections, Key Vault secrets, or Kubernetes/web app deployments, and other Azure Pipelines related development tasks. Not for Azure DevOps (use azure-devops), Azure Boards (use azure-boards), Azure Repos (use azure-repos), Azure Test Plans (use azure-test-plans).

DevOps & Cloud439 installs

azure-architecture

microsoftdocs/agent-skills

Expert guidance for designing Azure solutions using Azure Architecture. Covers reference architectures, solution ideas, design patterns, technology choices, architecture styles, best practices, anti-patterns, example workloads, and migration guides. Use when designing AKS or App Service apps, SAP/ERP or IoT workloads, hybrid/Arc setups, or AI/ML solutions on Azure, and other Azure Architecture related development tasks.

azure-devops

microsoftdocs/agent-skills

Expert knowledge for Azure DevOps development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when managing org/projects, repos, pipelines, work items, dashboards/analytics, or Azure DevOps Server deployments, and other Azure DevOps related development tasks. Not for Azure Boards (use azure-boards), Azure Pipelines (use azure-pipelines), Azure Repos (use azure-repos), Azure Test Plans (use azure-test-plans).

DevOps & Cloud407 installs

Popular ai & agents skills

View category →

google-agents-cli-publish

google/agents-cli

This skill should be used when the user wants to "publish an agent", "publish my ADK agent", "register an agent with Gemini", "publish to Gemini" (formerly Gemini Enterprise), or needs guidance on the agents-cli publish gemini command. Also use when the user wants to "manage agents in Agent Registry", "list/update/delete registered agents", or "register an MCP server". Covers ADK vs A2A registration modes, programmatic and interactive usage, flag reference, auto-detection from deployment metadata, Agent Registry fleet management, and troubleshooting. Part of the agents-cli skills suite. Do NOT use for deployment (use google-agents-cli-deploy).

AI & Agents513.9K installs

google-agents-cli-eval

google/agents-cli

This skill should be used when the user wants to "run an evaluation", "evaluate my agent", "evaluate my ADK agent", "write an eval dataset", "analyze eval failures", "compare eval results", "optimize agent", or needs guidance on the Gemini platform eval methodology and the Quality Flywheel. Covers eval metrics, dataset schema, LLM-as-judge scoring, and common failure causes. Applies to any agents-cli project, whatever framework the agent is written in. Do NOT use for agent API code patterns (ADK: use google-agents-cli-adk-code), deployment (use google-agents-cli-deploy), or project scaffolding (use google-agents-cli-scaffold).

AI & Agents513.5K installs

skill-creator

anthropics/skills

Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.

OfficialAI & Agents416.4K installs

codex-pet

prime-skills/runcomfy-agent-skills

Codex Pet generator on RunComfy. Build a Codex-compatible Codex Pet spritesheet.webp + pet.json from a single reference image, drop it into ${CODEXHOME:-$HOME/.codex}/pets/ / and Codex picks it up as a custom Codex Pet next to the 8 built-ins. This skill produces the exact Codex Pet atlas Codex expects (1536x1872 PNG/WebP, 8 cols x 9 rows, 192x208 cells, 9 animation states — idle, running-right, running-left, waving, jumping, failed, waiting, running, review). Calls OpenAI GPT Image 2 edit ONCE via the local RunComfy CLI as runcomfy run openai/gpt-image-2/edit to produce a canonical Codex Pet pose, then assembles all 9 animation rows programmatically with ImageMagick micro-transforms — no Codex Pro, no $imagegen, no OPENAIAPIKEY required, only RUNCOMFYTOKEN. Triggers on "codex pet", "create codex pet", "make codex pet", "hatch codex pet", "/hatch image", "desktop pet codex", "codex pets", "spritesheet.webp", or any explicit ask to build a custom pet for OpenAI Codex.

AI & Agents402.1K installs

full-output-enforcement

leonxlnx/taste-skill

Overrides default LLM truncation behavior. Enforces complete code generation, bans placeholder patterns, and handles token-limit splits cleanly. Apply to any task requiring exhaustive, unabridged output.

AI & Agents401K installs

executing-plans

obra/superpowers

Use when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available

AI & Agents245.7K installs