SkillRepo
Sign InSign Up
Catalog
MicrosoftDocs/microsoft-foundry

MicrosoftDocs

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/Claude, VNet isolation, model routing, M365/Teams integration, or evals, 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).

v1.0Latest
New~10.0kUpdated Jun 26, 2026

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-L45 Diagnosing and recovering from Foundry model/agent failures, evaluation and observability issues, webhook problems, and known service bugs with workarounds.
Best Practices L46-L59 Best practices for prompts, tools, safety messages, routing, evaluation, and fine-tuning so you can design, operate, and measure high-quality Azure/Foundry AI agents in production
Decision Making L60-L95 Guides for choosing models, deployments, regions, costs, and lifecycle policies, plus planning migrations (classic, GitHub, Azure OpenAI), DR, and optimal agent/model configuration.
Architecture & Design Patterns L96-L102 Designing Foundry agent architectures: VNet/subnet sizing, isolated resource layouts, high availability patterns, and model router patterns for routing and scaling AI workloads.
Limits & Quotas L103-L123 Quotas, limits, regions, and rate caps for Foundry models, agents, sessions, Azure OpenAI, Claude, batch, caching, and tools to size, control, and safeguard usage and costs
Security L124-L160 Security, identity, and compliance for Foundry: auth/RBAC, agent identities, private networking, guardrails/safety, data privacy, keys, policies, and securing MCP/Agent 365 access.
Configuration L161-L220 Configuring Foundry agents, models, tools, security, networking, monitoring, and evaluations, including Azure OpenAI, Fireworks, tracing, guardrails, and automation workflows.
Integrations & Coding Patterns L221-L303 Patterns and code to integrate Foundry agents/models with tools, data, gateways, observability, LangChain/LangGraph, Azure OpenAI features, fine-tuning, and real-time/Responses APIs.
Deployment L304-L324 Deploying and publishing Foundry agents and models (hosted, containerized, voice, VNet), integrating with M365/Teams/DevOps, and running cloud evaluations and red-teaming.

Troubleshooting

Topic URL
Troubleshoot and understand Foundry partner models https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/models-from-partners
Recover Foundry Agent Service from resource and data loss https://learn.microsoft.com/en-us/azure/foundry/how-to/agent-service-operator-disaster-recovery
Troubleshoot Foundry evaluation and observability issues https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/troubleshooting
Set up and troubleshoot Azure OpenAI webhooks https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/webhooks
Known issues and workarounds for Microsoft Foundry services https://learn.microsoft.com/en-us/azure/foundry/reference/foundry-known-issues

Best Practices

Topic URL
Apply tool usage best practices in Foundry agents https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/tool-best-practice
Evaluate Foundry AI agents with built-in evaluators 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 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
Apply routing modes and best practices for model router https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/model-router-how-it-works
Apply safety system message templates in Foundry https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/safety-system-message-templates
Author safety-focused system messages in Foundry https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/system-message
Fine-tune GPT-4 vision models with images https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/fine-tuning-vision
Operate provisioned throughput deployments in production https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/provisioned-get-started

Decision Making

Topic URL
Decide how to migrate to the new Foundry Agent Service https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/migrate
Decide and migrate from legacy Agent Applications to new Foundry model https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/migrate-agent-applications
Choose the right web grounding tool for Foundry agents https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/web-overview
Plan migration to the GA Microsoft Foundry portal https://learn.microsoft.com/en-us/azure/foundry/concepts/general-availability
Plan and manage Microsoft Foundry cost usage https://learn.microsoft.com/en-us/azure/foundry/concepts/manage-costs
Plan and choose managed compute for Foundry models https://learn.microsoft.com/en-us/azure/foundry/concepts/managed-compute-overview
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
Choose and manage model version policies in Foundry Gov https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/model-versions-gov
Choose Foundry model deployment regions and types https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/models-sold-directly-by-azure-region-availability
Upgrade workloads from GitHub Models to Foundry Models https://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/quickstart-github-models
Plan disaster recovery for Foundry Agent Service https://learn.microsoft.com/en-us/azure/foundry/how-to/agent-service-disaster-recovery
Use Foundry model leaderboard for selection https://learn.microsoft.com/en-us/azure/foundry/how-to/benchmark-model-in-catalog
Interpret and compare Foundry evaluation results https://learn.microsoft.com/en-us/azure/foundry/how-to/evaluate-results
Select and understand healthcare AI models in Foundry https://learn.microsoft.com/en-us/azure/foundry/how-to/healthcare-ai/healthcare-ai-models
Choose integration patterns for Microsoft Foundry APIs https://learn.microsoft.com/en-us/azure/foundry/how-to/integrate-with-other-apps
Plan migration from Foundry classic to current portal https://learn.microsoft.com/en-us/azure/foundry/how-to/navigate-from-classic
Decide when to upgrade Azure OpenAI to Foundry https://learn.microsoft.com/en-us/azure/foundry/how-to/upgrade-azure-openai
Use Ask AI to upgrade or switch models https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/optimization-model-upgrade
Choose content streaming and filtering modes in Foundry https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/content-streaming
Use Foundry model retirement schedule for migrations https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/model-retirement-schedule
Use the Foundry Gov model retirement schedule for migration https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/model-retirement-schedule-gov
Plan around Foundry model lifecycle and support https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/model-retirements
Plan around Foundry model lifecycle and retirements in Gov https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/model-retirements-gov
Plan and size provisioned throughput in Foundry https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/provisioned-throughput
Choose PTU billing mode and manage costs https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/provisioned-throughput-billing
Identify retired Foundry models and alternatives https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/retired-models
Estimate and manage fine-tuning costs in Foundry https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/fine-tuning-cost-management
Use Foundry model router with agents for optimal model selection https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/model-router-agents
Migrate from preview to GA Realtime API https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/realtime-audio-preview-api-migration-guide

Architecture & Design Patterns

Topic URL
Design networking and subnet sizing for Foundry agents https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/agents-networking-deep-dive
Plan standard agent setup with isolated resources https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/standard-agent-setup
Design high availability for Microsoft Foundry agents https://learn.microsoft.com/en-us/azure/foundry/how-to/high-availability-resiliency

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
Manage hosted agents and lifecycle behavior in Foundry https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/manage-hosted-agent
Manage hosted agent sessions and time-based limits https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/manage-hosted-sessions
Rate limits and regional support for Foundry evaluations 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
Generate synthetic training data in Foundry (Preview) https://learn.microsoft.com/en-us/azure/foundry/fine-tuning/data-generation
Compare Claude model capabilities, quotas, and regions in Foundry https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/claude-models
Reference quotas and limits for Foundry Models https://learn.microsoft.com/en-us/azure/foundry/foundry-models/quotas-limits
Manage Microsoft Foundry model deployment quotas https://learn.microsoft.com/en-us/azure/foundry/how-to/quota
Use Azure OpenAI global batch processing and quotas https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/batch
Use prompt caching to reduce Azure OpenAI costs https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/prompt-caching
Calculate PTU sizing using per-model throughput https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/provisioned-throughput-sizing
Manage Azure OpenAI quota and rate limits in Foundry https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/quota
Use reinforcement fine-tuning with cost safeguards https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/reinforcement-fine-tuning
Azure OpenAI quotas and limits in Foundry https://learn.microsoft.com/en-us/azure/foundry/openai/quotas-limits
Reference quotas and limits for Azure OpenAI in Azure Government https://learn.microsoft.com/en-us/azure/foundry/openai/quotas-limits-gov

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
Reference hosted agent permissions and RBAC in Foundry https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/hosted-agent-permissions
Configure environment and RBAC for Foundry agents https://learn.microsoft.com/en-us/azure/foundry/agents/environment-setup
Understand Foundry Agent Service data and access https://learn.microsoft.com/en-us/azure/foundry/agents/faq
Attach content safety guardrails to Foundry hosted agents https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/add-hosted-agent-guardrails
Publish Foundry agent applications with auth and permissions https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/agent-applications
Configure Agent 365 data collection for Foundry https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/configure-agent-365-data-collection
Grant Agent 365 observability permissions to Foundry agents https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/grant-agent-365-permissions
Control and disable Grounding with Bing access https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/manage-grounding-with-bing
Configure authentication for MCP servers in Foundry https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/mcp-authentication
Govern MCP tools via AI gateway and API Management https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/governance
Configure private networking for Foundry Agent Service https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/virtual-networks
Configure authentication and authorization in Microsoft Foundry https://learn.microsoft.com/en-us/azure/foundry/concepts/authentication-authorization-foundry
Configure customer-managed keys for Microsoft Foundry https://learn.microsoft.com/en-us/azure/foundry/concepts/encryption-keys-portal
Use RBAC roles and scopes in Microsoft Foundry https://learn.microsoft.com/en-us/azure/foundry/concepts/rbac-foundry
Govern Foundry agent infrastructure as Entra admin https://learn.microsoft.com/en-us/azure/foundry/control-plane/govern-agent-infrastructure-entra-admin
Manage Foundry compliance and security integrations https://learn.microsoft.com/en-us/azure/foundry/control-plane/how-to-manage-compliance-security
Create and apply Foundry guardrail policies https://learn.microsoft.com/en-us/azure/foundry/control-plane/quickstart-create-guardrail-policy
Configure keyless Entra ID authentication for Foundry Models https://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/configure-entra-id
Configure guided safety and security guardrails for agents https://learn.microsoft.com/en-us/azure/foundry/guardrails/guided-set-up
Configure private endpoints for Microsoft Foundry isolation https://learn.microsoft.com/en-us/azure/foundry/how-to/configure-private-link
Create custom Azure Policy rules for Foundry resources https://learn.microsoft.com/en-us/azure/foundry/how-to/custom-policy-definition
Restrict Microsoft Foundry preview features with RBAC and tags https://learn.microsoft.com/en-us/azure/foundry/how-to/disable-preview-features
Secure Foundry with managed virtual network isolation https://learn.microsoft.com/en-us/azure/foundry/how-to/managed-virtual-network
Enforce AI model deployment policies in Foundry https://learn.microsoft.com/en-us/azure/foundry/how-to/model-deployment-policy
Enforce Foundry model router choices with Azure Policy https://learn.microsoft.com/en-us/azure/foundry/how-to/model-router-policy
Secure Foundry MCP Server with RBAC and policies https://learn.microsoft.com/en-us/azure/foundry/mcp/security-best-practices
Understand default Guardrail safety policies in Foundry https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/default-safety-policies
Apply safety evaluation to fine-tuned models https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/fine-tuning-safety-evaluation
Understand data privacy and security in Foundry Agent Service https://learn.microsoft.com/en-us/azure/foundry/responsible-ai/agents/data-privacy-security
Understand data privacy and security for Claude in Foundry https://learn.microsoft.com/en-us/azure/foundry/responsible-ai/claude-models/data-privacy
Understand data privacy and security for Foundry Models https://learn.microsoft.com/en-us/azure/foundry/responsible-ai/openai/data-privacy

Configuration

Topic URL
Configure capability hosts for Foundry Agent Service https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/capability-hosts
Configure and publish Microsoft Foundry agent endpoints https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/configure-agent
Configure Connected Foundry Models in Agent Service https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/connected-models
Disable classic agents and assistants in Azure OpenAI https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/disable-classic-agents
Configure and use memory in Foundry Agent Service https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/memory-usage
Configure a private tool catalog for Foundry agents https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/private-tool-catalog
Configure structured inputs to customize agent behavior https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/structured-inputs
Configure Browser Automation tool for Foundry agents https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/browser-automation
Configure custom MCP-based code interpreter for Foundry agents https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/custom-code-interpreter
Configure tool search for large Foundry toolboxes https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/tool-search
Automate Foundry agents with routines https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/use-routines
Configure Foundry agents to use existing Azure resources https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/use-your-own-resources
Use built-in evaluators in Microsoft Foundry https://learn.microsoft.com/en-us/azure/foundry/concepts/built-in-evaluators
Configure rubric evaluators for Foundry agents https://learn.microsoft.com/en-us/azure/foundry/concepts/evaluation-evaluators/rubric-evaluators
Configure AI Gateway token limits in Foundry https://learn.microsoft.com/en-us/azure/foundry/configuration/enable-ai-api-management-gateway-portal
Register and configure custom agents in Foundry https://learn.microsoft.com/en-us/azure/foundry/control-plane/register-custom-agent
Use Foundry Models endpoints and authentication correctly https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/endpoints
Configure Claude Code CLI and VS Code for Foundry https://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/configure-claude-code
Configure Claude Desktop to use Microsoft Foundry https://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/configure-claude-desktop
Configure Azure Monitor for Foundry model deployments https://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/monitor-models
Configure guardrails and controls in Microsoft Foundry https://learn.microsoft.com/en-us/azure/foundry/guardrails/how-to-create-guardrails
Configure Foundry managed network access to on-premises https://learn.microsoft.com/en-us/azure/foundry/how-to/access-on-premises-resources
Configure bring-your-own storage for Microsoft Foundry https://learn.microsoft.com/en-us/azure/foundry/how-to/bring-your-own-azure-storage-foundry
Set up BYOS for Speech and Language in Foundry https://learn.microsoft.com/en-us/azure/foundry/how-to/bring-your-own-azure-storage-speech-language-services
Run model and agent evaluations in Foundry portal https://learn.microsoft.com/en-us/azure/foundry/how-to/evaluate-generative-ai-app
Enable and configure Fireworks models in Foundry https://learn.microsoft.com/en-us/azure/foundry/how-to/fireworks/enable-fireworks-models
Import and deploy custom Fireworks models in Foundry https://learn.microsoft.com/en-us/azure/foundry/how-to/fireworks/import-custom-models
Run Foundry agent evaluations with azd CLI https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/azure-developer-cli-evaluation
Generate synthetic evaluation datasets in Foundry https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/evaluation-dataset-synthetic
Configure Agent Monitoring Dashboard for Foundry agents https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/how-to-monitor-agents-dashboard
Configure human evaluation workflows for agents https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/human-evaluation
Analyze Foundry agent runs with Trace Replay https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/trace-agent-replay
Configure tracing for Foundry AI agents with App Insights https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/trace-agent-setup
Convert Foundry agent traces into evaluation datasets https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/traces-to-dataset
Configure and run evaluations for Foundry hosted agents https://learn.microsoft.com/en-us/azure/foundry/observability/quickstarts/quickstart-evaluate-hosted-agent
Enable and inspect tracing for Foundry hosted agents https://learn.microsoft.com/en-us/azure/foundry/observability/quickstarts/quickstart-tracing-hosted-agent
Configure and use Azure OpenAI v1 API in Foundry https://learn.microsoft.com/en-us/azure/foundry/openai/api-version-lifecycle
Configure Prompt Shields for Foundry model security https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/content-filter-prompt-shields
Configure priority processing for Foundry model deployments https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/priority-processing
Automate Azure OpenAI deployments and TPM quota settings https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/automate-quota-deployments
Call chat completion models with Azure OpenAI in Foundry https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/chatgpt
Configure Azure OpenAI image generation models https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/dall-e
Configure DPO fine-tuning for Azure OpenAI https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/fine-tuning-direct-preference-optimization
Create and manage reusable skills for Responses API shell https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/skills
Configure spillover traffic management for provisioned Azure OpenAI deployments https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/spillover-traffic-management
Azure OpenAI v1 REST API parameters in Foundry https://learn.microsoft.com/en-us/azure/foundry/openai/latest
Azure OpenAI v1 REST API parameters in Foundry https://learn.microsoft.com/en-us/azure/foundry/openai/latest
Azure OpenAI v1 REST API parameters in Foundry https://learn.microsoft.com/en-us/azure/foundry/openai/latest
Azure OpenAI v1 REST API parameters in Foundry https://learn.microsoft.com/en-us/azure/foundry/openai/latest
Azure OpenAI v1 REST API parameters in Foundry https://learn.microsoft.com/en-us/azure/foundry/openai/latest
Azure OpenAI v1 REST API parameters in Foundry https://learn.microsoft.com/en-us/azure/foundry/openai/latest
Azure OpenAI v1 REST API parameters in Foundry https://learn.microsoft.com/en-us/azure/foundry/openai/latest
Azure OpenAI v1 REST API parameters in Foundry https://learn.microsoft.com/en-us/azure/foundry/openai/latest
Azure OpenAI v1 REST API parameters in Foundry https://learn.microsoft.com/en-us/azure/foundry/openai/latest
Monitor Azure OpenAI Foundry with Azure Monitor https://learn.microsoft.com/en-us/azure/foundry/openai/monitor-openai-reference
Configure Azure OpenAI Realtime API events in Foundry https://learn.microsoft.com/en-us/azure/foundry/openai/realtime-audio-reference

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 external AI gateways with Foundry Agent Service https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/ai-gateway
Enable Agent2Agent endpoints for Foundry agents https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/enable-agent-to-agent-endpoint
Connect Foundry agents to Foundry IQ knowledge bases https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/foundry-iq-connect
Enable optimizer integration for Foundry hosted agents https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/make-agent-optimizer-ready
Register external agents for Foundry observability https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/register-external-agent
Connect Foundry agents to external A2A endpoints https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/agent-to-agent
Integrate Azure AI Search with Foundry 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 Bing grounding tools with Foundry agents https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/bing-tools
Use Code Interpreter tool in Foundry agents https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/code-interpreter
Integrate Foundry agents with computer use tool https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/computer-use
Add managed MCP connector servers to Foundry https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/connectors
Connect Foundry agents to Microsoft Fabric data https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/fabric
Connect Foundry agents to Fabric IQ https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/fabric-iq
Configure file search tool for Foundry agents https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/file-search
Implement function calling with Foundry agents https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/function-calling
Use image generation tool in Foundry Agent Service https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/image-generation
Connect Foundry agents to MCP servers https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/model-context-protocol
Connect OpenAPI tools to Microsoft Foundry agents https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/openapi
Ground Foundry agents with SharePoint content https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/sharepoint
Configure Foundry toolbox with external tools https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/toolbox
Enable web search tool in Foundry Agent Service https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/web-search
Connect Foundry agents to Microsoft 365 via Work IQ https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/work-iq
Build a Foundry toolbox and connect via MCP https://learn.microsoft.com/en-us/azure/foundry/agents/quickstarts/quickstart-toolbox-agent
Call Foundry Responses API to build ephemeral agents https://learn.microsoft.com/en-us/azure/foundry/agents/quickstarts/responses-api
Create custom evaluators in Microsoft Foundry https://learn.microsoft.com/en-us/azure/foundry/concepts/evaluation-evaluators/custom-evaluators
Run fine-tuning jobs with azd extension https://learn.microsoft.com/en-us/azure/foundry/fine-tuning/fine-tune-cli
Generate text with Foundry Models via Responses API https://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/generate-responses
Deploy and invoke MAI image models in Foundry https://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/use-foundry-models-mai
Deploy and call DeepSeek-R1 in Foundry Models https://learn.microsoft.com/en-us/azure/foundry/foundry-models/tutorials/get-started-deepseek-r1
Configure and manage Microsoft Foundry connections https://learn.microsoft.com/en-us/azure/foundry/how-to/connections-add
Build LangGraph agents with Foundry Agent Service https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/langchain-agents
Host LangGraph agents on Foundry hosted agent service https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/langchain-hosted-agents
Add Foundry long-term memory to LangChain apps https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/langchain-memory
Integrate Foundry Content Safety middleware in LangChain https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/langchain-middleware
Call Foundry models using LangChain integrations https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/langchain-models
Use Foundry Toolbox tools and skills in LangChain https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/langchain-toolbox
Trace LangChain apps with Foundry and Azure Monitor https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/langchain-traces
Run AI Red Teaming Agent scans locally https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/run-scans-ai-red-teaming-agent
Select and use Microsoft Foundry SDKs and endpoints https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/sdk-overview
Deploy and call CxrReportGen Premium for chest X-ray reports https://learn.microsoft.com/en-us/azure/foundry/how-to/healthcare-ai/deploy-cxrreportgen-premium
Deploy and call MedImageInsight Premium healthcare model https://learn.microsoft.com/en-us/azure/foundry/how-to/healthcare-ai/deploy-medimageinsight-premium
Migrate Azure AI Inference SDK calls to OpenAI SDK https://learn.microsoft.com/en-us/azure/foundry/how-to/model-inference-to-openai-migration
Integrate Azure Key Vault with Microsoft Foundry https://learn.microsoft.com/en-us/azure/foundry/how-to/set-up-key-vault-connection
Use Foundry MCP Server tools and prompts https://learn.microsoft.com/en-us/azure/foundry/mcp/available-tools
Build and register custom MCP servers for Foundry agents https://learn.microsoft.com/en-us/azure/foundry/mcp/build-your-own-mcp-server
Connect VS Code to Foundry MCP Server securely https://learn.microsoft.com/en-us/azure/foundry/mcp/get-started
Log end user feedback with OpenTelemetry in Foundry https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/log-end-user-feedback
Add OpenTelemetry client-side tracing to Foundry agents https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/trace-agent-client-side
Configure OpenTelemetry tracing for AI agent frameworks https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/trace-agent-framework
Use Azure OpenAI audio completions API https://learn.microsoft.com/en-us/azure/foundry/openai/audio-completions-quickstart
Authoring preview REST APIs for Azure OpenAI Foundry https://learn.microsoft.com/en-us/azure/foundry/openai/authoring-reference-preview
Use groundedness detection with Foundry OpenAI https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/content-filter-groundedness
Configure and use Codex CLI with Azure OpenAI https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/codex
Call o3-deep-research via Azure OpenAI Responses API https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/deep-research
Fine-tune Foundry models via SDK and REST https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/fine-tuning
Fine-tune tool calling behavior in Azure OpenAI https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/fine-tuning-functions
Implement function calling with Azure OpenAI in Foundry https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/function-calling
Call Azure OpenAI vision-enabled chat models https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/gpt-with-vision
Configure JSON mode responses for Azure OpenAI https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/json-mode
Call and configure Foundry model router https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/model-router
Optimize latency with predicted outputs in Azure OpenAI https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/predicted-outputs
Implement GPT Realtime audio with Azure OpenAI https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/realtime-audio
Use GPT Realtime API over SIP https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/realtime-audio-sip
Use GPT Realtime API over WebRTC https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/realtime-audio-webrtc
Use GPT Realtime API over WebSockets https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/realtime-audio-websockets
Use Azure OpenAI Responses API with Python and REST https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/responses
Call Foundry models via Responses API and routing https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/responses-model-routing
Run shell commands with Azure OpenAI Responses API https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/shells
Use structured outputs and JSON schema with Azure OpenAI https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/structured-outputs
Enable and configure web search tool in Responses API https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/web-search
Use WebSocket mode with Azure OpenAI Responses API https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/websockets
Use Azure OpenAI Foundry REST inference APIs https://learn.microsoft.com/en-us/azure/foundry/openai/reference
Use Azure OpenAI Foundry preview REST APIs https://learn.microsoft.com/en-us/azure/foundry/openai/reference-preview
Call Azure OpenAI Foundry v1 preview REST APIs https://learn.microsoft.com/en-us/azure/foundry/openai/reference-preview-latest
Use Azure OpenAI Whisper for speech to text https://learn.microsoft.com/en-us/azure/foundry/openai/whisper-quickstart
Use Microsoft Foundry SDK to call models and agents https://learn.microsoft.com/en-us/azure/foundry/quickstarts/get-started-code

Deployment

Topic URL
Publish Foundry hosted agents to Microsoft Agent 365 https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/agent-365
Deploy real-time voice agents with hosted agents https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/build-voice-agent
Deploy containerized hosted agents with Foundry APIs https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/deploy-hosted-agent
Deploy hosted Foundry agents from source code https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/deploy-hosted-agent-code
Migrate hosted agents to the refreshed Foundry preview https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/migrate-hosted-agent-preview
Publish virtual network agents to Microsoft 365 and Teams https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/publish-copilot-virtual-network
Deploy a hosted agent sample with browser automation https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/tools/browser-automation-hosted-agent-quickstart
Deploy existing Python agent code as a hosted agent https://learn.microsoft.com/en-us/azure/foundry/agents/quickstarts/quickstart-deploy-own-code
Deploy a containerized hosted agent to Foundry https://learn.microsoft.com/en-us/azure/foundry/agents/quickstarts/quickstart-hosted-agent
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
Recover Foundry Agent Service from regional platform outages https://learn.microsoft.com/en-us/azure/foundry/how-to/agent-service-platform-disaster-recovery
Deploy open-source models on Foundry managed compute https://learn.microsoft.com/en-us/azure/foundry/how-to/deploy-models-managed
Run cloud evaluations with Foundry SDK https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/cloud-evaluation
Run AI Red Teaming Agent scans in the cloud https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/run-ai-red-teaming-cloud
Run Foundry evaluations in Azure DevOps https://learn.microsoft.com/en-us/azure/foundry/how-to/evaluation-azure-devops
Run Foundry evaluations in GitHub Actions https://learn.microsoft.com/en-us/azure/foundry/how-to/evaluation-github-action
Deploy fine-tuned Azure OpenAI models in Foundry https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/fine-tuning-deploy
Files1
1 files · 18.2 KB

Select a file to preview

Overall Score

82/100

Grade

B

Good

Safety

92

Quality

82

Clarity

85

Completeness

75

Summary

This is a reference documentation skill that provides expert guidance on Microsoft Foundry development across nine domains (troubleshooting, best practices, decision making, architecture, limits, security, configuration, integrations, and deployment). It functions as a curated index with links to Microsoft Learn documentation and instructions for an agent to fetch remote documentation using MCP tools or HTTP requests. The skill does not perform any writes, code generation, or destructive operations—it is a read-only knowledge reference system.

Detected Capabilities

documentation index and referenceremote documentation fetching via HTTP/MCPmarkdown content retrievaltool installation guidance

Trigger Keywords

Phrases that MCP clients use to match this skill to user intent.

foundry agentsazure ai foundryfoundry architecturefoundry securityfoundry troubleshootingfoundry migrationfoundry deploymentfoundry integrationfoundry configuration

Referenced Domains

External domains referenced in skill content, detected by static analysis.

github.comlearn.microsoft.com

Use Cases

  • Troubleshooting Foundry agent failures and deployment issues
  • Designing Foundry agent architectures with VNet isolation and high availability
  • Planning migrations from Foundry Classic or GitHub Models to current Foundry
  • Implementing security controls, RBAC, and guardrails for Foundry agents
  • Integrating Foundry agents with tools, data sources, and observability platforms
  • Configuring Foundry models, agents, and evaluation systems
  • Selecting models and deployment regions based on cost and performance
  • Building LangGraph and LangChain agents with Foundry Agent Service
  • Deploying agents to Microsoft Teams, M365, and voice endpoints

Quality Notes

  • Well-structured category index with 8 comprehensive sections and line-number guidance for easy navigation
  • Extensive link coverage (100+ learn.microsoft.com URLs) across all major Foundry domains
  • Clear scoping instructions for agents: distinguishes from microsoft-foundry-classic and microsoft-foundry-local variants
  • Compatibility section explicitly states network access requirement and tool dependencies
  • Metadata timestamp allows agents to detect stale content and prompt updates
  • Helpful fallback guidance for when mcp_microsoftdocs tool is unavailable
  • Skill provides decision-making guidance alongside how-to content, addressing both 'what' and 'when' questions
  • Potential minor issue: several duplicate URL entries in Configuration section (appears to be a generation artifact)
  • No security credentials, API keys, or private configuration exposed
  • Does not require or assume any project-specific context
Model: claude-haiku-4-5-20251001Analyzed: Jun 26, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Use MicrosoftDocs/microsoft-foundry in your dev environment

Start a Developer trial

Command Palette

Search for a command to run...